多比读书 · 知识库架构 v1.0

多比读书
知识库架构

全生命周期管理 · 从素材进库到知识网络建成
一站式治理，物理硬断言，零死链交付

4
阶段
10
铁律
0/0
死链
100%
合规
↓ 查看四阶段工作流
✅ 物理级 0/0 死链，全部通过
WORKFLOW · 四阶段工作流

从素材到知识网络

四个阶段环环相扣，每步都跑物理校验脚本做硬断言。小批量高频验证，绝不在大动作后忘记验证。

📥 原始素材
→
📝 Stage 1 摘要
→
🧩 Stage 2 实体
→
✂️ Stage 3 剪枝
→
🏆 Stage 4 验证交接
01

资料摄入与摘要

原始素材 → 摘要目录

回读原始文案、PDF、转写稿等素材，按标准模板生成结构化拆书摘要。内容面向旁白解说与知识结构提炼，严禁生成出镜朗读类脚本。

≤ 5 篇 / 批
02

实体提炼与建立

摘要 → 实体目录

从摘要中提取人名与独立概念，反向回读提炼内容。必含"也叫做""核心要点""相关实体"等必需章节。已有实体综合所有来源重写，绝不追加。

≤ 3 个 / 批
03

降维剪枝与网络化

剪枝 + 别名修复 + 建主题

识别"X与Y"等复合短语噪声，去双括号降级为普通文本；用别名格式修复不匹配链接；在跨多个实体/摘要涌现高维概念时建主题页连接知识网络。

≤ 10 个 / 批
04

物理硬断言与交接

跑校验 → 更新交接文档

跑内置物理校验脚本做硬断言：死链 0/0、模板 100% 合规。上下文临近上限或跨窗口时，自动更新根目录交接文档，无缝续接。

死链 = 0 硬目标
TRIGGERS · 触发指令

用自然语言直接触发

无需记忆复杂命令，用自然语言描述意图即可启动对应阶段。

🔍
"治理知识库"
Stage 4
跑校验脚本 + 清死链，完整治理一轮
🔗
"检查死链"
Stage 4
只跑校验脚本 + 读死链清单
📥
"录入新素材"
Stage 1
根据原始文案生成结构化摘要
📝
"新增摘要"
Stage 1
指定素材编号，生成对应摘要
📦
"批量导入 X 系列"
全阶段
摘要 → 实体 → 剪枝 → 验证 → 交接
🧩
"提取实体"
Stage 2
从已有摘要提炼并新建实体页
✂️
"降维剪枝"
Stage 3
清理复合短语 + 别名修复
📋
"更新交接文档"
Stage 4
更新交接文档，打包项目快照
TEMPLATES · 模板与结构

标准模板与文件结构

三套标准模板统一位于 .agent/templates/，保证摘要、实体、主题的一致性与可维护性。

📝 摘要模板 · 摘要目录
# [源标题] tags: [标签1, 标签2] source: [原始素材路径] date: YYYY-MM author: [作者] ## 一句话核心 （这篇材料最核心的观点是什么） ## 主要内容 ### [要点一] （展开说明） ### [要点二] （展开说明） ## 关键原文摘录 > （值得记住的原话，标注位置） ## 相关实体 - [[实体1]] ## 可能关联的主题 - 主题1
🧩 实体页模板 · 实体目录
# [实体名称] tags: [类型标签] ## 是什么 （一句话定义） ## 也叫做 （别名、英文原名、常见变体—— 语义查找的关键） - 别名1 - 别名2 ## 来源出处 - [[YYYY-MM 摘要文件名|摘要标题]] —— 简述该来源中的内容 ## 核心要点 - 综合要点1 - 综合要点2 ## 相关实体 - [[实体A]] ## 相关主题 - 主题1
🌐 主题页模板 · 主题目录
# [主题名称] tags: [标签1, 标签2] ## 是什么 （一句话定义这个跨领域的高维主题） ## 涵盖范围 （这个主题覆盖哪些实体和概念） ## 核心脉络 （跨多个源的综合叙事） ## 相关实体 - [[实体A]] ## 相关主题 - [[相关主题A]]

项目目录结构

/knowledge-base/ ├── raw-sources/ # 只进不改：原始素材 │ └── courses/ ├── wiki/ │ ├── summaries/ # 结构化摘要 │ ├── entities/ # 实体页 │ └── themes/ # 主题页 ├── templates/ # 公开模板 ├── .agent/ # 本地配置 │ ├── SYSTEM_PROMPT.md │ └── templates/ ├── verify.py # 校验脚本（零依赖） ├── HANDOVER.md # 交接文档 ├── missing_entities.json # 死链清单（自动生成） └── manual/ # 使用手册
IRON RULES · 核心铁律

十条铁律，违反即破坏知识库

每一条都是用真实教训换来的，贯穿整个工作流。

1

raw-sources 只进不改 —— 原文件绝对不修改，连一个标点都不动

2

