docs: 新增 kb/README.md

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-02-24 16:59:48 +08:00
co-authored by Cursor
parent 8545957df9
commit a2cd5e801f
+37
View File
@@ -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` 或注明「未归档」,待后续归档后更新链接。