# Knowledge Base 结构梳理报告

生成日期：2026-05-20

## 检查范围

本次检查覆盖：

- `knowledge_base/INDEX.md`
- `knowledge_base/routing/`
- `knowledge_base/**/_MANIFEST.md`
- p1-p6 补充后新增的 `analysis/`、`policies/`、`entities/*`、`narratives/*`、`events/*`、`primitives/*` 等目录

## 发现的问题

1. 部分新增目录缺少 `_MANIFEST.md`：
   - `analysis/`
   - `analysis/elections/`
   - `entities/alliances/`
   - `entities/equipment/`
   - `entities/governments/`
   - `entities/organizations/`
   - `policies/`

2. 多个已有 `_MANIFEST.md` 未反映 p1-p6 新增文件，仍停留在早期文件集合。

3. routing 中存在旧路径体系：
   - `by_actor.md` 中大量引用 `actors/`、`states/`、`institutions/` 等当前知识库不存在的旧目录。
   - `by_topic.md` 中仍带有大量 `[占位]` 标记，但对应文件很多已经实际生成。
   - `by_event.md` 中存在模型生成残留文本，影响智能体按事件路由。

4. routing 索引不完整：
   - `routing/_MANIFEST.md` 未列出 `by_analytical_lens.md` 与 `by_timeframe.md`。
   - `INDEX.md` 已引用分析视角路由，但未完整表达时间路由。

5. `live/_MANIFEST.md` 需要保留每日热点文件的日期选择规则和使用边界，避免 live 文件增多后被模型全量读取。

## 已完成更新

1. 为所有缺失目录补充 `_MANIFEST.md`。

2. 重新整理各级 `_MANIFEST.md`：
   - 每个 manifest 以当前目录实际文件为准。
   - 文件清单只列实际存在的文件，减少不存在路径对模型的误导。

3. 重写核心 routing：
   - `routing/by_actor.md`
   - `routing/by_topic.md`
   - `routing/by_event.md`
   - `routing/cross_reference_rules.md`

4. 新增并接入补充 routing：
   - `routing/by_analytical_lens.md`
   - `routing/by_timeframe.md`

5. 更新入口索引：
   - `INDEX.md` 增加 `analysis/` 与 `policies/`。
   - 标明按分析视角、时间范围分诊的入口。
   - 更新版本日期为 2026-05-20。

6. 更新 `live/_MANIFEST.md`：
   - 保留日期选择规则。
   - 明确 `live/` 是近期素材层，不是稳定知识本体。
   - 明确 live 文件过多时只读相关日期，不遍历全目录。

## 一致性检查结果

已执行结构检查：

- 缺失 `_MANIFEST.md` 的目录数量：0
- `routing/_MANIFEST.md` 未列出的 routing 文件数量：0
- routing 文件中的 `[占位]` 标记数量：0
- `INDEX.md`、`routing/*.md`、`**/_MANIFEST.md` 中的实际文件引用未发现有效缺失项

说明：`live/YYYY-MM-DD.txt`、`YYYY-MM-DD.txt` 等是命名模板，不是实际缺失文件。

## 后续建议

1. 后续每批知识文件生成后，同步刷新对应目录 `_MANIFEST.md`。
2. 若新增一级目录，应同步更新 `INDEX.md` 的知识库结构表。
3. 若新增重要议题，应同步更新 `routing/by_topic.md` 与 `cross_reference_rules.md`。
4. 若新增重要人物、机构、媒体或外国行动者，应同步更新 `routing/by_actor.md`。
5. 每次大规模补充后，建议重新运行一次结构检查，避免旧路径和占位标记残留。