Files
Capture/kb/README.md
T
2026-02-24 16:59:48 +08:00

1.9 KiB
Raw Blame History

知识库 (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: deprecatedchangelog 记录废弃原因。
  2. bible 叙事时间线:不强制更新;链接保留,点入 beat 可见已废弃。若需在表格中标注,可将对应行状态改为 ❌ 已废弃
  3. dataview:查询时加 WHERE status != "deprecated" 即可排除废弃 beat。

Bible 来源索引

  • 正常流程:经 inbox 流程处理并被 bible 引用的来源,会先归档到 inbox/archived/;来源索引中的链接应使用已归档路径 [[inbox/archived/文件名]],便于跳转原文且与流程一致。
  • 未走归档流程的少数来源(如人工直接创建的 bible)可暂时用 inbox/xxx 或注明「未归档」,待后续归档后更新链接。