所有任务完成后,会话右下角状态图标仍显示「执行中」

[cindy-issue]

提交人: ayayayayo
客户端版本: 0.1.55

---

现象

一个会话的所有任务都已完成,但该会话右下角的状态图标仍然显示「执行中」。

复现步骤(不确定,首次出现)

1. 在会话中通过 Agent 工具并行启动了 3 个后台子代理(探索任务)
2. 3 个子代理全部因 API 错误异常终止(错误信息:API Error: 400 ... Invalid model name passed in model=claude-opus-5)
3. 此后会话继续正常执行多轮同步工具调用(文件读写、shell 命令等)并正常输出回复,已无任何存活的后台任务
4. 全部任务结束后,右下角状态图标仍停留在「执行中」,未复位为空闲

推测:后台子代理以 API 错异常终止后,其运行状态可能未被正确清除或聚合,导致会话级「执行中」状态无法归零。此为推测,未验证。

期望行为

所有任务(含后台子代理)结束后,会话状态图标应回到空闲状态。

实际行为

状态图标持续显示「执行中」,与会话实际任务状态不符。

复现频率

首次遇到,暂无更多复现数据。

已尝试的解决办法

尚未尝试任何操作(未刷新界面、未重启应用)。

诊断摘要(已脱敏)

• 该会话通过 Agent 工具启动过 3 个后台子代理,全部异常终止
• 终止原因均为 API 400 错误:「Invalid model name passed in model=claude-opus-5」
• 异常终止后会话仍能正常完成后续多轮工具调用与回复,无存活后台任务
• 此时用户界面右下角状态图标仍显示「执行中」

---

版本区域: CN
OS: darwin arm64 (25.6.0)
界面语言: zh-CN

[dash-s-cindy]

判断

会话在后台子代理失败后应自动回到空闲。针对 0.1.55 的这次现象，当前 main@05264ab01e5a116d1421ef24e9957b7be7cccffd 已包含直接覆盖该类“后台 Agent 终态后会话永久执行中”的修复，因此当前更需要确认修复是否已进入用户可升级版本并完成安装版回归，而不是再并行实现一套状态清理机制。

Issue 中观察到的现象与历史缺陷一致；“API 400 异常终止后运行状态没有归零”是合理线索，但仅凭错误文案还不能确定残留状态源。当前状态图标可能由以下任一状态撑住：

1. pendingTaskWake：后台 local_agent / local_workflow 到达失败终态后，renderer 等待后续 wake turn 的桥接计数；
2. taskUpdates 中残留的 running 任务；
3. main 侧仍未结算的 continuation claim；
4. 主 turn 自身的 agentStatus.isRunning。

当前 main 已分别为前 3 类状态提供对账或超时收口，因此不能再从 0.1.55 的现场直接推断最新源码仍缺少清理。

行动

1. 先确认发布映射：确认哪个 Desktop 版本首次包含 fix(maker-core,desktop): 唤醒桥接与 continuation claim 超时对账,修复后台子任务完成后会话永久转圈 #2999、fix(desktop): 收口迟到 wake 终态泄漏的 pendingTaskWake 桥接,修复侧栏 spinner 永久转圈 #2952 和 fix(claude-code): preflight subagent model access #3043。当前仓库记录能证明它们已合入 main，但不能证明报告者使用的 0.1.55 已包含这些提交。
2. 在包含当前 main 的安装版复测原场景：并行启动 3 个 Claude Code Agent，令其因无效显式模型失败；主轮继续完成若干同步工具调用并输出最终回复。不要刷新或重启，至少观察 60 秒，状态图标应自动回到空闲。
3. 若最新安装版仍复现，采集一次状态源快照：
   • agentStatus.isRunning 与 status；
   • pendingTaskWake、pendingTaskWakeGen、pendingTaskWakeArmedAt；
   • renderer taskUpdates 中仍为 running 的任务及其 taskType；
   • LIST_SESSION_BACKGROUND_TASKS 返回的权威任务表与 pendingContinuations。

这组数据可以直接判断是 wake 桥接、stale running task、continuation claim，还是主 turn 状态未收口。没有这些证据前，不建议按“所有 API 错误都漏清理”扩大修改范围。

源码证据

1. 当前 renderer 已对 wake 桥接提供两层收口

apps/desktop/src/renderer/lib/makerChatStore.ts 中，Claude Code 的 local_agent / local_workflow 从非终态进入 completed 或 failed 时，会通过 wakesAfterTerminal 增加 pendingTaskWake。这解释了为什么后台任务已经失败，侧栏仍可能暂时保持运行态：产品在等待 SDK 自动启动 wake turn，而不是简单按任务终态立即清空。

当前源码同时存在两条防永久残留机制：

