DeepSeek Harness 的 Agent Teams 模块允许构建协作智能体,但直接控制每个队员使用的 Provider、Model 和推理强度通常需要在代码中配置。dsh-agent-team-model 插件提供了一套可视化配置方案。它通过界面让开发者按默认规则或队员名指定模型参数,并在当前会话中查看每个队员实际挂载的路由。需要明确的是,该插件只负责配置队员的路由,队员本身由 DeepSeek Harness 官方的实验性 Agent Teams 层提供。
核心功能¶
- 可视化配置:在设置页或输入框旁的队员按钮中配置默认队员路由。
- 规则覆盖:支持按
spawn_teammate的队员名进行精确覆盖,也可以配置全局默认规则。 - 实时状态:在当前对话中查看队长、队员列表、运行状态以及每个队员实际使用的路由。
- 推理强度控制:支持选择推理强度,或让模型使用自身默认值。
前置依赖¶
本插件不替代官方的 Agent Teams 层,必须安装以下依赖才能正常工作:
- DeepSeek Harness:已验证版本
0.1.5-alpha.2。 - 官方 Agent Teams 层:
@deepseek-ai/dsh-experimental-agent-team-profile。DSH 随附的 profile 默认不启用此功能,需显式添加。 - Web Profile:宿主半边需要注册
/agent-team-model/api,且该 profile 必须提供webServer与webRuntime。Headless / SDK / ACP profile 无法激活本插件。
安装与启用¶
安装前请确保上述依赖已就绪。
# 1. 安装官方 Agent Teams 层(必须)
dsh plugin --profile web add @deepseek-ai/dsh-experimental-agent-team-profile
# 2. 安装本插件
dsh plugin --profile web add github:XMeowchan/dsh-agent-team-model
安装完成后重启 DeepSeek Harness,刷新 Web 页面。配置文件默认保存在 $DSH_HOME/agent-team-model.json。
使用步骤¶
- 打开 设置 → 队员模型,或点击输入框旁的队员按钮。
- 打开启用开关。
- 选择默认 provider、model 和 reasoning effort。
- 如需特殊规则,添加队员名并选择单独路由。
- 之后创建的新队员会使用对应规则。
配置说明¶
配置保存在 $DSH_HOME/agent-team-model.json,支持以下字段:
{
"enabled": true,
"default": {
"provider": "deepseek-official",
"model": "deepseek-flash",
"reasoningEffort": "high"
},
"overrides": {
"researcher": {
"provider": "deepseek-official",
"model": "deepseek-flash"
}
}
}
enabled: false:完全继承队长路由。default:没有专门规则的队员使用的路由。overrides[队员名]:按队员名精确匹配。- 缺少 provider 或 model:不注入,继承队长。
注意事项¶
- 仅影响新队员:配置只对新生成的队员生效,已存在的队员不会热切换模型,需重新创建。
- 工具集不受影响:插件只改变 LLM 路由,队员的工具集仍跟随队长的 preset。
- 权限范围:配置接口仅接受 loopback 或宿主显式信任的 authority,为本地配置接口。
总结¶
该插件为 DeepSeek Harness 的 Agent Teams 提供了可视化的路由管理能力,解决了手动编写配置代码的繁琐问题。适合需要在 Agent Teams 中精细控制模型调用策略的开发者。