第一篇：从空工程制作分支剧情#

教程总入口 · 下一篇：动作、奖励与回忆录

本篇完成后路线如下：

01 / 开场
  ├─ 选择 / 探索庭院 → 02 / 探索庭院 ─┐
  └─ 选择 / 正面交锋 → 02B / 正面交锋 ┴→ 03 / 回归主线

“选择”是交互节点，播放镜头的是视频节点；不能只给开场接两个视频就认为已经做出两个可点选项。

B01 新建一个空章节#

1. 页头点击“章节库”，再点击“新建章节”；也可点击左侧“＋ 新建”。
2. 章节名称填 第一章 · 从零练习，目录名称填 tutorial-001。若已存在，换成未使用的名称并记入学习记录。
3. 点击“创建章节，导入素材 →”。
4. 确认素材库为空，左侧显示本次新目录。

新建不会自动带入第一集素材。先在章节库选择保存位置：本机目录模式写授权仓库的 chapters/tutorial-001/；浏览器模式存入此站点 IndexedDB，须导出工程包才得到可提交 Git 的目录。服务器不保存剧情。

验收：章节库能看到新章，素材数量为 0。建议回复：空工程已新建。

B02 导入第一集素材#

准备以下 4 个视频和 1 张图片。当前仓库的 chapters/chapter-001/assets/ 中已有这些素材；可以从这里选择原文件导入到新章，或使用自己的素材来源。

1. 中列切换“素材库”，点击“导入素材”，选择这些原文件。也可以点击“导入素材文件夹”导入一个纯素材目录。
2. 等待素材卡片出现，分别打开视频或图片确认内容能预览。
3. 新工程导入原素材时，无需手动选择 .meta；编辑器会为本章生成稳定素材身份。

同一章多个节点可引用同一素材，通常无需反复导入；不同章则各自导入、独立存储。素材库导入与左侧“导入工程”用途不同。

验收：本章有 4 个视频和 1 张图片，视频可播放。建议回复：素材已导入。

B03 添加开场#

1. 找到开场视频素材，点击卡片“＋ 添加节点”。
2. 右侧“节点名称”改为 01 / 开场。
3. 确认“视频素材”绑定正确；若右侧显示“设为剧情入口”，点击它。第一个视频通常自动成为入口。
4. 在舞台点击播放按钮，检查开场画面。

布局编辑中的播放仅预览这个片段；“▶ 试走剧情”才执行路由、条件、广告等逻辑。

验收：左侧开场标有“入口”，舞台能播放。建议回复：已添加开场。

B04 先接通一段连续播放#

1. 在素材库把庭院视频添加为节点，命名 02 / 探索庭院。
2. 左侧选择 01 / 开场，在右侧“分支与后继”点击“＋ 连接到节点”，选择庭院视频节点。
3. 开场勾选“自动衔接后续片段”，关闭“循环播放”，不要勾“设为剧情结局”。
4. 选中开场，点击“▶ 试走剧情”。可用“跳至结束 →”快速验证是否切入庭院。

“试走剧情”从当前宿主片段开始；要测试全章，可以选择入口后试走，或在试走状态点击“从剧情入口重播”的 ↺ 按钮。

验收：开场结束后自动进入庭院。建议回复：已连通并播放。

B05 把自动衔接改为点击选项#

1. 切回“布局编辑”，选开场。
2. 在“分支与后继”移除开场直接连接庭院的那条连接（点击连接旁的 ×，不是删除庭院节点）。
3. 点击“＋ 添加交互”。确认新交互挂在开场下，改节点名称为 选择 / 探索庭院，选项文字为 探索庭院。
4. “出现时间”设 0，“消失时间”设 0，暂时关闭“从视频开始显示”。这会在片尾显示选项。
5. 选中新交互，在它的“分支与后继”连接到 02 / 探索庭院。
6. 从开场试走，到片尾点击选项。

验收：开场不会自行跳入庭院，点“探索庭院”才进入。建议回复：选项可以点击进入庭院。

B06 添加第二条分支#

1. 把交锋视频添加为节点，命名 02B / 正面交锋。
2. 重新选中开场，再“添加交互”，命名 选择 / 正面交锋，选项文字为 正面交锋。
3. 与第一选项一样，出现/消失均为 0，关闭“从视频开始显示”。
4. 此交互连接到 02B / 正面交锋。
5. 两次从入口试走，分别选庭院与交锋。

