proxycast/docs/exec-plans/claude-code-agent-task-runtime-alignment-plan.md

Claude Code Agent Task Runtime 全面对齐计划

摘要

目标是把 Lime 的 agent 主链从“线程态 + 工具流 + 诊断信号”升级为对标 Claude Code 的“统一任务运行时”：

• 主会话、子 agent、等待输入、完成结算都统一映射为可见任务。
• 简单问题不再错误抬升为常驻 MAIN TASK 面板，只在复杂、长链路、可跟踪任务里显示任务视图。
• 工具调用按批次聚合，必须产出中间过程结论，而不是只留下工具名。
• token usage 与 prompt cache 在任务完成态和消息态都保持可见。
• E2E 与 GUI smoke 后续统一以“任务是否创建、推进、完成”为核心断言。

关键改动

1. Agent Task Runtime 投影

• 新增统一任务投影模型，先覆盖 main_session 与 subagent。
• 每次主会话回合都可以被投影成任务，但展示层增加“简单直答自动折叠”规则。
• 当前回合的任务标题、状态、阶段、等待原因、工具批次摘要、子任务统计统一从现有 thread_read / turns / items / messages / child_subagent_sessions 归一投影。

2. 任务展示规则

• 仅在以下场景显示任务状态：
  • 有工具批次或过程轨迹
  • 有子任务
  • 有排队 / 待补信息 / 等待确认
  • 回合失败或中断
• 简单直接回答成功后默认折叠隐藏，不显示常驻 MAIN TASK。
• 复杂任务也不再插入聊天主区大卡片，改挂输入区底栏弱提示 pill。
• 任务状态 pill 保留：
  • 主任务标题
  • 当前状态
  • 工具批次摘要
  • 子任务数量
  • 阻塞 / 排队信号

3. 工具批次与过程结论

• 复用现有工具批次聚合与工具过程摘要能力。
• 任务状态条优先展示批次级结论，例如：
  • 已探索项目
  • 已查看关键文件
  • 已检查页面
• 当没有工具批次时，状态 pill 回退到等待原因、失败原因或当前阻塞摘要。

4. 回归与验收

• 前端单测覆盖：
  • 简单直答完成后不显示任务状态条
  • 工具批次会显示输入区顶部弱提示条
  • 等待输入会显示等待态
  • 聊天主区仍保留消息级 token usage 与 prompt cache 摘要
• 后续 GUI / E2E 继续对齐：
  • 打开真实项目后触发分析请求
  • 断言复杂任务可见
  • 断言简单直答不出现误报任务卡

当前进度

