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 中精細控制模型調用策略的開發者。