dsh-subagent-model

一个 DeepSeek Harness (DSH) 插件：注册 subagent_model 工具——在内置 subagent 工具基础上，把子代理的模型路由（provider / model / max_tokens）和上下文继承（fresh_context）都暴露为每次调用可选的参数。

fork 自官方 @deepseek-ai/dsh-tool-subagent，除这两组参数外行为与原版一致（后台策略、continuable 子会话、工具过滤、persona、深度限制全部保留）。

环境要求

• DeepSeek Harness >= 0.1.0-rc.6（已验证至 0.1.1-rc.2，Windows）
• Host 组合已加载 subagents 服务；fresh 模式需要 spawn 类 provider，默认继承模式需要 fork 类 provider（官方 base bundle 两者都带）

用法

挂载后模型多出一个 subagent_model 工具。不传任何可选参数时，子代理默认干净上下文（与内置 subagent 语义一致）；要基于当前对话续写，传 fresh_context: false——子代理以调用那一刻父会话最新完成轮次为种子（不是会话打开时的快照；正在进行的这一轮不含在内）。参数：

上下文模式与后台默认（backgroundMode: continuable 挂载时）：

backgroundMode: one-shot 挂载时两种模式都默认前台；run_in_background: true 走后台 job（job_output 收取）。

组合方式（最终路由优先级）：调用参数 > 插件 config 的 agentOptions > 父会话路由。未知 provider/model 在启动子代理之前快速失败，错误信息列出可用的 provider / 模型目录。

⚠️ 版本间默认值变更史：0.1.x 省略参数 = 干净上下文；0.2.0 改为默认继承（破坏性）；0.3.0 改回默认干净（破坏性，依据使用分布与成本不对称，见 ADR-0005）——继承用 fresh_context: false 或部署配置 defaultContext: inherit。另：provider 配置必须是 fresh 类 provider（如 spawn）——配成 fork 会在挂载时报错，继承通道用 inheritProvider。

安装

git clone https://github.com/Momojie-S/dsh-subagent-model.git
cd dsh-subagent-model
npm install          # prepare 脚本自动构建 lib/

profile 的 cordis.patch.yml 加一行（源码直连开发机形态）：

- insert:
    - id: subagent-model
      name: 'file:///D:/code/workspace/deepseek-harness-101/plugins/dsh-subagent-model/lib/index.js'
      config:
        provider: spawn              # fresh 模式的传输 provider（必须是干净上下文类，如 spawn）
        backgroundMode: continuable  # 后台策略（fresh 默认后台；继承默认前台）
        # inheritProvider: fork      # 继承模式的传输 provider，默认 fork
        # defaultContext: fresh      # 省略 fresh_context 时的模式，默认 fresh（同内置 subagent）

重启 DSH 生效。组合包安装形态：dsh plugin --profile web add github:Momojie-S/dsh-subagent-model。

配置

patch config 字段：

验证

重启后让模型做对照委派（或检查 verbose 日志确认工具注册）：

> 先在本对话约定一个暗号。然后：1) 用 subagent_model 不传 fresh_context 委派"本对话前面的暗号是什么"；2) 传 fresh_context: false 再委派一次同样的问题

默认（省略）的子代理应不知道暗号（干净上下文）；fresh_context: false 的子代理能答出暗号，且换一轮新对话内容后再 fork，子代理能看到新增内容——证明种子取的是调用时刻最新状态，不是会话打开时的。

设计取舍与实现细节见 docs/design/overview.md。