技能｜知识库目录表重建SOP
适用场景
知识库笔记增删较多后需要刷新 Excel 目录表，或目录表内容疑似过期/与实际文件对不上时使用。绑定 WorkBuddy 技能：kb-catalog-generator。触发词：生成知识库目录、更新目录表、刷新目录、知识库文件清单、目录表对不上。
操作步骤
- 确认闭占用：目标 xlsx 若正被 Excel 打开，脚本会主动跳过并提示（不强行写入）——先关闭 Excel 再跑，否则看不到更新。
- 执行重建：
python <项目根目录>\scripts\gen_kb_catalog.py（脚本内已固定 vault 与输出路径，无需传参）。 - 依赖快照：脚本覆盖前自动另存快照
知识库目录_<我的知识库>_快照_YYYYMMDD-HHMMSS.xlsx，出错可回溯。 - 核对两页：输出表含「总览 + 明细」两页，扫一遍八个库（
00-灵感库…07-原子库）计数是否合理。 - 清理旧快照：按"只留最新 + 上一版"规则处理历史快照（送回收站而非永久删）。
- 联动：本技能是全库巡检的一环，可并入 [[技能｜知识库全库自动巡检SOP]] 一次跑完。
注意边界
- 脚本红线：只读取 vault、只写那一个 xlsx，不改动任何笔记；不访问涉禁目录。
- 目录表是"某一时刻的快照"，笔记随时在变，别把它当实时数据源。
- 目标文件被占用时脚本不会报错退出，容易误以为"跑完了"——需看提示确认是否真写入。
反例避雷
| 反例 | 为什么错 | 正确做法 |
|---|---|---|
| Excel 开着就跑，跑完以为更新了 | 脚本已跳过写入，表还是旧的 | 先关闭 Excel，跑完看提示 |
| 手动改 xlsx 内容当修正 | 下次重建全被覆盖，白改 | 要改就改笔记，目录表始终由脚本生成 |
| 快照无限堆积 | 占空间且难找最新版 | 只留最新 + 上一版，其余送回收站 |
| 把目录表当权威数据对外引用 | 可能已过期 | 引用前先重建 |
| 用脚本去动笔记内容 | 超出脚本职责，风险不可控 | 脚本只读笔记、只写目录表 |
关联笔记
- [[技能｜知识库目录表生成法]]（通用版：云知识库 +
gen_catalog.py，讲分类体系与 Excel 格式；本机 vault 目录表用本法） - [[技能｜知识库全库自动巡检SOP]]
- [[技能｜技能库入库与迭代SOP]]
> 两条分工：生成法＝「怎么设计目录表」（分类/摘要/格式）；重建SOP＝「本机怎么刷新」（脚本/快照/占用）。
实战战绩
长期用于 <项目根目录>\知识库目录_<我的知识库>.xlsx 维护；2026-09-28 批量新增 9 个技能笔记后重建，确认总览与明细两页计数同步更新。
版本记录
| 版本 | 日期 | 变更 |
|---|---|---|
| v1.0.0 | 2026-09-28 | 首版入库：补齐 kb-catalog-generator 对应条目，明确占用跳过、快照回溯、只留两份 |
