静态顺序算法必须和展示层用同一套全序(含时间),批量执行还不能只依赖已落盘状态。这两条今天踩完才记下来,代价是两篇相邻撞了同一张 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-run 0 改动;
  • 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 非零接进播报或钉钉通道。