整理只在 wiki/ —— 摘要写 summaries/，实体写 entities/，主题写 themes/

3

双向链接必须用 [[ ]] —— 实体引用来源，摘要关联实体，主题关联实体和主题

4

命名规则 —— 文件名 YYYY-MM 关键词.md，中文写正文第一行；文件夹全小写英文 - 连接

5

诚实汇报 —— 每次用校验脚本实测数字，绝不引用文档里的旧数字

6

半成品不拼接 —— 缺章节的摘要/实体一律重写整篇，不原地补全

7

实体更新不追加 —— 新素材提到已有实体时，综合所有来源重写整篇

8

内容取向 —— 面向旁白解说与知识结构提炼，严禁生成出镜朗读脚本/口播文案

9

文件名禁止 / —— 斜杠会创建子目录导致死链；用平铺文件名 + 别名链接

10

死链硬断言 0/0 —— 每批处理后必须跑校验脚本；死链必须回归 0

批次控制铁律

操作上限后处理失败处理
新建摘要≤ 5 篇 / 批跑校验脚本Error > 0 → 修复 → 最多 2 轮后停靠等用户
新建实体≤ 3 个 / 批跑校验脚本同上
格式修正 / 死链修复≤ 10 个 / 批跑校验脚本同上
PITFALLS · 技术坑

六个技术坑，每一个都验证过

用真实故障换来的教训，务必规避。

⚠️ 文件名含 /（如 中文名/消极批判）.md）
自动创建子目录 → 校验脚本只扫顶层文件 → 死链。规避：平铺文件名（去掉 /），用别名链接 [[文件名|显示名]]
⚠️ 链接裸名与文件名后缀不匹配
[[中文名 英文]] vs 文件名 中文名.md → 死链。规避：别名格式 [[中文名|中文名 英文]]
⚠️ 摘要链接不带 YYYY-MM 前缀
[[侥幸3 标题]] → 死链。规避：[[2024-08 侥幸3 标题|侥幸3 标题]]
⚠️ patch 工具对特殊字符文件名不支持
é、ö、·、/ 等无法编辑。规避：用 execute_code + open(path).read()/write() 直接读写
⚠️ 报告数字不实测
引用旧数字导致虚假汇报。规避：每次用 python3 verify.py 实测
⚠️ 实体收集不递归子目录
实体在子目录中 → 死链。规避：实体文件必须放在 entities/ 顶层
EXAMPLES · 示例工作流

三种典型场景

用实际对话方式展示操作路径。

SCENARIO A · 录入单篇素材

用户：新增摘要

  1. 1. 回读原始素材文案
  2. 2. 按摘要模板生成结构化摘要 → 写入摘要目录
  3. 3. 跑 python3 verify.py → 确认无新增死链
  4. 4. 从摘要提取实体：人名、概念...
  5. 5. 新建/重写实体页 ≤3 个/批
  6. 6. 跑 python3 verify.py → 清死链
  7. 7. 死链 0/0 → ✅ 完成
SCENARIO B · 检查死链

用户：检查死链

  1. 1. 跑 python3 verify.py
  2. 2. 读 missing_entities.json
  3. 3. 报告死链数量和清单
SCENARIO C · 打包交接

用户：更新交接文档

  1. 1. 跑 python3 verify.py
  2. 2. 读 missing_entities.json
  3. 3. 清死链到 0/0（别名修复 → 降级剪枝 → 新建实体，最多 2 轮）
  4. 4. 更新交接文档（实测数字、本轮变更、技术坑）
  5. 5. 更新工作规范中的数字
  6. 6. 报告最终状态 ✅
VERIFY · 校验脚本

verify.py 输出解读

运行 python3 verify.py 即可。零第三方依赖，支持别名匹配、排除模板与交接目录。

============================================================ 知识库最终校验报告 ============================================================ [1] 目录结构 ✓ raw-sources/ ✓ summaries/ ✓ entities/ ✓ themes/ [2] 文件计数（实测） 原始素材: — 摘要页: — 实体页: — 主题页: — [3] 摘要模板完整性 合规摘要: —/— [4] 实体模板完整性 合规实体: —/— [5] 死链检测（物理文件存在性） 总链接数: — 唯一死链: 0 总引用次数: 0 [6] 路径检查（残留检查） ✓ 无残留 ============================================================ 校验结果 ============================================================ ✓ 无错误 ✓ 无警告 ============================================================ 状态: ✅ 全部通过 ============================================================
检查项输出含义
目录结构✓ / ✗缺目录 = 错误
摘要完整性合规摘要 N/N缺章节 = 警告
实体完整性合规实体 M/M缺章节 = 警告
死链检测唯一死链: KK > 0 = 必须修复
路径检查残留检查有残留 = 错误
终极目标✅ 全部通过死链 0/0 + 模板 100%
🏆 知识库架构已就绪，随时开始治理

verify.py 输出即终极断言。任何不满足该目标的输出都视为未完成。