STORY STUDIO 内容制作与教学#
适用基线：编辑器 0.3.4、目录协议 v2。以当前安装版和实际工程为准。
先确定任务模式与工程#
- 用户说“教我”“下一步”“已添加动作训练”等时，按教学模式处理：确认当前工程、当前步骤与验收状态，只给下一项可操作任务及完成标志，等用户反馈后再推进。不要把反馈误认为重新创建整套工程的请求。
- 用户要求“帮我创建/修改/修复”时，执行已授权内容编辑并验证；不额外套教学停顿。用户指定的媒体、命名与既有授权优先于教程示例。
- 通过
story.repository.json、chapters/和浏览器当前保存模式确认 workspace。区分目录名、projectId、chapterId；不要假定它们相同。 - 定位安装版或源码中的
studio.py、src/web/workflows.js、behaviors.js。不要依赖原作者盘符；0.4 服务器不保存工程；目录模式指向访问者本机，浏览器模式需导出工程包才可由本地 CLI 读取。 - 先看当前章节与保存状态。重载之前处理未保存修改。已有教程工程不是可任意清空的临时目录；从零教学应新建未占用目录。
按任务读取材料#
- 逐步教学：仓库中的
docs/tutorials/01-basics.md、02-actions-and-memories.md是完整人工教程。先读当前篇及当前步骤；references/lesson-map.md 用于按用户回复定位步骤，以及教程未随 skill 安装时的简明续课。 - 编辑和诊断：读 references/project-contract.md，掌握目录、引用、API/CLI 与验收语义。
- 导出交付：读取仓库
docs/tutorials/03-publishing.md。若任务主要是发布准备，可使用已安装的story-studio-release；该 skill 不是本 skill 的必需依赖。
若另行安装本 skill，仓库文档不在 skill 文件夹里是正常情况。向工作区定位实际章节仓库，不从失效相对链接假定文档已不存在。找不到完整教程时依托随 skill 附带参考说明，并只询问无法推断的工程位置或学习进度。
内容编辑原则#
- 优先使用用户选定的编辑器 UI；自动内容编辑也可用发行包自带 CLI/API。CLI 没有动作向导子命令，不要编造命令；必要时读取安装版
behaviors.js的实际生成规则。 - 素材经导入进入本章，节点使用
asset://GUID；复用素材不等于复用节点。同章可共享媒体，跨章媒体独立，回放跳转引用目标章而非复制整章。 - API/CLI 保存使用新读取的完整模型和 revision，保留未知字段。出现 409 时保留草稿并重新读取、比较；不要强写或循环重试旧快照。
- 功能向导生成普通节点及编辑元数据。动作向导管理自动后继；奖励和回忆向导管理变量规则。重新应用前看已有手工调整，避免覆盖用户意图。
- 教学检查当前按钮标签，使用“选哪个节点 → 点哪里 → 填什么 → 怎样算通过”的表达。每次交代当前目标，不倾倒后续全套步骤。
必须保留的运行语义#
- “试走剧情”从当前宿主视频开始；入口重播才是全章测试。普通播放不执行完整路由。
- 出现时间 0 且 showEarly=false 表示片尾出现；消失时间 0 表示无定时隐藏。
- 动作窗口结束后按钮不可点，视频结束后才走未操作失败；每次进入训练重置判定。即时失败需求要调整镜头切分。
- 广告奖励成功后才设置解锁变量、加积分；取消/失败不发奖，已领取不再发。广告解锁的回忆要关闭“进入当前片段时直接解锁”。
- 奖励、回忆登记和卡片使用同名变量是有意共享协议。复制工程不会自动改业务变量名；需要隔离时同步改完所有引用。
- 未解锁/已解锁卡片在布局编辑中可能同时显示，互斥行为要在试走检查。回忆返回应从卡片进入后验证，直接打开回忆没有返回来源；多段回放遵循上一视频链。
- 预览状态在当前站点的浏览器存储，不是工程配置，也不是线上游戏存档。清空试走会影响该站点其他章节的试走状态，按任务需要进行。
完成标准#
编辑任务检查保存结果、素材引用和当前改动涉及的路线：分支汇合、动作成功/失败/重试、奖励取消/失败/完成/重复、回忆锁定/解锁/返回。按任务范围选择，不为单个节点改名跑全套流程。
教学任务给出当前步骤结果及下一步入口，记住实际工程与最后通过的步骤；若用户要求落盘，可用仓库 docs/learning-record.md 模板。没有实际执行的预览或客户端测试明确标为未测。