zjchina.net

Drogon · ROS 2 · 独立开发笔记

ADR-00032026-09-23补录

修订版本只在 publish 打点

拍板:zj

背景

修订链在哪个动作上打点,决定了这条链记录的是什么。文章在后台会经历大量 草稿 PATCH:改错字、调摘要、存一下再想。如果每次保存都生成版本,链里充满 从未对读者存在过的快照——它记录的是作者的击键,不是公开承诺。另一个相关 问题是下架:下架是不是一个版本?下架后改正文再发布,链往哪接?

选项

  • 每次 PATCH 都打版本。 链最“完整“,但版本号被草稿抖动灌水,读者时间线 出现一堆从未公开的 vN,存档语义被稀释。
  • 作者手动点“存档版本“。 看似灵活,实则依赖纪律,忘点就断档,且把 “哪些值得留“的判断推到每一次操作里。
  • 仅 publish 打点(采纳)。 版本 = 对读者的公开承诺;草稿反复改不进链, 下架不产生版本,下架后重新发布链继续延长(v3→v4,prev 不断)。

证据

  • 链的语义在设计文档 §1 一句话锁定:“每一次公开发布都是一个内容寻址、 指向上一版的不可篡改快照”——打点时机必须与“公开发布“对齐。
  • E2E(scripts/test-revisions.sh)实证完整生命周期:新建→publish 得 v1, 改正文→publish 得 v2 且 prev=v1,跨下架再 publish 得 v3 链不断。
  • 已知取舍:slug 复用等于历史续链(区分删后重建需 post UUID,本期不做), 已在路线图落地注记中明示。

拍板

拍板者 zj:版本只在 publish 打点;下架不出版本、重发续链;草稿不进链。 AI 协作者参与生命周期推演与 E2E 用例设计。 日期:2026-09-23(2026-09-24 补录)。

← 返回决策日志