• 2026-04-14：创建执行计划文件。
• 2026-04-14：前端新增主任务投影工具与任务卡组件。
• 2026-04-14：先前尝试把主任务直接插入聊天主区，已确认不符合 Claude Code 的任务层级。
• 2026-04-14：主任务展示已回撤出聊天主区，并进一步收敛为输入区底栏弱提示 pill；完成态自动折叠。
• 2026-04-14：补充任务投影、输入区与消息列表的定向回归测试。
• 2026-04-14：定向 vitest 已通过，覆盖“复杂任务完成后不继续占据聊天主区，token usage / Prompt Cache 仍由消息结算区承载”。
• 2026-04-14：定向 eslint 已通过；verify:local 仍被仓库现存无关问题阻塞，当前已知阻塞文件为 src/components/agent/chat/utils/toolBatchGrouping.ts 与 src/components/memory/MemoryPage.tsx。
• 2026-04-14：verify:gui-smoke 已启动并推进到 headless Tauri 最终链接阶段，当前阻塞为首次临时 CARGO_TARGET_DIR 的 Rust/Tauri 大编译，尚未拿到 http://127.0.0.1:3030/health 就绪结果。
• 2026-04-14：verify:gui-smoke 最终通过，确认默认 workspace、browser runtime、site adapter catalog 与 agent service skill entry 主链未回退。
• 2026-04-14：浏览器 E2E 已验证复杂请求运行中只在输入区底栏显示状态 pill；完成后 pill 自动折叠消失，消息尾部继续显示 token usage 与缓存统计。
• 2026-04-14：后端已落地“连续只读工具批次并发执行”，当前只对 Bash / PowerShell 的保守只读命令集启用并发，写操作与高风险命令继续串行。
• 2026-04-14：补齐路径预检，避免在分析本地项目时盲猜不存在路径。
• 2026-04-14：定位到 tauri:dev* 脚本把 CARGO_TARGET_DIR 写死为 target，会在 GUI 续测与 Rust 测试并行时放大构建锁竞争；现已改成“默认 target，但允许显式覆盖”。
• 2026-04-14：继续收口“任务分工建议”视觉层级，首页空态与普通输入栏统一改为轻量胶囊提示，不再用大横幅抢占输入区主视觉。
• 2026-04-14：按最新反馈去掉消息正文里的 阶段结论 标题壳；新消息直接显示结论正文，旧历史通过前端统一清洗兼容去标题。
• 2026-04-14：继续追查 GUI 续测慢点，确认 run-tauri-dev.mjs / run-tauri-profile.mjs 会把相对 CARGO_TARGET_DIR 传进 tauri dev，在当前启动链下误写成 src-tauri/src-tauri/target；现已改成仓库根绝对路径下的 src-tauri/target，同时同步更新 README 说明。

本轮验证记录

已完成

• npx vitest run "src/components/agent/chat/components/Inputbar/index.test.tsx" "src/components/agent/chat/components/MessageList.test.tsx" "src/components/agent/chat/utils/agentTaskRuntime.test.ts"
• npx eslint "src/components/agent/chat/components/Inputbar/index.tsx" "src/components/agent/chat/components/Inputbar/components/InputbarComposerSection.tsx" "src/components/agent/chat/components/MessageList.tsx" "src/components/agent/chat/workspace/useWorkspaceInputbarSceneRuntime.tsx" "src/components/agent/chat/utils/agentTaskRuntime.ts"

进行中

• npm run verify:gui-smoke
  • 当前表现：前端壳 http://127.0.0.1:1420/ 可访问，但 3030 DevBridge 尚未监听，页面仍处于 mock/fallback 状态。
  • 当前判断：阻塞源是 headless Tauri 首次完整构建与链接，不是任务 pill 回退或聊天主区重新渲染 task 卡片。
• npm run tauri:dev:headless
  • 当前表现：真实页面发送按钮 disabled 的直接原因不是输入组件，而是 aster_agent_init 因 DevBridge 不可达失败，页面落入 bridge cooldown / mock fallback。
  • 当前判断：根因之一不是单纯构建锁，而是开发脚本传入的相对 CARGO_TARGET_DIR 被 tauri dev 解析成 src-tauri/src-tauri/target，造成双层 target 与冷编译；脚本已改成绝对路径，正在重新拉起真实 bridge 做二次验证。

已完成补充验收

• 真实浏览器会话中已验证：
  • 复杂请求运行中，聊天主区展示的是消息与过程结论，不再插入大 task 面板
  • 输入区底栏出现紧凑状态 pill，内容包含任务标题、状态与批次摘要
  • 任务完成后状态 pill 自动折叠隐藏
  • 消息结算区继续显示 68.0K tokens 与缓存统计 缓存 62.3K（读 62.3K / 写 0）
  • 本轮真实交互后控制台未新增 bridge/runtime 错误，仍只剩浏览器模式的 i18n warning

默认假设

• 本阶段优先修正产品感知与主路径可见性，不先重写底层 session/thread/turn/item 存储结构。
• 媒体 / 插件任务暂不并入统一任务 runtime。
• 真正的后端 task event 契约和 thread_read.task_runs 字段后续再补，当前先用前端投影收口主体验。