44 lines
2.2 KiB
Markdown
44 lines
2.2 KiB
Markdown
# 知识库 (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。
|
||
|
||
---
|
||
|
||
## Beat 集中索引
|
||
|
||
- **[[Beats总览]]**：Backlog（待写稿）集中列表 + 已有 Beat 全表，由 Dataview 从 `kb/beats` 聚合。写稿前从 Backlog 选；写稿后改 `status` 即从 Backlog 区自动移出。
|
||
|
||
---
|
||
|
||
## Bible 来源索引
|
||
|
||
- **正常流程**：经 inbox 流程处理并被 bible 引用的来源，会先归档到 `inbox/archived/`；来源索引中的链接应使用**已归档路径** `[[inbox/archived/文件名]]`，便于跳转原文且与流程一致。
|
||
- 未走归档流程的少数来源（如人工直接创建的 bible）可暂时用 `inbox/xxx` 或注明「未归档」，待后续归档后更新链接。
|