子 agent 使用的是父 agent 创建时快照的模型,不跟随 Web UI 里切换后的当前模型

[Ryze-T]

现象

在 Web UI 中切换模型后,父 agent 派生的 in-process 子 agent 并没有使用当前选中的模型,而是使用父 agent 创建时记录的模型。我这次 7 个子 agent 全部因此启动失败,报 UNKNOWN_MODEL,并且它们用的 provider/model 甚至是我 settings 里从未配置过的 kimi-k3。

复现

一次 Web 会话,期间在 UI 里切换过 3 次模型。session 日志中父 agent 的 request/header:

seq=12   provider=packyai            model=grok-4.6
seq=136  provider=packyai            model=glm-5.3
seq=689  provider=deepseek-official  model=deepseek-v4-flash    ← 该 turn 成功完成

在最后这个 turn 里,父 agent 通过 tool-subagent(provider: spawn)派生了 7 个子 agent。每个子 agent 的 subagent/descriptor 都记录:

agentProvider: "packyai"
agentModel:    "kimi-k3"

所有 7 个子 agent 的 turn/end 均为:

{ kind: "error", error: { code: "UNKNOWN_MODEL",
  message: "pi-ai provider \"packyai\" has no configured model \"kimi-k3\"" } }

两点异常:

1. 父 agent 早已切到 deepseek-official,子 agent 仍走 packyai。
2. kimi-k3 在本部署的 settings 里从未配置过,像是某处残留的 stale default。

根因(源码定位)

• packages/host/apiproxy/src/api-proxy.ts:1081 — 顶层 agent 创建时的 agentOptions() 读 defaults.defaultModelSelection(),该值成为 parent.options 的创建期快照。

• packages/host/apiproxy/src/api-proxy.ts:2247-2261 — UI 切模型只更新会话级 ModelSelectionRef 并尝试持久化 default;持久化失败被 logger.warn 吞掉,不 throw,parent.options 也不更新。

• packages/subagent/subagent/src/continuation.ts:413-414 — 子 agent descriptor 构造:

  const agentProvider = request.agentOptions?.provider ?? parent.options.provider
  const agentModel    = request.agentOptions?.model    ?? parent.options.model

  当 tool-subagent row 未显式配 agentOptions 时,回退到 parent.options —— 即那份创建期快照,不跟随 UI 切换。

若中途 saveDefaultModelSelection 失败,后续 agents.create 拿到的 default 甚至可能是当前 settings 里根本不存在的值(如本例 kimi-k3),现象就是"stamped 了一个 settings 从未出现过的模型"。

影响

• 子 agent 静默走错 provider/model,忽视 UI 里的当前选择。
• 常见后果:子 agent 首次请求即因 provider/model 不匹配失败,父 agent 只好自己接管子任务,并行子 agent 完全失效。
• UI 层不可见:子 agent 只是"快速夭折",只有翻 session.jsonl 才能看到 descriptor 里错位的 provider/model。

修复

1. continuation.ts 构造 descriptor 时,先读父 agent 的当前 selection(通过 ctx.agentDefaultModel.currentSelection() 或安装在 parent.ctx 上的 ModelSelectionRef),再回退到 parent.options。
2. 或在 UI 切模型时同步更新 parent.options(或改成 live ref),消除"创建期快照"这个概念。
3. saveDefaultModelSelection 失败不宜仅作 warn 吞掉 —— 它是后续 agents.create 拿 default 的唯一来源,失败会直接产生"stamped 了 settings 里没有的模型"这种诡异状态。

[ylwl1997]

tool-subagent 吃的是父 agent 创建时写进 parent.options 的模型，不是 Web UI 当前选中的那个。所以父会话已经在 deepseek-official / deepseek-v4-flash，子 agent 还会去拉创建时的 packyai / kimi-k3，配置里没这个模型就 UNKNOWN_MODEL。#3666 同一条。

UI 里切模型不会回写已有子 agent，也不会改父 agent 的创建快照。

先能用的绕法：切完模型后 新开一条会话 再 spawn / fork；这条旧会话里已经失败的子 agent 不要重试。禁用 tool-subagent 只能避免再派生，救不了当前 turn。

[weijiafu14]

这里有一个已经端到端验证的立即可用方案，针对的正是“Web/TUI 已切换当前模型，但新子代理仍读父 Agent 创建时快照”这条链。它是 Pi 插件子代理路线，不是对 DSH 原生 subagent 的源码修复：

dsh plugin --profile <你的-profile> add pi2dsh
dsh plugin --profile <你的-profile> add @tintinweb/pi-subagents

新子代理未显式指定模型时，pi2dsh 读取父会话持久日志最后一条真实 request/header，把 provider/model 作为一个完整 route 交给 DSH child agent；只有日志还没有真实请求时才退回创建时快照。

stock TUI + 真模型 E2E 已验证：父会话从官方线切到 work-gw 后，父日志出现两条不同路由，子日志只出现切换后的 work-gw，并真实执行工具完成任务。复现：
https://github.com/weijiafu14/pi2dsh/tree/main/examples/subagents
https://github.com/weijiafu14/pi2dsh/blob/main/community/subagents-acceptance-report.md