@dsh-external/dsh-subagent-model-picker
让主会话模型从已配置模型里自主选择子代理模型
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:cczzyy-cn/subagent-model-picker#a26ea20f9d76734d0b83d31a7b82cb8345b3f0baSubagent Model Picker 以 @dsh-external/dsh-subagent-model-picker 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
让主会话模型从「已配置模型」里自主选择子代理运行模型，并把选定路由通过 ctx.subagents 的
request.agentOptions.provider/model 显式覆盖到子代理上。同时提供一张插件配置卡片，
让你为每个 provider/model 维护能力描述，作为主模型自主选型的依据。
这是一个双面插件，由两个包共同完成：
| 包 | 面 | 作用 |
|---|---|---|
@dsh-external/dsh-subagent-model-picker | 宿主 | 注册设置命名空间 + list_subagent_models / subagent_model 工具 |
@dsh-external/dsh-client-ui-subagent-model-picker | 浏览器 | 「设置 → 插件 → 插件配置」里的 能力描述配置卡片 |
provider/model 填 capabilities
（如 qwen 的 27B·xxs量化·视觉·本地Ollama，新增描述：32K上下文，每秒50token）。保存后写入
settings.yaml 的 subagent-model-picker.descriptions。capabilityMap()，并在 list_subagent_models 里给每个路由贴上 [capabilities]。list_subagent_models() 看到带能力标签的「菜单」（无参 = 列出所有已配置 provider）。subagent_model(provider, model, …) 点单。execute 解析 provider、做 modelPool 白名单校验与目录匹配度，
组装 agentOptions = { provider, model, reasoningEffort? }，经 ctx.subagents 把子代理绑定到所选模型。关键：把
provider/model写进agentOptions从而覆盖父子代理的默认继承路由——子代理不会 沿袭父会话模型，而是运行在你显式指定的模型上。
@dsh-external/dsh-client-ui-subagent-model-picker 在「设置 → 插件 → 插件配置」注册一张
可收起的「子代理模型能力描述」卡：
remote.session.modelCatalog() 拉取可选模型，下拉选择具体 provider/model；subagent-model-picker 命名空间；@deepseek-ai/dsh-client-ui-primitives 与 --dsw-* 设计 token，外观与其它插件卡一致；settingsScope 与 remote.session 为嵌套注入（可选），且带 missingPrimitives 守卫：
宿主缺少所需 primitive 或服务时，卡片优雅降级，不崩溃。对应 settings.yaml：
subagent-model-picker:
descriptions:
- provider: deepseek-official
model: deepseek-v4-flash
capabilities: 文本·快速·低延迟
- provider: qwen
model: qwen3.8-27b-iq3xxs-vision:latest
capabilities: 27B·xxs量化·视觉·本地Ollama
list_subagent_models枚举当前部署「已配置」的 LLM provider 及其模型目录（带能力标签）。
deepseek-official、qwen 等）。provider：仅列出该 provider。ctx.llm.listProviders() + listConfigurableProviders() → listModels(pid)；
当 listModels 为空时，回退读取该 provider 在设置段声明的模型（declaredModels，
从 settingsNs/settingsPath 取），因此 qwen 这类「仅配置声明的本地 Ollama 路由」也会出现。[capabilities]，供主模型选型。subagent_model用主模型选定的 provider + model（可选 reasoning_effort）派生子代理。
subagentId）；run_in_background:false 前台等待结果。agentOptions: { provider, model } 覆盖子代理路由；省略时继承父会话路由。modelPool（白名单）非空时硬性校验，不在白名单的路由会被拒绝。strictCatalog 为 true 时拒绝不在广告目录里的 model。[capabilities: <描述>]，取自 subagent-model-picker.descriptions（经 capabilityMap()）。
无描述时该段为空，输出不变（向后兼容）。model 传裸 model id（provider 单独经 provider 传）；list_subagent_models 展示的
provider/model 仅作展示，勿整串填入 model。子代理模型默认继承父会话的 provider/model；本插件在委派请求里写入 agentOptions.provider/model
从而显式覆盖。续接时这些值由 dsh-subagent 的持久化描述符（agentProvider/agentModel）还原，
保持同一模型。
# 宿主插件（bundle，自动挂载）
dsh plugin --profile web add github:cczzyy-cn/subagent-model-picker#v0.3.2
# 浏览器配置卡片（普通依赖 + 需在 profile cordis.patch.yml 手动加一行 roster）
dsh plugin --profile web add github:cczzyy-cn/dsh-client-ui-subagent-model-picker#v0.1.8
profile cordis.patch.yml 追加：
- insert:
- id: client-subagent-model-picker
name: '@dsh-external/dsh-client-ui-subagent-model-picker'
重启 dsh web 生效。
| 键 | 类型 | 默认 | 说明 |
|---|---|---|---|
defaultProvider | string | 父会话 provider | 缺省 LLM provider 路由 |
subagentProvider | string | spawn | 子代理传输 provider（ctx.subagents.start 第一参数） |
strictCatalog | boolean | false | true 时拒绝不在广告目录中的 model |
maxDepth | number | 3 | 派生子代理的绝对深度上限 |
modelPool | array | [] | 可选 provider/model 白名单 |
# 宿主：编译 src → lib（需指向 dsh 源码 checkout）
DSH_CHECKOUT=/path/to/deepseek-harness bash scripts/build.sh
（浏览器卡片由 dsh-client-ui-subagent-model-picker 仓库用 harness 的 clientBundle/tsdown 构建。）
schemastery（纯 schema 构建库，用于声明 subagent-model-picker 设置命名空间的 schema）。
该依赖由 DSH STORE 供应链复查把关。@deepseek-ai/dsh-llm、@deepseek-ai/dsh-subagent、@deepseek-ai/dsh-system-prompt、
@deepseek-ai/dsh-tools、cordis。这些由 DSH 宿主在运行时注入，不属于本插件安装的运行时依赖。本插件不直接做文件系统写、不 spawn 子进程、不对外发起网络请求。它仅通过 DSH 宿主的服务协作：
ctx.settings：读/写 subagent-model-picker 设置命名空间（读写由宿主设置服务代为落盘，插件自身不碰文件系统）；ctx.llm：只读调用 listProviders / listConfigurableProviders / listModels；ctx.subagents：经宿主 spawn 子代理（子代理的进程/网络由宿主管理）。说明：DSH STORE 扫描到的 “files permission signal” 是误报——源码中的
exec/spawn/access命中了工具参数名/上下文名（如execute/exec、access），并非真实的child_process/fs调用。
插件自身无出站网络。它枚举与派发所依赖的 LLM provider 由部署侧配置：
deepseek-official：DeepSeek 官方远程 API；qwen：本地 Ollama（apiKey: ollama / apiKeyEnv: qwen）。ctx.subagents 传输 provider → 报错 subagent_model: no ctx.subagents provider is registered；listModels(pid) 为空 → 回退 declaredModels（设置段声明模型）；仍为空则该项不列出（advisory）；modelPool 非空 → 白名单外的 provider/model 路由被 subagent_model 拒绝；strictCatalog 为 true → 不在广告目录中的 model 被拒绝（默认仅标记不拒绝）；list_subagent_models 异常只影响该次列举，不影响宿主主流程。engines.node >= 20（见 package.json）。peerDependencies 声明 @deepseek-ai/dsh-llm、@deepseek-ai/dsh-subagent、
@deepseek-ai/dsh-system-prompt、@deepseek-ai/dsh-tools、cordis 的兼容范围。在一次性临时 profile 中验证（宿主插件为 dsh.bundle，自动挂载）：
dsh plugin --profile tmp add github:cczzyy-cn/subagent-model-picker#v0.3.2
dsh profile start tmp & # 启动，确认加载到 `subagent-model-picker` bundle
dsh plugin --profile tmp rm @dsh-external/dsh-subagent-model-picker
dsh profile stop tmp # 卸载后 profile 干净退出
上述步骤已验证：安装后 dsh --dump-config 组合出 subagent-model-picker 行；启动无重复 entry id；移除后不再侵入 profile。
subagent_model 前台/后台返回都追加所选路由的能力描述 [capabilities: …]
（来自 subagent-model-picker.descriptions），便于主模型对账；无描述时输出不变。list_subagent_models 无参调用枚举所有 provider（此前被限制为默认 provider）；
与卡片下拉一致，qwen 等非默认 provider 也会列出并可被选择。declaredModels 兜底：listModels 为空时从设置段读取声明的模型，覆盖本地/网关路由。subagent-model-picker）与能力描述、list_subagent_models 读取能力标签。list_subagent_models / subagent_model）+ agentOptions 覆盖路由。list_subagent_models() 列出 deepseek-official（flash / v4-pro / vision-exp）与 qwen/qwen3.8-27b-iq3xxs-vision:latest，并带能力标签。subagent_model 前台/后台均能在指定模型（含非默认 qwen）上运行子代理并返回结果/可续接 id。settings.yaml；list_subagent_models 实时带出。