1.9 KiB
1.9 KiB
知识库 (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 需废弃时:
- 只改 beat 文件:
status: deprecated,changelog 记录废弃原因。 - bible 叙事时间线:不强制更新;链接保留,点入 beat 可见已废弃。若需在表格中标注,可将对应行状态改为
❌ 已废弃。 - dataview:查询时加
WHERE status != "deprecated"即可排除废弃 beat。
Bible 来源索引
- 正常流程:经 inbox 流程处理并被 bible 引用的来源,会先归档到
inbox/archived/;来源索引中的链接应使用已归档路径[[inbox/archived/文件名]],便于跳转原文且与流程一致。 - 未走归档流程的少数来源(如人工直接创建的 bible)可暂时用
inbox/xxx或注明「未归档」,待后续归档后更新链接。