迭代与版本机制¶
知识库的敌人不是「写得少」，是「写完就死」。这一页定义它怎么活。
一、四个节奏¶
| 节奏 | 动作 | 负责人 | 产出 |
|---|---|---|---|
| 每周 | 投料：把本周新文件跑 ingest.py |
各部门助理 | 素材索引更新 |
| 每月 | 编译：把新素材里的事实编进域页面；更新 index.md |
维护人 + 各 Owner | 月度编译日志 |
| 每季 | 评审：抽查 10 个高访问页面，核对数字与状态 | 总经办 | 评审记录、废止清单 |
| 每年 | 重构：合并重复、拆分过长、重画导航 | 维护人 | 大版本号 +1 |
二、版本号怎么记¶
不用文件名记版本，用 git：
v1.0首次建库（2026-11-07）；- 小改（改错字、补链接）：不升版本，只更新
updated； - 中改（新增页面、补一节）：
v1.x； - 大改（结构调整、口径整体切换）：
v2.0，并在11_待确认/变更日志.md写「迁移说明」。
每次提交信息格式：
[域] 动作: 简述
例：[04_加盟] 订正: 加盟费改为 29,800，附 2026 政策函
三、每月编译怎么做（30 分钟版）¶
- 跑
python3 99_工具/ingest.py，看素材索引.csv里新增/变化的行； - 对每条新素材问：它改变哪个既有结论？没有改变就只登记，不写页面；
- 有改变的，改对应域页面 + 变更记录；
- 更新
11_待确认/口径冲突清单.md：关掉已确认的，新增新发现的； - git commit。
不要为每份文件写摘要。知识库的价值在「结论」，不在「文件目录」。
四、季度评审怎么抽查¶
抽三类页面各若干：
- 对外口径类（加盟费、投资额、回本周期）——最容易被截图传播，必查；
- 执行标准类（门店规范、稽查表、SOP）——门店真在按这个做吗？
- 合同财务类（承包协议、分成比例）——和最新签署版一致吗？
抽查结论只有三种：维持 / 订正 / 废止。写进评审记录。
五、自动化的边界¶
ingest.py 只做机械抽取，不做判断。可以自动化的：
- 原件 → Markdown、哈希、索引；
- 死链检查；
- 页面清单与最近更新列表。
不可以自动化的：改口径、判生效、删旧说法。这些必须有人署名。
六、失败模式预警¶
| 症状 | 说明 | 处方 |
|---|---|---|
| 页面越写越长 | 一页装了三件事 | 拆页，留主页面 |
| 同一数字有五个版本 | 没走冲突流程 | 全部并列，指定唯一 Owner 裁定 |
| 没人改 | 没有 Owner 或没有使用场景 | 先找用的人，再谈维护 |
| 全是「待确认」 | 不敢定口径 | 每月强制关闭 3 条 |
| 变成文件仓库 | 只投料不编译 | 停投料一周，先补编译 |