07 · OPS/Changelog

Changelog · 全部版本变更流

渲染 changelog.ndjson (M-15)。每次 PRD/SDD/units rev 都产一条;可点开看 diff、跳归档版本。是项目「记忆」的入口。

UI Wireframe

/devloop/p-731042/ops/changelog
Changelog · p-731042 all · 8 prd · 3 sdd · 4 units · 1 PRD · rev 3 · 10:31:42 · yibo (human_feedback) + OAuth 登录,影响 auth-mw 新增 SDD · rev 5 · 10:32:08 · architect (prd@rev3) 3 个新 Unit: oauth-be / oauth-fe / auth-mw SDD · rev 6 · 10:42:13 · architect (triage_patch) L2 修复: auth-be 401 明确 UNITS · rev 7 · 10:42:14 · architect (rebuild) contract_hash 更新 → 2 个 unit reset 入 L1 重跑 DIFF: + auth-mw (added) ~ auth-be (changed contract) ~ auth-fe (changed contract) [open archive ↗]

每条目录包含

字段来源用途
kindchangelog.ndjson颜色 / 图标
rev + ts + by同上标题行
trigger同上「为什么变」(human_feedback / triage_patch / init)
summary同上一句话变更
diff同上展开后看 +/~/− section · unit 列表
archive_ref同上点开跳归档 HTML

交互

  • 顶部 chip 切换 all / prd / sdd / units(kind filter)
  • 每条点击展开 diff 详情
  • 「↗ archive」按钮在新 tab 打开归档 HTML(history/{kind}-rev-{N}.html)
  • 「↗ compare」按钮跳 PrdDiffPanel 与上一 rev 对比
  • 双击两个条目 → 跨 rev 三方对比(this vs prev vs current)

与 timeline.ndjson 的关系

changelog 是 timeline 的子集 + 增强:

  • timeline 包含所有事件(agent 启动、unit 状态、bug 开关...)
  • changelog 只关心文档版本变更,但带有 cheerio diff 详细对比
  • 两者由 DocStore 同步写入,绝不脱节

关联视图

  • 跳 PRD diff 面板 看具体 section 对比
  • 跳 Loop Log 看 rev 变更触发了哪些 L1/L2 跑
  • 跳 Buglist 看 rev 变更产生 / 解决了哪些 bug