Files
drouter/devtools
liuzhuohua 3f5f31701e feat(devtools): 新增截图覆盖度检查,README 标明待补页面
核对用户打包发来的 78 张截图,与仓库已入库的 78 张 md5 集合完全一致
(互相零差异),确认上一轮提交已是完整状态,本次不需改动任何图片。

本次补充的是「防漂移」能力:

1. 新增 devtools/check-shots.py —— 功能页 ↔ 截图 ↔ README 引用 三方对账
   - 43 个功能页逐个报告有无截图(当前 40 有 / 3 缺)
   - 映射表登记的截图 vs docs/screenshots/ 实际文件,双向查差异
   - README 引用的 vs 实际存在的,双向查差异
   为什么不用中文页名做子串匹配:「防火墙 IPv4」会命中「防火墙 IPv6」的
   规则说明,误判是静默的假绿。宁可手工维护一张映射表。

2. sync.sh 里原来那段内联的截图清单校验,替换为调用 check-shots.py
   (功能被完整覆盖,且现在多了功能页覆盖度这一维)。

3. sync.sh 的 CRLF 检查改为只扫 git 已追踪的文件。
   原来用 glob('**/*.html') 会扫到未追踪的本地临时预览页
   (_preview-shots.html),它既不会进仓库也不会被 deploy.sh 上传,
   为它报错是纯噪音。

4. README 截图章节新增「还没截图的 3 个页面」折叠块:
   新手向导 / 主题之家 / 升级与保护,附补图流程。
   项目结构章节补充两个新工具。

验证:check-md-links 98 个引用 0 死链;check-shots 三方一致;
      t-audit / t-packaging 全部通过。
2026-09-30 23:05:51 +08:00
..