---
name: story-studio-release
description: 为 STORY STUDIO 章节准备客户端剧情交付包，检查跨章依赖、封面与资源路径，合并章节和变量配置，并排查部署后的 404、回放或解锁问题；适用于该项目的剧情内容发布，不用于部署编辑器服务或一般网站。
---

# STORY STUDIO 剧情交付

适用基线为编辑器 0.3.4、目录协议 v2及当前还原客户端。读取 [references/delivery-contract.md](references/delivery-contract.md) 后，按本次导出/排障范围工作。完整人工流程在章节仓库 `docs/tutorials/03-publishing.md`。

## 识别输入与目标

- 区分章节工程目录包、客户端剧情包和编辑器发行包。发布游戏章节需要 runtime 包；修改剧情应回到目录工程，不能靠改 runtime ZIP 代替维护源工程。
- 识别实际 workspace、工程 ID、章节 ID、编辑器版本、发布目标和现有配置来源。给定文件先检查 manifest 和路径，不假定包名等于内部章节 ID。
- 教学请求每次给当前发布步骤、验证方式与下一步触发条件；代办请求则完成已授权的准备和检查，不强制拆成问答。

## 准备可审阅的交付结果

1. 校验所选工程和跨章目标。回忆录指向主线时，从回忆录导出才能自然收集两章；检查 manifest.chapterIds，不把“多章仓库”等同于“导出所有章”。
2. 需要首发媒体时保留 includeMedia。检查两章封面已绑定、每个配置引用有对应文件、路径大小写和扩展名一致；若使用旧编辑器错误路径，优先更新源/导出逻辑再生成。
3. 获取用户指定环境的现有完整 ChapterList 与 Variables，在本地备份和合并。只更新本次明确发布的 chapterId，保留无关章节和全局字段。变量按 name 合并，定义冲突需查清，不能任意覆盖。
4. 列出新增/修改章节、变量、资源、未解问题、上传相对路径与回滚依据。若现有全量配置尚不可取得，先完成包检查和变更清单，明确缺口；不要生成伪称保留全部线上章节的文件。
5. 按已有授权继续手工交付指导或部署。准备交付不自动授权上传服务器、推送 Git 或更改 Nginx；若用户明确授权且工具具备能力，则在完成本地可审阅结果后执行相应范围，不重复索要已有授权。

## 排障原则

先用完整失败 URL、状态码、响应类型与包内文件路径建立对应关系。封面重点检查小写 `stories`；视频检查 `EditoData`、引用媒体是否包含和目录是否重复嵌套。HTTP 200 也可能是 HTML fallback，不能只看状态码。

先查证再定位修复位置：源工程、导出逻辑、配置合并、上传目录、缓存或客户端。若已知环境只能由用户上传，就提供确切待替换文件和验证方法，不声称线上已修复。无需为路径错误额外改变服务器安全设置。

## 验收与报告

- 静态检查：有效入口、跨章目标、变量定义、媒体引用、双章封面、合并后仍保留原章节。
- 编辑器预览：分支、动作成功/失败/重试、奖励与回忆流程；依据本次变化选择必要项。
- 真实客户端：章节可见、封面媒体可加载、真实广告和存档行为、跨章回放返回。编辑器模拟不能代替真实广告测试。
- 说明实际生成路径、包内章节范围、配置差异、已测/未测，以及尚需人工上传的文件；本地 Git 提交、远程推送、服务器发布分开报告。