知识库导航索引补全

offline-backend-20260512/backend/knowledge/knowledge_generate/knowledge_base_structure_audit.md

@@ -0,0 +1,84 @@
+# 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. 每次大规模补充后，建议重新运行一次结构检查，避免旧路径和占位标记残留。
+