修复回合重进状态并收起已完成执行过程
活动回合快照与Direct事件统一管理生命周期，避免历史终态回放恢复忙碌态 用户消息显示发送时间，历史信封保存时间并通过独立映射回读 完成后统一折叠中间输出和工具调用，最终回复与失败提示保持可见 同步回归用例与规范文档，保留原生实机验收待办
This commit is contained in:
@@ -2,6 +2,8 @@
|
||||
|
||||
对应：[对话回合唯一投影](./【里程碑】对话回合唯一投影-2026-09-16.md)。
|
||||
|
||||
本次增量顺序：先移除 Provider 回放对活动 client 回合的写入，复用活动快照同步并处理过期异步结果；再为历史信封及切片增加可选时间映射；最后在现有回合投影中分离最终回复和可折叠过程，复用 details 与工具组件。新增恢复、时间、折叠边界用例，只运行静态检查，不运行测试；按最新授权本地提交，不推送。
|
||||
|
||||
1. 前端抽取纯回合呈现投影，完整历史关联后分页；删除旧的消息锚定/实时/未归属独立渲染分支。
|
||||
2. Rust 按 item 完成边界冲刷，段切换返回全部快照；收尾等待写任务，修正 upsert 与跨回合裁剪。
|
||||
3. 核对 MCP 输入输出与同状态更新，保留现有脱敏。
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
# 对话回合唯一投影
|
||||
|
||||
- Version: 1
|
||||
- Version: 2
|
||||
- Status: implemented-awaiting-runtime-acceptance
|
||||
- Date: 2026-09-16
|
||||
- Parent Spec: ../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
|
||||
|
||||
## 范围与评审
|
||||
|
||||
单里程碑修复回合展示和流写入的一致性；不改工具执行、鉴权或原始历史格式。结构评审确认：唯一 turn owner、item 顺序、历史身份与分页、失败保留、工具详情更新均有明确归属；无须新增数据库或迁移历史。没有身份的旧记录不得做位置猜配。
|
||||
单里程碑修复回合展示和流写入的一致性；补充终态重进恢复、用户发送时间和完成后的过程折叠。评审确认：活动快照及 Direct 事件拥有生命周期，Provider 回放不创建 client 回合；JSONL 信封可选时间字段不污染原始 item，无须数据库或旧数据迁移；最终回复沿用 Runtime 的最后 assistant item 合同，失败提示不折叠。没有身份的旧记录不得做位置猜配。
|
||||
|
||||
## 验收
|
||||
|
||||
@@ -15,6 +15,8 @@
|
||||
2. item 增量、完成、持久化和回读保持相同身份与固定顺序。
|
||||
3. 工具输入输出保留，重复快照不重复渲染。
|
||||
4. TypeScript、最小 Cargo 检查、编码和 diff 检查通过；用户要求不运行测试，实机新回合/重开/分页验收待确认。
|
||||
5. 已结束回合重进不显示提交中，真实运行回合可恢复；跨项目/新回合迟到快照无效。
|
||||
6. 用户消息时间可刷新恢复，旧无时间记录不造值；完成后中间正文和工具统一折叠，最终回复及失败提示保持可见。
|
||||
|
||||
依赖：既有项目历史和 v1 turn-stream / tool-calls DTO。未完成真实 UI 验收前不进入其它里程碑。
|
||||
|
||||
@@ -24,3 +26,4 @@
|
||||
- 已补充回合归属、分页、重复快照、无流回退及 writer 完成/切段、持久快照单调性/跨回合裁剪用例；按用户要求未执行测试，不能作为已通过凭证。
|
||||
- 静态自审确认视图只剩统一回合列表，不再存在 mapped/unmapped/live 三个回合流出口；失败提示使用稳定 failure 身份。
|
||||
- 真实新回合、历史重开、分页、失败/中断、工具展开输入输出仍待重启原生客户端后验收；仅本地提交，不推送。
|
||||
- 本次增量已完成生命周期来源收敛、信封发送时间和完成过程折叠；定向 TypeScript、ESLint、Cargo check、文档索引通过。新增时间幂等/旧记录、终态分类及内容分区用例但未运行；主页进入项目、重新发送/切项目竞态和自动折叠仍待原生实机验收，仅本地提交，不推送。
|
||||
|
||||
@@ -52,6 +52,7 @@ SpacetimeDB crate、SDK、CLI / standalone 与生成 bindings 按 `2.8.3` 对齐
|
||||
## AGC DirectProject 与 UI workflow
|
||||
|
||||
- DirectProject 对话先在完整历史中按回合/原始 item 身份关联，再分页渲染；每个回合只有一个呈现入口。有流按 item `seq` 交替文本和工具，无流采用历史正文；禁止位置猜配或同时展示累计回复与 item 正文。流写入单调归并，收尾等待落盘任务，不按磁盘“最后一段”猜最终回复位置。详见 AGC 实施计划的“DirectProject 回合展示唯一归属”。
|
||||
- 回合生命周期只由活动 client 回合快照和 Direct 事件恢复；Provider 的历史终态通知不能创建活动 client 回合。消息发送时间保存在历史信封，原始 item 不混入宿主字段；完成后的中间文本和工具默认收进“执行过程”，最终回复及失败提示保持可见。
|
||||
|
||||
- AGC 安装产品名统一为“陶泥儿”，由 Tauri `productName` 控制安装项、快捷方式与 EXE 产品描述；Windows 内置 Codex 安装到顶层 `coding-agent/win-x64/`，打包资源映射与运行时查找路径必须一致。内部可执行文件名与应用 identifier 保持稳定。
|
||||
|
||||
|
||||
@@ -1416,8 +1416,15 @@ DirectProject、Agent Runtime、Provider、app-server、内置 MCP、命令执
|
||||
|
||||
## 2026-09-15 Direct 回合跨页面生命周期与运行中项目可见性
|
||||
|
||||
Direct 回合的所有权属于进程内项目身份锁，不属于当前页面。离开工作台或切换到首页时，正在运行的回合继续执行；重新进入项目时，前端先读取同一份只读活动回合快照，再通过 Thread Manager 订阅 bootstrap 和后续事件恢复忙碌态、进度与未完成回复。活动回合结束后移除快照并解除发送阻断；没有活动回合的项目保持原有发送行为。
|
||||
Direct 回合的所有权属于进程内项目身份锁，不属于当前页面。离开工作台或切换到首页时，正在运行的回合继续执行；重新进入项目时，只读活动回合快照负责恢复 clientTurnId 与运行状态，Direct 回合事件负责更新进度。Thread Manager 的 Provider turnId 与事件序列不得当成 clientTurnId 或展示事件序列；其通知只触发快照和历史同步，回放的终态不能重新创建活动回合或“正在提交回复”。定期复核同一份活动快照以弥补页面切换时丢失的结束事件；失败读取保留已知状态，过期读取不能覆盖新回合。活动回合结束后移除快照并解除发送阻断；没有活动回合的项目保持原有发送行为。
|
||||
|
||||
壳层左上角的“正在运行”面板只呈现活动 Direct 回合快照，按开始时间排序，显示项目名、状态、活动时长并允许进入对应项目。快照读取失败只显示读取失败并保留上一份结果，不得改写成权限、审批或业务失败；面板不建立第二份运行真相。应用重启后的恢复、取消入口和非 Direct Agent 项目不在本合同内。
|
||||
|
||||
活动回合快照命令是进程内 Tauri 只读命令，不进入公共 API 或持久化协议；字段包含 `projectPath / projectName / turnId / status / activity / startedAt / updatedAt / sequence`，状态和序号与既有 Direct 回合进度事件一致。
|
||||
|
||||
### 消息时间与完成回合的过程折叠
|
||||
|
||||
- 用户消息显示发送时刻，精确到秒。新历史信封记录接收时刻 `recordedAt`（Unix 毫秒），原始 Codex item 不增加宿主字段；历史切片通过独立 `itemTimestamps` 映射返回。幂等重复写不刷新时刻，缺时间的旧记录保持未知，不使用打开页面时刻或工具开始时刻补造。
|
||||
- 运行中的正文和工具按原有唯一回合流实时显示；完成后，除最终回复和失败提示外，中间文本与所有工具调用统一放入默认收起的“执行过程”，允许手动展开，刷新或重新进入仍默认收起。
|
||||
- 最终回复沿用 Runtime 的最后一个 assistant item 合同，不按文本长度或相似度判断。失败回合不把最后一句过程输出伪装成最终回复。无流历史按同一用户消息边界划分，只保留最后一条 assistant 回复在外；用户消息与失败提示始终保留。
|
||||
- 验收覆盖已完成回合重进、真实活动回合恢复、跨项目迟到快照、运行到完成自动收起、历史无流、失败、发送时间刷新和旧记录时间缺失。不改变实际工具执行、鉴权、数据库或用户项目内容。
|
||||
|
||||
@@ -58,6 +58,7 @@ toolCalls?: DirectTurnToolCall[] | null;
|
||||
### 4. 前端合并与渲染（回合唯一归属，连续工具成块）
|
||||
|
||||
- 加载对话时按 `turnId` 归并为唯一回合容器，用户消息保留在该回合前部。有 `turn-stream.jsonl` 时，文本与工具按 item `seq` 交替，连续工具合为一块，遇到文本另起一块；没有流的历史回合才采用“工具块 + 历史正文”。
|
||||
- 回合完成后，中间文本及所有工具块统一收进默认关闭的“执行过程”；最终回复及失败提示留在外面。展开后仍按原顺序查看中间输出和工具详情；运行中不使用外层折叠区。用户消息的发送时间从消息自身的历史时间读取，不能拿工具起点补造。
|
||||
- 实时与回读共用同一投影，正文、工具和耗时不另建实时/未归属渲染出口。先在完整历史按消息身份关联，再分页；禁止按第 N 个工具回合匹配第 N 条用户消息。详情通过当前回合 `callId` 关联；同项目回读与实时增量幂等合并，切项目清空旧状态。完整合同见 [AGC 实施计划](./【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md) 的“DirectProject 回合展示唯一归属”。
|
||||
- 块 DOM 与交互（对齐 Codex）：
|
||||
|
||||
|
||||
Reference in New Issue
Block a user