技能｜文档图片自动归档同步SOP
适用场景
开发过程中图片与文档散落在脚本目录、设计目录、运行时目录等多处，需要按《开发文件存储规则》自动归位、留痕、且不破坏原引用时使用。典型触发：每次产出截图/插图/报告后做"07 图片"自动归档、对手册任意变动做带时间戳版本存档。
操作步骤
- 图片归档（07 图片）：运行
python scripts/sync-figures-07.py。脚本扫描预设源目录（_figs/设计文档/程序源代码\docs·资源\图标·runtime\work\qa_figs等），按路径/文件名推断章节（00 总纲…06 成品；通用源图→源图），复制不移动（保留原文件供脚本/报告引用，移动会断链），幂等（同名同大小跳过）。 - 文档自动存档：运行
python scripts/sync-manual-archive.py。扫描系统操作手册全部文档，与上次 md5 快照比对，新增/变更者复制带时间戳副本到.workbuddy\版本存档\系统操作手册\<相对路径>\，不覆盖、留痕可回溯；图片资产（07 图片）不进文档版本存档。 - 二者均可反复执行（幂等），纳入每日自动化或手动收尾。
- 归档口径随存储规则升版同步：源目录清单、章节映射、排除项（如 07 图片）按最新规则调整。
注意边界
- 归档=复制不移动：源文件是脚本/报告引用源头，移动会断链，严禁移动/删除源。
- 章节推断顺序敏感：长词（"05 测试"）须排在短词（"测试"前缀）之前，避免误归到"源图"。
- 文档存档排除 07 图片（图片另有归档规则），避免重复与体积膨胀。
- 路径归一：脚本以
程序源代码\scripts为锚推算D:\某单位与手册/归档根，勿硬编码绝对路径。 - 快照 state 文件（_state.json）记录 md5，删快照会触发全量重存。
反例避雷
- ❌ 把归档做成移动：源图被移走，报告/脚本引用 404。正：复制不移动。
- ❌ 章节映射漏排"05 测试"优先：UI 测评图名含 test/qa 却归到源图。正：长词优先 + 文件名前缀兜底。
- ❌ 文档存档把 07 图片也扫进去：体积爆炸。正：显式跳过 07 图片/07 图形。
