dsh-submodel-change

DeepSeek Harness 插件:当 AI 决定调用一个 subagent(子代理) 时,在弹窗里由你选择 这个子代理由哪个 provider/模型驱动,选好后该子代理(以及它嵌套派生的子代理) 就使用你选的模型运行,不再打扰你。

• 零依赖:不 import 任何 @deepseek-ai/* 包,无需构建,纯 JS (ESM)。
• 官方扩展点实现:利用 agent/request waterfall 的「替换 LlmCallConfig」能力, 这是 Harness 为拦截/改写模型路由设计的正式钩子,不 hack 任何内部实现。
• 只对 in-process subagent 生效(provider: spawn);其它 provider 的 child 事件带不到本进程,自然跳过,不影响任何原有功能。
• 默认 同一父会话的后续子代理复用第一次的选择(可配置为每次都问); 嵌套子代理自动继承父路由,不会连环弹窗。

---

行为预览

你在 GUI 里让 AI 做事,AI 判断需要派一个子代理时,会话里会弹出一张卡片:

子代理模型选择 这个子代理用哪个模型运行?

• deepseek / deepseek-chat
• deepseek / deepseek-reasoner
• openrouter / claude-3-5-sonnet (手动)
• 使用默认模型(跟随父级,不修改)

选完按回车,该子代理就用所选模型执行;卡片在子代理的第一次模型请求前出现, 子代理会等你的选择,不会先用错模型跑起来。

---

安装方式 A:自动安装脚本(推荐)

⚠️ 不要在 cordis.patch.yml 里用 name: 'file:///C:/.../index.mjs' 挂载。 Desktop 会把这种行判定为「未安装」,插件虽然加载了,但拿不到 userQuestions / llm / agents 服务,启动日志会显示 [submodel-change] 缺少 userQuestions/llm/agents 服务,已跳过, 弹窗永远不会出现。正确姿势是用 junction + 包名(token-stat 同款方案)。

1. 把整个 dsh-submodel-change 文件夹放到一个稳定的位置,例如: C:\Users\Jason\Desktop\dsh-better\dsh-submodel-change\

2. 在该目录下执行(自动创建 junction 并改写补丁文件,可重复执行):

   node tools/install.mjs
   

   脚本会:

   • 在 %APPDATA%\dsh-desktop\harness\profiles\web\node_modules\@jason666not\ 建立指向本项目的 junction(《已安装》判定通过);
   • 把 cordis.patch.yml 里该插件的 name 保证为包名 '@jason666not/dsh-submodel-change';
   • 从 profile 解析该包并打印 resolve OK 验证。

3. 完全重启 DSH Desktop(关闭窗口后重新打开,不是最小化),插件即生效。 启动日志里应出现 [submodel-change] 已加载: 子代理发起模型请求时弹窗选择模型, 且不再有 profile inconsistency ... which is not installed 警告。

4. 让 AI 做一件需要派子代理的事(或直接说“调用一个 subagent”),看到模型选择卡片即成功。

提示:如果补丁文件被别的工具重写过,重跑一次 node tools/install.mjs 即可, 脚本是幂等的。

安装方式 B:作为 bundle 安装(需要 dsh CLI)

在 dsh-submodel-change 的上一级目录执行:

dsh plugin --profile web add ./dsh-submodel-change

然后重启 DSH Desktop。卸载:dsh plugin --profile web remove dsh-submodel-change。

---

配置项

在补丁文件的插件行下加 config: 即可覆盖(以下为全部默认值):

- insert:
    - id: submodel-change
      name: '@jason666not/dsh-submodel-change'
      config:
        enabled: true          # 总开关
        askOncePerParent: true # 同一父会话的后续子代理复用第一次的选择;
                               #   设为 false 则每个子代理都重新弹窗
        allowDefault: true     # 选项里包含「使用默认模型(跟随父级,不修改)」
        extraModels: []        # 手动追加适配器目录未列出的模型路由,
                               #   格式 ['provider/model', ...]

示例:每次派子代理都问、并追加一个未登记的网关模型:

config:
  askOncePerParent: false
  extraModels: ['openrouter/deepseek-r1']

注:配置同样可以在 bundle 层 cordis.patch.yml(即本项目根目录那个)里写, 安装方式 B 会把它作为补丁层合并。

---

工作原理(简)

• 识别子代理:child session 的 header 带 origin: 'subagent' 与 parentSession; 只有这种 agent 的请求会被拦下,根会话自身的请求原样放行。
• 提问位置:agent/request waterfall 在子代理第一次发模型请求前触发,监听器 先取默认配置,再向实时根 agent(通过 userQuestions.ask)弹模型选择卡片—— ask 严格要求 agent 是实时 root,所以提问总发生在根会话,UI 卡片也渲染在根会话。
• 注入模型:用户选中的 { provider, model } 被写回该次 LlmCallConfig, 子代理随后以该路由发起请求,request/header 会如实记录这次路由变更。
• 复用与继承:同一 parent 的后续子代理复用 routeByParent 中的选择;嵌套子代理 由 Harness 用父路由合成子路由(resolveChildAgentOptions),自动继承,无需重复提问。
• 清理:subagent/end / agent/disposed 事件按 child 释放选择与提问标记, 避免内存泄漏。

目录

dsh-submodel-change/
├── index.mjs        # 插件本体(唯一需要挂载的文件)
├── package.json     # bundle 清单 + 包名解析
├── cordis.patch.yml # bundle 补丁层(方式 B 用)
├── tools/
│   └── install.mjs  # 安装脚本:建 junction + 改写 patch 为包名(方式 A)
└── README.md