DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在構建複雜工作流時,往往需要多個智能體並行協作。dsh-agent-teams-meta 是一個獨立插件,它爲 DSH 提供了更健壯的 Agent 團隊管理能力,支持持久化團隊、動態路由、任務圖、私有信箱、代幣賬本以及 Web 側邊欄面板。
是什麼¶
該插件由 kaka-in-home 維護,旨在解決多智能體協作中的協調問題。它允許一個主導智能體將工作拆解給專門的成員,每個成員擁有獨立的模型路由、任務上下文和私有信箱,並在同一個持久化會話中保持工作狀態。
核心功能¶
- 並行成員與真實路由:可以爲成員指定不同的 Provider 和 Model。同一團隊內的不同成員可以使用不同的模型。
- 持久化任務協調:支持創建任務、指定所有者、定義依賴關係。成員只能領取符合資格的任務,任務狀態變更會被驗證並持久化。
- 私有持久化信箱:主導智能體與成員之間通過信箱交換消息,互不干擾。每個參與者只能看到自己的信箱內容。
- 實時模型切換:可以在運行時切換成員的模型路由,下次請求將使用新路由,而正在進行的請求保持原路由。
- 有用的失敗報告:成員請求失敗時,錯誤信息會作爲普通消息文本傳遞給主導智能體,不會消失或變得晦澀。
- 模型目錄與路由檢查:插件會生成當前 DSH 中配置的 Provider/Model 目錄。創建成員時會檢查路由有效性,防止使用未配置的模型。
- 按路由使用賬本:Token 使用量記錄基於請求開始時的路由,即使後續切換路由,賬本仍記錄初始路由的使用情況。
- Web 可視化:提供只讀側邊欄,展示團隊進度、成員、任務、路由和階段。
- 工具集:提供
teams_meta_*前綴的工具族,包括create,add_member,create_task,claim_task,send_message,route_switch,status,close,guide等。
安裝與啓用¶
通過 DSH 的插件命令安裝:
dsh plugin --profile web add dsh-agent-teams-meta
插件安裝後,可以通過 cordis.patch.yml 進行可選配置,自定義狀態目錄或路由標記:
- insert:
- id: agent-teams-meta
name: 'dsh-agent-teams-meta'
config:
stateDir: .dsh-agent-teams-meta
markerProvider: agent-teams-meta-route
典型用法¶
典型的協作流程如下:
- 創建團隊:定義團隊標題和目的。
- 添加成員:指定成員角色、負責內容、Provider 和 Model。
- 創建任務:定義具體任務並指定所有者。
- 發送指令:通過信箱發送消息,引導成員行動。
teams_meta_create(title="Release audit", purpose="Review the release before publishing")
teams_meta_add_member(name="Reviewer", role="Find regressions", provider="deepseek-official", model="deepseek-v4-flash")
teams_meta_create_task(title="Review routing", owner="Reviewer")
teams_meta_send_message(to="Reviewer", body="Claim the routing task and report material findings.")
運行要求與注意事項¶
- 環境要求:需要 Node.js
^22.19.0或>=24。需要 DeepSeek Harness 的 Web Profile (dsh web),且至少配置了一個 LLM Provider/Model。 - 數據存儲:所有數據存儲在工作區的
.dsh-agent-teams-meta/目錄下。插件不會存儲提示詞、模型響應、憑據或端點 URL。 - 版本說明:當前版本號爲 0.1.1(基於 package.json)。
總結¶
dsh-agent-teams-meta 爲 DSH 提供了從模擬聊天到真實工作流協作的進階能力。通過私有信箱、任務依賴管理和按路由的代幣追蹤,它能讓主導智能體更有效地組織團隊完成複雜任務。