按 grill 结论修正 DirectProject 聊天真相源收敛计划

里程碑与实施计划改定边界：Thread Manager 只搬运脱敏原始条目，不生成卡片形状与可见性条目身份归一为 call_id ?? id，Thread Manager 与前端不再暴露第二个 id 概念，分页锚点仍取文件里的原始 item id 合并规则收敛为"先到定形、后到补空白"，删除逐字段优先级表主规范补充条目形状三条职责边界，并说明思考正文流式下发不放宽可见范围 ADR 同步：DirectRuntime 自己的进度事件与投影文件保留，前端删除的是 DirectProject 的读路径失败与中止说明只在运行期显示；历史切片改为从文件尾反向扫描；未知 item 类型透传并加 TODO
2026-09-16 19:05:04 +08:00
parent 656c89e4b2
commit 42b702d362
4 changed files with 61 additions and 27 deletions
@@ -124,7 +124,17 @@ Thread 内所有公开事件共用一个单调递增 seq；seq 允许跳号，

 生命周期锚点独立于 replay 队列保存：`turn.started` / `turn.completed` 事件即使已被队列前缀回收，`subscribe` 仍必须把最新的一条作为 bootstrap 事件返回。因此进程内任意时刻新建订阅，都能判定最新回合是运行中还是已结束，不依赖"未完成 item 恰好还在队列里"。

-`item.started` 与 `item.completed` 必须携带与历史切片同形的完整条目（经同一套脱敏、截断、路径归一），不得只给 item 类型或空 payload。前端不得依赖"按 `itemId` 单点取快照"补齐正文：Rust 不提供 `getItemSnapshot(itemId)`，未完成条目的正文随事件下发，已完成条目一律通过历史读取。
+`item.started` 与 `item.completed` 必须携带与历史切片同形的**脱敏原始条目**（经同一套挑字段、脱敏、截断、路径归一），不得只给 item 类型或空 payload。前端不得依赖"按 `itemId` 单点取快照"补齐正文：Rust 不提供 `getItemSnapshot(itemId)`，未完成条目的正文随事件下发，已完成条目一律通过历史读取。
+
+条目形状的职责边界固定为三条：
+
+1. **搬运层不生成展示形状**。Thread Manager 只下发 Codex 原始条目（`itemType` 原样透传，正文与工具明细脱敏后带上限截断），不生成工具卡片的 `kind`、标题、折叠摘要，也不判断哪些条目要显示。
+2. **只有一个条目身份**。`itemId = call_id ?? id`：工具 item 的 app-server id 就是 `call_id`（codex-rs `thread_history.rs` 中所有工具 item 都是 `id: payload.call_id.clone()`），而 `project.jsonl` 落盘的是原始 response item（`id` 与 `call_id` 不同），所以在进队列前归一。Thread Manager 与前端都不得再出现第二个 id 概念。
+3. **合并只在前端，且只保留"先到定形、后到补空白"**。第一次见到的快照决定卡片形状，后续快照只补输出与状态；同一调用只出现一张卡片。
+
+历史切片的 `firstItemId` 不是上述归一身份：分页锚点必须是 `project.jsonl` 里的原始 item id，由 Rust 从文件扫描单独算出。
+
+思考正文以 `item.delta{kind:"reasoning"}` 流式下发（来源是 app-server 的 `item/reasoning/summaryTextDelta` 与 `item/reasoning/textDelta`）。这不放宽可见文本范围：被下发的就是此前已在 `item.completed` 展示、并已落进 `project.jsonl` 的同一段文本；plan 文本与命令输出仍然只降级为活动状态，不下发正文。

 ### 队列、subscriber 和回收