[Bug Report] subagent 显式指定 model 被选择层覆盖：workflow agent(prompt, {model}) 的模型不生效

[DRAG0NM]

摘要

subagent 显式指定的模型不生效：workflow 里 agent(prompt, { model: "deepseek-v4-flash" }) 显式指定 flash，实际所有 LLM 调用都是父/默认模型（pro）。根因是模型选择层（selectionFor）完全忽略 AgentOptions.model：selection.current 只读"本进程选择 → 会话日志 → 默认模型"，子 agent 新会话无日志 → 落到默认（=settings 的 agent-default-model）；随后 installModelSelection 在 agent/request 瀑布后无条件覆盖为 selection.assembled——agent-loop 层用显式 model 算出的路由被选择层覆盖掉。发帖人"model 被传递且被校验、却未生效"的两组对照实验与此完全吻合。

复现步骤

1. 配置 agent-default-model: deepseek-v4-pro（settings.yaml），deepseek-official provider。
2. 在任意会话执行 workflow：const r = await agent("请只回复 OK。", { model: "deepseek-v4-flash" });
3. 查会话日志：zstd -dc "$DSH_SESSION_JSONL" | grep '"model"' | sort | uniq -c → 全部 deepseek-v4-pro，0 次 flash。
4. 对照：agent("OK", { model: "deepseek-v4-nonexistent-xyz" }) → 启动失败（model 被 resolveModelInfo 校验）——证明 model 字段确实传到了 agent 层，只是最终选择环节被覆盖。

社区已实测复现（rc.6，web profile）。子代理与 workflow 两条路径同受此缺陷影响（同走 selectionFor）。

根因（源码定位，rc.6）

1. 显式 model 在创建层正确传递 — @deepseek-ai/dsh-subagent/lib/index.js L779-780：agentModel = request.agentOptions?.model ?? parent.options.model → 子 Agent 的 options.model = "deepseek-v4-flash"（传递链完好，发帖人实验 2 印证）。

2. 选择层不读 AgentOptions — @deepseek-ai/dsh-host-apiproxy/lib/index.js selectionFor（L1750-1773）：

   get current() {
       if (picked !== void 0) return picked;
       const logged = agent.session.requestHeader()?.config;   // L1757
       if (logged === void 0) return defaults.defaultModelSelection();  // L1758
       ...
   }

   查找顺序只有 picked → 会话日志 → 默认模型；子 agent 新会话无 requestHeader → 落到 defaultModelSelection() = settings 的 agent-default-model（pro）——显式 AgentOptions.model 不在任何 tier 里。

3. request 瀑布后无条件覆盖 — @deepseek-ai/dsh-agent/lib/types/model-selection.js installModelSelection（L33-47）：agent/request 拦截 await next() 后把 provider/model 强制设为 selection.assembled（首次 assemble 时 current 的快照 = 默认 pro）——agent-loop 用 this.options.model（flash，agent-loop L674-677 route 构造）算出的配置被覆盖成 pro。

4. 与 [Bug Report] 子代理继承父代理的"创建时默认模型"而非"会话当前模型"，第三方 provider 会话中 subagent 必报 no API key for provider route "deepseek-official" #455（子代理BUG #117 子代理模型继承）的关系：?? 继承逻辑（L780）保证的是 AgentOptions 正确；但 api-proxy 选择层对"无日志的新会话"一律落到 default——显式 model 被无视是独立的缺陷面（继承与覆盖是同一选择层的两面）。

建议修复

方案 A（推荐）· selectionFor 增加 AgentOptions tier：current getter 在"日志"之后、"默认"之前读取 agent.options.provider/model（显式设置时优先于默认）——子 agent 显式 model 恢复生效；picked（UI 选择）仍为最高权重。改动小、不影响现有 UI 选择语义。

方案 B · 覆盖改为仅对显式 picked 生效：installModelSelection 仅在 selection 有显式选择时覆盖，否则透传 agent-loop 的 route（含 AgentOptions）。语义更彻底，但当前"选择层统一权威"的设计会被打破（UI 选择与 agent options 的取舍需重新定义），改动大。

影响

• workflow/子代理显式指定模型（成本控制、任务分工、模型切换）全部失效——用户以为在用 flash，实际一直在用 pro（成本翻倍）或反之；
• 与 [Bug Report] 子代理继承父代理的"创建时默认模型"而非"会话当前模型"，第三方 provider 会话中 subagent 必报 no API key for provider route "deepseek-official" #455 同一选择层缺陷域，但 [Bug Report] 子代理继承父代理的"创建时默认模型"而非"会话当前模型"，第三方 provider 会话中 subagent 必报 no API key for provider route "deepseek-official" #455 只覆盖"继承"现象；显式覆盖是更隐蔽的问题（不报错、静默用错模型）；
• 影响所有显式指定模型的 subagent/workflow 调用。

环境

• 源码定位：0.1.0-rc.6（npx 缓存安装包，Node v24.16.0，Windows 11）
• 原报告：[Bug]subagent 无法切换模型——workflow 的 `model` 覆盖被父 agent 模型覆盖 #1100（rc.6，web profile，deepseek-official）

验证材料

• 社区两组对照实验（flash 被 pro 覆盖；不存在的 model 被校验拒绝——证明传递链完整、断点在选择层）；
• rc.6 源码逐行核对：dsh-host-apiproxy/lib/index.js L1750-1773、dsh-agent/lib/types/model-selection.js L17-52、dsh-subagent/lib/index.js L779-780、dsh-agent-loop/lib/index.js L674-677；
• 机制推演：子 agent 新会话 → selection.current = default（pro）→ installModelSelection 覆盖 flash 路由。

---

First analysis of discussion #1100. Happy to open a PR with fix option A.

[weijiafu14]

这个问题有一条已经实测的替代路径：使用 Pi 社区的 @tintinweb/pi-subagents，其 Agent 参数与 agent frontmatter 都支持明确的 provider/model，pi2dsh 会把选择结果映射到真实 DSH child-agent route，而不是走这里会把 AgentOptions.model 覆盖掉的 workflow 选择路径。

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

调用示例：

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

也可以把模型固定在 .pi/agents/explore.md 的 frontmatter：

---
model: deepseek-official/deepseek-v4-flash
tools: read, grep, find
---

省略 model 时继承当前父模型；显式设置时按该 provider/model 创建子代理。不同父子模型的真实 DSH loop 已验证，不只是 schema 接受参数。项目： https://github.com/weijiafu14/pi2dsh

这不影响帖子里的根因判断，原生 selection tier 仍应修；它提供的是当前可运行、模型选择不被静默覆盖的子代理入口。