# Capture 项目现状 · 一页纸

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

---

## 项目是什么

- **叙事/世界观知识库**：为某叙事项目（含角色、设定、节拍/剧情单元）维护单一信息源（SSOT），支持 Obsidian 浏览与 Dataview 查询。
- **Agent 角色**：知识库维护智能体——负责**信息汇总、格式整理、关系推断、冲突检测、变更记录**；**不负责**创意决策、判断设定对错、解决冲突。
- **规则文件**：`AGENTS.md`（必读，身份、原则、目录、信息边界、流程入口）。约定与流程细节：`kb/README.md`（命名/废弃/来源索引）、`template/README.md`（Templater、占位符、可读性）；Inbox 处理与一致性检查见 `.cursor/skills/` 对应 SKILL。

---

## 目录结构（简要）

| 路径              | 用途                                                                                          |
| --------------- | ------------------------------------------------------------------------------------------- |
| `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/`。飞书文档→inbox→分析流程见 `.cursor/FLOW-FEISHU-INBOX.md` |

---

## 核心约定（其他 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 文档与实体的交叉索引。

---


*详细规则与流程见 `AGENTS.md`；kb 约定见 `kb/README.md`；模板与 Templater 见 `template/README.md`。*