• WAKE_BRIDGE_RECONCILE_MS = 60_000：wake turn 在宽限期内始终未启动时，桥接最终收口；
• seedBackgroundTaskSnapshots(..., { reconcileWakeBridge, authorityPendingContinuations })：在以下条件同时成立时按 main 权威状态清除桥接：
  • 请求前捕获的桥接计数与当前计数一致；
  • 单调代次一致，避免在飞请求发生 ABA 变化；
  • 主 turn 已不在运行；
  • 距最近一次置位超过最小年龄；
  • main 权威任务表中没有 wake 型任务；
  • main 权威 pendingContinuations === 0。

对应测试位于：

• apps/desktop/src/renderer/lib/__tests__/pendingTaskWakeBridgeReconcile.test.ts
• apps/desktop/src/renderer/__tests__/makerChatStoreTaskUpdates.test.ts

测试已覆盖：主轮结束后的迟到终态、失败终态、多任务并发、continuation 尚未归零、请求在飞期间新增桥接、ABA 代次变化、健康 wake turn 启动，以及 wake turn 永不启动后最终熄灭。

2. stale running 任务也已有权威快照对账

apps/desktop/src/renderer/lib/makerChatStore.ts 的 reconcileStaleRunningTasks 会使用请求前捕获的 Claude Code running 候选集，与 main 的后台任务快照对账：候选任务仍在 renderer 显示 running、但已不在权威快照中时，会被收口为 stopped。

apps/desktop/src/renderer/hooks/useBackgroundBashTasks.ts 和后台任务面板均已接入该逻辑。空快照加非空候选是有效的“全部任务已退出”证据，并不会被普遍忽略。

3. 无效显式模型已有预检，但覆盖存在边界

#3043 已在 Claude Code Agent / Task 的 PreToolUse 边界加入模型访问预检。本地和 cc-manager 远程会话共用三态判断：

• 权威 XD Gateway 模型快照明确包含目标模型：允许；
• 权威快照明确排除目标模型：启动前拒绝，并建议省略显式 model；
• 快照非权威、刷新失败、来源不明或无法确认：按 unknown 放行，避免误拦合法模型。

因此，这项修复会减少同类无效 Agent 启动，但不能承诺消除所有供应商或所有 400 Invalid model name。运行态收口仍必须独立正确，不能依赖预检兜底。

验证矩阵

建议至少覆盖：

• 3 个后台 Agent 全部因无效模型失败，主轮完成后最终回到空闲；
• 失败发生在主 turn 运行中，以及主 turn Done 之后；
• 多个失败终态连续置位，桥接计数不会永久残留；
• 权威 pendingContinuations > 0 时不得提前熄灭，归零后应收口；
• 健康 wake turn 在宽限期内启动时不得被对账误清；
• 终态事件丢失、但 main 任务表已删除任务时，stale running 应自动收口；
• 显式模型被权威 XD 快照排除时，应在创建 Agent 前返回清晰错误；
• 非权威模型目录场景继续按 unknown 放行，不新增错误限制；
• 不刷新、不切换会话、不打开后台任务面板也能最终自愈。

风险与边界

不建议在主 turn Done 时无条件清空所有后台任务状态。合法后台 Agent 可能正处于“任务终态已到达、wake turn 尚未启动”的短暂窗口；后台 Bash 还可能是用户有意长期运行的 dev server、构建或监听进程。当前 main 使用超时、任务权威快照、continuation 计数和代际一致性共同收口，比按 Done 一刀切更安全。

另有 #3063 报告 0.1.56 中相似的“任务结束后仍显示后台运行”，但其诊断指向 local_bash 的 stale running 记录，而本 Issue 的触发画像是失败的 local_agent wake 链路。两者界面相似、状态源不同，不应在缺少现场状态快照时直接合并根因。

相关记录

• fix(maker-core,desktop): 唤醒桥接与 continuation claim 超时对账,修复后台子任务完成后会话永久转圈 #2999：已合并。直接修复 Claude Code 后台 wake 任务完成后，renderer 桥接与 maker-core continuation claim 永久等待的问题；失约路径最多 60 秒后收敛。
• fix(desktop): 收口迟到 wake 终态泄漏的 pendingTaskWake 桥接,修复侧栏 spinner 永久转圈 #2952：已合并。针对迟到 wake 终态造成的 pendingTaskWake 泄漏，加入任务表、continuation、代际和最小年龄共同约束的权威对账。
• fix(desktop): 后台任务终态事件丢失后按 main 快照对账收口 #2003：已合并。为 renderer 丢失后台任务终态事件的场景加入 main 快照对账，负责收口 stale running 任务。
• fix(claude-code): preflight subagent model access #3043：已合并。对具备权威 XD 模型快照的显式 Claude 子代理模型做启动前访问预检，减少无效任务启动。
• fix(maker-core): surface Claude subagent launch failures to the parent task #3024：仍在推进。处理进入正常 SDK task lifecycle 之前发生的 subagent launch error，使父会话能看到结构化 failed 任务；它改善失败可见性，但不是当前 main 中会话运行态收口的唯一保障。