修复博客封面图重复的两个叠加 bug(同批次规划与日期正则)(2026-11-10)
静态顺序算法必须和展示层用同一套全序(含时间),批量执行还不能只依赖已落盘状态。这两条今天踩完才记下来,代价是两篇相邻撞了同一张 IPFS 图。
一、现象与定位入口
ov1107 与 ov1108 用同一张封面 mva6xopami。先怀疑只是单次生成错乱,跑了一遍 reflow:改动 5 篇——全是 10-23 那批同日文章互换位置,首页相邻重复仍有 4 处(10-22~10-23 段)。说明不是单点问题,是两套顺序不一致在叠加。
二、根因一:cover_at 只看磁盘
11-08 早上那次运行 待写 2 个(11-08、11-07,倒序):
cover_at("2026-11-08")→ prev=11-06(q57g4v) → cvmva;- 写盘后再算
"2026-11-07"→ prev 还是 11-06 → 同样得 cvmva。
倒序逐篇必然错位:第二篇的"前一篇"取决于第一篇,而第一篇是更晚日期。修法是把 cover_at(date, pool, assigned) 加第三参接收「本次已规划未落盘」的 {日期:封面};主循环前按日期升序把整批规划好(plan),生成仍走 todo 原倒序。
三、根因二:date 正则丢时间戳
re.search(r"^date:\s*(\S+)") 遇空格即止,dt 变成 2026-10-23。同一天 7 篇(10-23 补史那批)key 完全相同,sort() 退化成按 abbrlink 字母序——而首页展示是按完整时间倒序。两套顺序不一致 ⇒ 相邻撞封面。
修法:正则改 r"^date:\s*(\S+(?:[ T]\S+)?)";比较统一取 dt[:10](assigned key 只有日期)。reflow_cover.py 的 RE_DATE 同步改。
四、兜底收口与验证
副作用可控:修后 reflow 改动 5 篇,全是 10-23 那批同日互换;11 月及以后不受影响(reflow 用 pool[i % n],只与索引有关)。
兜底:daily_refresh.sh 新增 4.4) 封面顺序收口——文章步骤后跑 reflow_cover.py(幂等),有改动则 CHANGED=1 打 WARN「生成器 cover_at 又算错了」。报告新增「封面:」一行,变量 R_COVER。
验证三关都过:
- 首页顺序相邻同封面 0;
- reflow 二次
--dry-run0 改动; cover_at预测 11-10→mva、11-11→w4d、11-12→7g4v(批量规划连续递增)。
Pages 已生效:ov1107=mva / ov1108=w4d / ov1109=7g4v。主域等 4everland 刷新。提交 4a9b1b0e..53308c8e。
五、教训与遗留
核心结论:「静态顺序 + 外部状态」的算法必须用与展示层一致的全序(含时间),且批量执行时不能只依赖已落盘状态。
遗留:
- 主域 4everland 缓存刷新仍在路上,Pages 侧先验完;
cover_at新第三参目前是显式传入的「本次规划」字典——后续若引入跨日回补,需把 plan 生命周期从"单次运行"提到更稳的状态源(例如按周/月落盘);- reflow 兜底已挂到 daily_refresh.sh 4.4,但没有告警出口(只打 WARN),下次撞封面时靠人眼发现——可考虑把
R_COVER非零接进播报或钉钉通道。