STORY STUDIO 章节仓库#

一个目录对应一个章节工程，所有章节在本仓库统一管理。编辑器源码和发行包位于独立的 story-editor 目录；本仓库保存章节、教程与配套 skills。

从零开始#

从教程总入口开始，按顺序完成：

文档按 STORY STUDIO 0.3.4 的实际界面、源码和现有练习工程整理，适用于目录工程协议 v2。以后界面变化时，应同步更新文档和 skills。

仓库结构#

text

story-chapters/
  story.repository.json      仓库标识
  chapters/                  各章节目录，包含素材及旁置 .meta
  docs/                      人工操作教程与 skill 使用教程
  .agents/skills/             可随 Git 分发的技能源文件
  .studio/                   本地历史、导出与缓存，已忽略

已有 chapter-001、chapter-001-restore-test、memory-album 是此前练习留下的工程。重学时新建不同目录，不需要清空它们。

协作约定#

0.4 编辑器是纯静态网站。章节库 → 打开 / 新建本机仓库 → 选择本仓库根目录；或使用浏览器章节库逐章导入。后者导出工程包后再解压入 Git checkout。可选本地启动器和 CLI 才需要 Python。
素材通过编辑器导入，使用 asset://GUID 引用。同章复用素材；跨章素材独立。
文件移动、替换优先使用素材管理。手工移动时素材和 .meta 必须一起移动。
新克隆的仓库运行 git lfs install 和 git lfs pull，避免把 LFS 指针文本误当视频。
提交章节时包含该章节的配置、editor/、素材与 .meta。编辑器生成 JSON 的排序和节点 ID 不要随意重写。
Git 切换分支或合并之前保存并停止编辑，之后重新加载工程。HTTP 409 表示工程有外部更新，应先保留未保存快照再处理冲突。
不提交访问口令、个人预览存档、缓存和临时导出。首次 Git 提交与远程推送是两个独立操作；本地提交不代表已上传远程。

版本控制、导出与发布的具体区别见交付教程。