[Bug]subagent 无法切换模型——workflow 的 model 覆盖被父 agent 模型覆盖

[peiyade]

TL;DR

在 workflow 里用 agent(prompt, { model: "deepseek-v4-flash" }) 显式指定 flash,实际 LLM 调用仍是 deepseek-v4-pro。session 日志里全部调用都是 pro、0 次 flash。但指定一个不存在的 model 却会启动失败——说明 model 字段被传递、被校验了,只是最终被覆盖回 pro。疑似断点在 packages/core/agent/src/model-selection.ts 的 installModelSelection():selection.current 没有随 AgentOptions.model 更新,仍指向父 agent(或其默认)的 pro。

环境

• DSH 0.1.0-rc.6,profile web(bundles:dsh-base + dsh-web-app)
• Provider deepseek-official,模型目录(见 packages/llm/llm-deepseek/src/index.ts):deepseek-v4-flash / deepseek-v4-pro
• 主 agent 模型:deepseek-v4-pro(~/.dsh/settings.yaml 的 agent-default-model)

复现

在任意 DSH 会话执行一个 workflow,指定 flash:

// workflow script
const r = await agent("请只回复 OK。", { model: "deepseek-v4-flash" });
return { result: r };

然后查 session 日志:

zstd -dc "$DSH_SESSION_JSONL" | grep '"model"' | sort | uniq -c
# 实际结果: 全部 deepseek-v4-pro, 0 次 flash

对照实验(证明 model 字段确实被传递和校验):

const r = await agent("OK", { model: "deepseek-v4-nonexistent-xyz" });
// 结果: r === null (启动失败 → model 被 resolveModelInfo 校验了)

两个实验互相矛盾,说明断点不在传递链,而在最终的 model 选择环节。

详细分析

传递链代码层面是完整的(不是这里断的):

workflow opts.model
  → ChildStartRequest.model                        # workflow-worker-thread/src/runtime.ts:277
  → SubagentStartRequest.agentOptions.model         # workflow-worker-thread/src/host.ts:357-361
  → resolveChildAgentOptions(requested)             # subagent/src/child-agent.ts:66-84
  → AgentOptions.model                              # requested 覆盖 parent.model, 应为 flash

最终 model 选择(packages/core/agent/src/model-selection.ts):

installModelSelection() 监听 agent/request 事件,把 selection.current 的 provider/model 覆盖到每一次 LLM 调用。而 selection.current 由入口点设置,与 AgentOptions.model 是两条路径:

• headless(packages/bundle/headless/src/index.ts:117):selection = defaultModel.currentSelection()(恒为 pro),再把它塞进 agentOptions 和 selected.current。
• web(packages/host/apiproxy/src/api-proxy.ts:1178):selection.current 是 getter(picked → logged → defaultModel)。

推断:subagent child 创建时,resolveChildAgentOptions 把 requested.model=flash 写进了 AgentOptions.model,但 installModelSelection 的 selection.current 没被这个值同步,仍指向 pro,于是 agent/request 把 flash 覆盖回了 pro。

附加发现

1. CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash 这个环境变量不被 DSH 读取(是 Claude Code 的变量),排查时容易误导。
2. dsh-subagent-dsh-sdk(默认 model: deepseek-v4-flash 的 out-of-process backend,见 packages/subagent/subagent-dsh-sdk/src/index.ts:77)存在但未注册——当前 profile 的 node_modules 里没有它,host composition 也没挂它。这本来是一个"默认就走 flash"的现成 backend。

期望

subagent 应能通过 workflow 的 agent(prompt, { model }) / provider 覆盖切到 deepseek-v4-flash(或任意已注册模型),而不是被父 agent 模型覆盖。

版本信息

DSH:0.1.0-rc.6(运行时 checkout,@deepseek-ai/dsh 链接目录名确认)

关键 bundle 版本(~/.dsh/profiles/node_modules/@deepseek-ai/ 实测):

包	版本
dsh-base	0.1.0-rc.6
dsh-web-app	0.1.0-rc.6
dsh-tool-workflow	0.1.0-rc.6
dsh-subagent	0.1.0-rc.5
dsh-subagent-fork-in-process	0.1.0-rc.5
dsh-subagent-spawn-in-process	0.1.0-rc.5
dsh-llm	0.1.0-rc.5
dsh-llm-deepseek	0.1.0-rc.5
dsh-workflow	0.1.0-rc.5
dsh-agent	0.1.0-rc.5
dsh-agent-loop	0.1.0-rc.5

环境:

• Node.js v26.0.0
• macOS 15.7.8(Build 24G824)
• 模型 provider deepseek-official,模型目录 deepseek-v4-flash / deepseek-v4-pro

[DRAG0NM]

已定位根因：subagent 显式指定的模型不生效：workflow 里 agent(prompt, { model: "deepseek-v4-flash" }) 显式指定 flash，实际所有 LLM 调用都是父/默认模型（pro）。根因是模型选择层（selectionFor）完全忽略 AgentOptions.model：`select… 完整源码定位与修复方案见 #1105 。

[weijiafu14]

如果现在需要“子代理明确指定 flash，不能被父 Agent 的 pro 静默覆盖”，可以直接换一条已经跑通的入口：用 pi2dsh 挂载 Pi 社区的 @tintinweb/pi-subagents。

dsh plugin --profile web add pi2dsh@0.11.0
dsh plugin --profile web add @tintinweb/pi-subagents

调用时把 provider/model 钉在同一个参数里：

Agent({
  subagent_type: "Explore",
  prompt: "...",
  model: "deepseek-official/deepseek-v4-flash",
  run_in_background: false
})

也可以写在 .pi/agents/explore.md 的 frontmatter。pi2dsh 会按这个 provider/model 创建真实 DSH child session，不经过本帖会把 AgentOptions.model 覆盖回默认值的 workflow selection 路径。父子使用不同模型的真实 DSH loop 已验证，不只是 schema 能接收字段。