UI Wireframe
每条目录包含
| 字段 | 来源 | 用途 |
|---|---|---|
| kind | changelog.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