# Capture 项目现状 · 一页纸（供 Agent 协作）

**更新**：2025-02-24

---

## 项目是什么

- **叙事/世界观知识库**：为某叙事项目（含角色、设定、节拍/剧情单元）维护单一信息源（SSOT），支持 Obsidian 浏览与 Dataview 查询。
- **Agent 角色**：知识库维护智能体——负责**信息汇总、格式整理、关系推断、冲突检测、变更记录**；**不负责**创意决策、判断设定对错、解决冲突。
- **规则文件**：`AGENTS.md`（必读，含目录结构、Templater、命名、Inbox 处理、一致性检查）。

---

## 目录结构（简要）

| 路径 | 用途 |
|------|------|
| `kb/bible/角色/` | 角色条目，中文文件名，如 `佩佩.md`、`火山.md` |
| `kb/bible/设定/` | 世界观/设定条目，如 `主脑.md`、`原型.md`、`梦.md` |
| `kb/beats/` | 节拍（最小叙事单元），命名：`场景-事件` 或 `角色-情境` |
| `kb/decisions/` | 决策记录 |
| `kb/template/` | Obsidian Templater 模板（与 `template/` 同步） |
| `template/` | 模板源文件，**AI 新建文件时读这里**，占位符 `{{name}}`、`{{title}}`、`{{term_name}}` |
| `inbox/` | 输入：eureka、会议记录、点子；处理后可归档到 `inbox/archived/` |

---

## 核心约定（其他 Agent 须知）

1. **单一信息源**：每个角色/设定/节拍在 `kb/` 下仅有一个权威文件。
2. **遇冲突不卡住**：在 bible 的「冲突」小节记录两版+来源，不自行解决。
3. **变更必留档**：改 kb 文件必须写 changelog（日期、说明、原因、来源）。
4. **Bible 命名**：中文主名，如 `佩佩.md`、`世界观-年表.md`；`aliases` 放所有名称变体。
5. **Beat 命名**：内容向，如 `诊室门口-年审公布`、`梦-海边`；不含 Day/order 等编排信息。
6. **模板同步**：改 `template/*.md` 后需同步到 `kb/template/`。

---

## 当前数据规模（约）

- **角色 bible**：约 16 个（佩佩、火山、英理、石头、奇琳、姐姐、戈塔什、主脑相关等）。
- **设定 bible**：约 24 个（主脑、原型、梦、回收、幸福市、伊甸计划、年表等）。
- **Beats**：约 32 个（维修线、梦线、诊室/地铁/酒吧等场景）。
- **模板**：`tpl-character`、`tpl-worldbuilding`、`tpl-beat`、`tpl-day`、`tpl-eureka`、`tpl-outline`、`tpl-decision`。
- **辅助**：`kb/inbox-info-map.md` 为 inbox 文档与实体的交叉索引。

---

## Inbox / Git 状态（简要）

- **已修改**：`AGENTS.md`，部分 inbox 文件（如 2月脑暴、姐姐和梦境等），以及 `template/` 下多个 tpl-*.md。
- **未跟踪**：`TEMPLATER.md`，若干新 inbox（如 回收-陈子钦、宇航员、落地全剧情、签约全剧情等），以及 `kb/` 目录。
- 处理 inbox 时按 `AGENTS.md`「处理 Inbox / Eureka」流程：读全文 → 更新/新建 bible → 冲突记入「冲突」→ Beat 与叙事时间线双向同步 → 输出处理摘要。

---

## 与其他 Agent 协作要点

- **做创意/剧情决策**：请交给人类或负责创意的 agent；本库只记录与整理。
- **新建 bible/beat**：从 `template/tpl-*.md` 复制，替换 `{{xxx}}` 为实际值，写入 `kb/bible/角色|设定/` 或 `kb/beats/`；不要写 Templater 标签。
- **一致性检查**：按 `AGENTS.md`「一致性检查」执行双向对账、reveals 反补、弧线与设定校验，并汇报 `[#TBD]` / `[#Retcon]` / `[#LogicHole]`。
- **叙事时间线状态**：✅ 已落地 | 🔹 无Beat | 🆕 仅Beat | ⚠️ 有出入 | 🚧 草稿；废弃 beat 只改 `status: deprecated` 并写 changelog。

---

*详细规则与流程见 `AGENTS.md`；Templater 用法见 `TEMPLATER.md`。*