# 仓库协作规范

## 事实源顺序

发生冲突时按以下顺序处理，并在 Story Bible 记录决定：

1. `story-bible.md` 的已定决策与决策日志；
2. 对应角色卡、世界设定、故事大纲；
3. 小说正文中已发布的事实；
4. 动画改编与视觉圣经；
5. 分镜、提示词及生产素材。

下游可以为媒介效果改编表达，但不能静默推翻上游因果和人物动机。

## 分支与提交

- `main`：可继续创作和生产的稳定状态。
- 分支：`story/主题`、`character/角色`、`world/设定`、`anime/集或场次`、`asset/资产`、`fix/问题`。
- 提交：`类型(范围): 摘要`。
- 常用类型：`story`、`character`、`world`、`anime`、`asset`、`docs`、`fix`、`chore`。
- 一个提交只解决一个可说明的问题；不要把设定修改、批量资产和缓存混成一次提交。

## 文件命名

- 文档目录允许中文，生产资产使用稳定的 ASCII ID。
- 集／场／镜统一为 `S01E01_SC12_SH001_v001`；剧本文本场号 `01-12` 映射到 `S01E01_SC12`。
- 角色：`CHR-时代-角色-年龄或状态-版本-视图`。
- 场景沿用已建 `ENV-S1-01` 等登记ID，文件另加时间天气与版本；不再建立平行LOC编号。
- 道具沿用已建 `PROP-S1-01` 等登记ID，文件另加状态与版本；不再建立平行PRP编号。
- 状态后缀：`WIP`、`REVIEW`、`APPROVED`、`LOCKED`、`ARCHIVED`。

## 版本与归档

- 小改动依赖 Git，不复制 `最终版2_真的最终版`。
- 只有必须并行比较的重大稿次才在文件名中保留版本号。
- 被替代但具有生产追溯价值的材料移入同阶段的 `99_归档`。
- 正式发布使用语义化版本：`v主版本.次版本.修订号`。

## 提交前检查

- Markdown 链接可用，文件编码为 UTF-8。
- 没有 `.env`、密钥、缓存、代理和自动保存文件。
- 当前远程未启用 Git LFS；提交前检查二进制体积，超大工程与中间素材放入外部存储并在仓库记录清单。
- 新设定已同步到事实源，改动既定决策已写入 Story Bible。
- 动画资产可追溯到集、场、镜和资产版本。