验收：两选项都属于开场，各进入正确镜头。建议回复：两条分支都正常。

B07 两条分支回归主线#

1. 把汇合视频添加为节点，命名 03 / 回归主线。
2. 选庭院视频，将后继连接到汇合；选交锋视频，也连接到同一个汇合节点。
3. 两个分支视频都启用自动衔接、关闭循环、取消结局标记。
4. 目前汇合是最后一段，可以勾“设为剧情结局”。
5. 分别走完两条路线。

不要复制两个汇合节点来模拟同一段主线；两条连接指向同一个节点即可。

验收：两条分支都进入 03 / 回归主线。建议回复：两条分支都能回归主线。

B08 改成图片按钮并调整位置#

1. 选中“选择 / 探索庭院”，勾“使用图片交互”，交互图片选 圆点.png，保留“允许点击”。
2. 对“选择 / 正面交锋”做相同设置。
3. 为防重叠，给庭院按钮设中心 X=0.3、Y=0.75，交锋按钮设 X=0.7、Y=0.75。宽高可先用 0.2、0.1。
4. 舞台中可拖动图片位置、用右下角调整大小；文本标签帮助区分两个占位按钮。
5. 试走确认两者都能点击且进入正确分支。

坐标与尺寸是相对画面的 0–1 比例。正式按钮应使用不同图片，普通文字选项由客户端统一排版，不能以图片布局方式拖动。

验收：图片按钮位置分开、命中正确。建议回复：图片按钮正常。

B09 设置交互出现时间#

1. 两个交互均关闭“从视频开始显示”，出现时间设为 0.4 秒，消失时间保留 0。
2. 选开场试走，从头观察前 0.4 秒前后；不要直接跳片尾来验证出现时机。
3. 再完整看一遍片尾，确认仍可选。

验收：按钮从 0.4 秒出现。建议回复：出现时间正常。

B10 测试一个广告点#

1. 选“选择 / 正面交锋”，在“广告点”勾“观看激励广告后继续”。
2. 从开场试走，点此按钮，出现广告模拟面板。
3. 先“模拟取消”，确认未进入交锋；使用重试，再“模拟失败”，确认仍未通过。
4. 再试一次“模拟观看完成”，确认进入交锋并最终汇合。

此处验证广告控制流，真实广告是否加载和发奖须在目标客户端测试。

验收：只有模拟完成才继续。建议回复：广告测试正常。

B11 检查并导出两个不同用途的包#

1. 点击“检查剧情”，处理报错。当前若仅提示没设置封面，可先记录，第三篇正式发布前补齐。
2. 点击“保存工程”，等待“已保存”或“所有修改已保存”。
3. 点击“导出剧情”，选“章节工程目录包”，点“生成导出包”并点击生成的下载链接。
4. 再选“客户端剧情包”，保留“客户端包包含引用的媒体”，生成并下载。
5. 为两个下载文件分别起能区分用途的名字，例如 第一章-工程.zip 与 第一章-客户端剧情.zip。

下载目的地取决于浏览器，服务器不保留导出包。支持的浏览器也可“直接保存 ZIP”到本机。页面的“下载修改快照 JSON”是故障恢复辅助，不是含素材的完整工程备份。

验收：有工程目录包和客户端包各一份。建议回复：两个包都已导出。

B12 导入工程副本#

1. 解压 第一章-工程.zip，找到内部直接含 story.project.json 的章节目录。
2. 点击左侧“导入工程”→“选择工程目录”，选择这一级目录，不要选外层 ZIP 所在目录或整个仓库。
3. 目标目录填 tutorial-001-copy，勾“导入为独立副本（新工程 ID 与章节 ID）”。
4. 点击“导入工程”，等待完成。
5. 检查节点和素材完整，试走两条分支。章节库仍保留原章。

导入副本会生成新的工程和章节 ID；素材保存在新章自己的目录中。即使素材 GUID 文本与原章相同，也在各自工程作用域内解析。业务变量名不会因复制自动改名。

验收：副本可独立编辑，原章未被覆盖。建议回复：工程副本导入正常。

继续 第二篇，在这个副本上练习高级功能。