# 知识库规则

## 目标

这个仓库是一个持续维护的知识库，而不是松散笔记文件夹。目标是随着时间积累结构化知识。

## Source Of Truth

- `raw/` 保存原始来源材料，默认不应被修改。
- `wiki/` 保存从来源中提炼并持续维护的知识。
- `wiki/` 中的重要结论应能追溯到来源页。
- 如果某条结论暂时无法被清楚追溯，就要显式标注，而不是把它写成既定事实。
- 这个知识库默认由 git 管理，用于提供版本历史、review 和回滚能力。

## 页面类型

- `wiki/sources/`：每个来源一页
- `wiki/entities/`：人、组织、产品、概念、地点、方法等长期页面
- `wiki/overview/`：主题地图、综述、当前理解和开放问题
- `wiki/analyses/`：值得保留的高价值答案、比较和综合分析

### 来源页

每个来源页通常应包含：

- `Summary`
- `Source-Backed Notes`
- `Inferences`
- `Conflicts Or Corrections`
- `Affected Pages`

### 实体页

每个实体页通常应包含：

- `What This Page Is For`
- `Stable Facts`
- `Inferences`
- `Open Questions`
- `Sources`

### 综述页

每个综述页通常应包含：

- `Current Understanding`
- `Source-Backed Themes`
- `Tensions Or Open Questions`
- `Related Pages`
- `Sources`

### 分析页

每个分析页通常应包含：

- `Question`
- `Conclusion`
- `Source-Backed Basis`
- `Inferences`
- `Follow-Up`

## Ingest 工作流

当收到一个新来源时：

1. 从 `raw/` 读取来源
2. 在 `wiki/sources/` 中创建或更新页面
3. 识别受影响的 entity 和 overview 页面
4. 更新这些页面
5. 更新 `index.md`，把相关页面以“页面链接 + 一句话说明”的形式列入目录
   推荐格式：`- [wiki/...](wiki/...): one-line summary`
6. 在 `log.md` 中追加记录

来源页既要说明来源说了什么，也要说明它会改变 wiki 的哪些部分。

## Query 工作流

当回答一个问题时：

1. 先读 `index.md`
2. 阅读相关 wiki 页面
3. 只在必要时使用 raw sources
4. 如果答案具备长期价值，就写入 `wiki/analyses/` 或相应 overview 页面

如果 wiki 已经拥有所需结构，不要把每次 query 都当成一次新的全量 retrieval。
回答应尽量显式引用所使用的 wiki 页面；如果回看了 raw sources，也要说明。

## Lint 工作流

检查以下问题：

- orphan pages
- 缺失交叉链接
- 过时结论
- 矛盾
- 没有独立页面的重要概念
- 缺失的索引条目
- 应被合并的重复页面
- 已经过宽、影响可读性的 overview 页面
- 值得通过 web search 或补充来源进一步填补的数据空白

## 编辑规则

- 优先更新现有页面，而不是制造重复页面
- 保持页面聚焦且易于链接
- 显式标注矛盾
- 将来源支持的事实与推断分开
- 不要静默删除仍有意义的旧结论
- 优先写成小而可组合的页面，而不是巨大的杂糅文档
- 如果新来源改变了既有理解，应修订旧页面，而不是把更新孤立留在新来源页里
- 不要为了方便 ingest 而重写 `raw/`

## 命名约定

- 使用 kebab-case 文件名
- 使用 ISO 日期：`YYYY-MM-DD`
- `log.md` 条目应以 `## [YYYY-MM-DD] <operation> | <topic>` 开头
- 来源页和分析页优先使用 `YYYY-MM-DD-short-source-name.md`
- 实体页和综述页优先使用稳定、不带日期的名称
- 重要页面应出现在 `index.md` 中，并附一句话说明
- `index.md` 中的长期页面条目优先使用 `- [wiki/...](wiki/...): one-line summary`

## 何时创建新页面

下列情况下应创建新页面：

- 某个实体被多个来源反复引用
- 某个分析具有长期复用价值
- 某个 overview 页面已经过宽或过长
- 某个概念被反复提及，却仍缺少稳定 landing page

如果对现有页面做一次聚焦更新会让 wiki 更清晰，就不要新建页面。

## 输出要求

做出修改时，应报告：

- 读了哪些文件
- 创建或更新了哪些文件
- 改了什么
- 哪些结论有来源支持
- 哪些结论是推断
- 哪些页面已被识别为受影响，但尚未更新