前言¶
在 DeepSeek Harness(DSH)裏開多個 agent 會話,指揮拆任務、執行寫代碼、人做驗收,流程上說得通,信息卻常散在各自聊天記錄裏:拍板結論淹沒在某條會話裏,任務要手動複製進執行會話,進度和角色也得靠翻記錄猜。協作臺(dsh-team-board)是維護者 Ray144165154 發佈的工作流類 DSH 插件,把「agent 登記任務與推進驗收、人負責派發與拍板」落到一塊結構化看板上,並用三個 agent 工具與頁面共用同一套數據。
這是什麼¶
dsh-team-board(包名 @local/dsh-team-board,當前資料中版本 0.3.3)是 DSH Desktop(Web UI profile)插件。裝好後側邊欄增加「協作臺」入口。看板狀態落在 $DSH_HOME 下的普通 JSON 文件(重置時可刪 ~/.dsh/team-board/board.json)。插件分 Host(index.js,規則與持久化)與 Client(client.js,側邊欄與主頁面 UI),無額外構建步驟與第三方依賴;Host 僅用 Node 內置模塊,設計上面向 macOS / Windows / Linux 的 DSH Desktop,資料寫明在 0.2.2-rc.1 上開發驗證,其它版本未測。
社區目錄頁:dsh-team-board。源碼與說明:GitHub · Ray144165154/dsh-team-board(目錄頁星標爲 0)。DSH 社區目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。
核心能力¶
下面按「人做什麼 / agent 做什麼」歸納,均來自倉庫 README。
任務卡與角色¶
每條任務帶 指揮 / 執行 / 驗收 三個角色字段、狀態膠囊(todo / doing / done)、進度如 0/3 與可點擊勾選的驗收清單。頁面可切換或新建項目,也可在頁面裏新建任務,不依賴 agent。
GO 派發¶
任務卡上點 GO,從已打開的 live 會話裏選一個目標;任務會以一條 user 消息推入該 agent 會話,狀態自動變爲 doing,並記錄派發目標。只有被 DSH 加載爲 live agent 的會話能接收派發;下拉會顯示會話標題與運行 / 空閒狀態,Agent Teams 隊友會話會標爲「隊友」,臨時 subagent 會話被過濾。
待拍板與人機傳話¶
執行或指揮 agent 卡住時可用工具拋出待拍板卡;只有人能在頁面填答案並提交(answerDecision 不暴露給 agent 工具)。提交後答案留在板上,並由 Host 自動作爲 user 消息投回提問的會話。頁面底部「傳話」框可把人的一句話直接發進所選 live 會話。
三個 agent 工具¶
裝好後以下工具出現在所有 agent 工具列表,無需額外配置;均返回 JSON。
| 工具 | 作用 |
|---|---|
collab_board_read |
讀整塊板;可選 projectId 只讀一個項目 |
collab_task_upsert |
新建或更新任務(省略 taskId 則新建,自動分配如 T-080 的 id) |
collab_decision_ask |
發一張待拍板卡;Host 會記下調用會話,人拍板後自動回投 |
拍板回答 deliberately 不走 agent 工具面,避免 agent 代答;回投由 Host 的 followup / steer 完成,投遞成功表示消息進入收件箱,不代表 agent 已處理完畢。
安裝與啓用¶
前提:DSH Desktop。資料要求升級到 v0.3 後需重啓一次 DSH 以重新加載 Host 投遞邏輯,僅刷新頁面不能換掉運行中的 Host。
官方 README 的安裝路徑是本地 bundle,而非目錄站一鍵命令。步驟如下。
-
將倉庫放到本機目錄(README 示例使用 clone;你也可用其它方式取得同一份源碼樹)。
-
在 DSH 裏對 agent 說明(把路徑換成你本機絕對路徑):
把 `/絕對路徑/dsh-team-board` 作爲 bundle 安裝到當前 profile。
內部會調用 plugin_manager install_bundle,把包 link 進當前 profile。
- 側邊欄出現「協作臺」後點入;若未出現,刷新一次頁面(新裝的 Client 模塊需重新加載)。
卸載:在插件頁移除 @local/dsh-team-board,或讓 agent 執行 plugin_manager remove_bundle。
安裝前建議自行閱讀倉庫源碼與許可證;插件以當前 DSH 進程權限運行,對本地 board.json 與 agent 會話有讀寫與投遞能力。
典型工作流¶
README 給出的協作順序可作復現參考:
- 指揮 agent 調用
collab_task_upsert建任務並寫入驗收項。 - 人在任務卡點 GO,選擇執行會話完成派發。
- 執行 agent
collab_board_read接單,用collab_task_upsert更新狀態與進度。 - 遇歧義時
collab_decision_ask建待拍板卡;人頁面提交拍板,答案自動進執行會話。 - 驗收項通過後
collab_task_upsert的doneChecks勾掉清單項。
新建任務示例載荷(摘自 README):
{
"title": "工作臺分析區顯示細菌計數圖",
"checks": ["圖能渲染", "空數據顯示佔位"],
"progressTotal": 2,
"commander": "claude",
"executor": "deepseek"
}
待拍板示例:
{ "title": "什麼時候數", "detail": "**AI 分析完成後自動數**,跟在分析任務裏,不加按鈕" }
頁面約每 6 秒輪詢狀態,切回窗口時立即刷新;派發與傳話前若會話列表變化,可點「刷新會話」。
適用場景與注意¶
更適合需要固定分工(指揮 / 執行 / 驗收)、多處會話並行、且希望人獨佔拍板通道的多 agent 工作流。不適合完全不打算在 DSH 裏維持 live 會話、或不願把任務狀態寫到本地 JSON 的場景。
資料註明:macOS 已實機驗證投遞;Windows / Linux 真機投遞在 README 中尚未實測,CI 在 ubuntu / macos / windows 上用 fake context 覆蓋 Host 與 Client 契約。Agent Teams 爲可選增強,無它時不顯示隊友會話。
結尾¶
協作臺把多 agent 協作從聊天裏抽成有角色、有狀態、有驗收清單的共享板,並用 GO 派發與拍板回投補上調度與決策的最後一公里。進一步瞭解可打開 SkillHub 目錄頁 與 GitHub 倉庫。