diff --git a/kb/README.md b/kb/README.md new file mode 100644 index 0000000..05983a0 --- /dev/null +++ b/kb/README.md @@ -0,0 +1,37 @@ +# 知识库 (kb) 约定 + +本目录为叙事/世界观知识库的单一信息源(SSOT)。与 Agent 身份、核心原则、信息边界见项目根 **`AGENTS.md`**;本文档仅约定**命名、废弃与来源索引**。 + +--- + +## Bible 命名约定 + +- **条目与文件名均使用中文**:与条目标题/主名一致,如 `佩佩.md`、`火山.md`、`主脑.md`、`原型.md`;不含空格,多词可用短横线,如 `世界观-年表.md`。 +- 若协作环境或工具对中文路径支持不佳,可保留拼音/英文文件名,在 frontmatter 的 `id` 与正文标题中写中文主名。 +- frontmatter 中的 **`aliases`** 字段包含所有已知名称/变体(中文、英文、拼音),供检索用。 + +--- + +## Beats 命名约定 + +- **格式**:`{场景或角色}-{事件/情境核心词}` 或 `{类别}-{核心内容}`。 +- **不含编排信息**:Day、D01、order 等只放在 frontmatter,不放文件名。 +- **以内容为核心**:场景+事件(如 诊室门口-年审公布)、角色+情境(如 佩佩-维修1)、梦境(如 梦-海边)。 +- 类型(beat_type)放 frontmatter,命名无需重复。 + +--- + +## Beat 废弃处理 + +当某个 beat 需废弃时: + +1. **只改 beat 文件**:`status: deprecated`,changelog 记录废弃原因。 +2. **bible 叙事时间线**:不强制更新;链接保留,点入 beat 可见已废弃。若需在表格中标注,可将对应行状态改为 `❌ 已废弃`。 +3. **dataview**:查询时加 `WHERE status != "deprecated"` 即可排除废弃 beat。 + +--- + +## Bible 来源索引 + +- **正常流程**:经 inbox 流程处理并被 bible 引用的来源,会先归档到 `inbox/archived/`;来源索引中的链接应使用**已归档路径** `[[inbox/archived/文件名]]`,便于跳转原文且与流程一致。 +- 未走归档流程的少数来源(如人工直接创建的 bible)可暂时用 `inbox/xxx` 或注明「未归档」,待后续归档后更新链接。