# STORY STUDIO 章节仓库

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

## 从零开始

从 [教程总入口](docs/README.md) 开始，按顺序完成：

1. [基础编排：新建、素材、分支、广告、工程副本](docs/tutorials/01-basics.md)
2. [进阶功能：动作、奖励、解锁提示、同章与跨章回忆录](docs/tutorials/02-actions-and-memories.md)
3. [交付上线：双章节导出、封面、配置合并与手工部署](docs/tutorials/03-publishing.md)
4. [Skill 安装、调用与逐步教学示例](docs/skills-guide.md)

文档按 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 提交与远程推送是两个独立操作；本地提交不代表已上传远程。

版本控制、导出与发布的具体区别见 [交付教程](docs/tutorials/03-publishing.md)。