前言¶

DeepSeek Harness（DSH）採用插件化架構。在多智能體協作中，獨立窗口間的任務流轉和狀態追蹤容易產生混亂。dsh-flat-teams 是一個工作流插件，它爲 DSH 提供了無隊長的扁平團隊能力，支持跨窗口派發結構化任務，並提供記錄員服務和 Web 看板。

這是什麼¶

dsh-flat-teams：Leaderless flat agent teams for DeepSeek Harness。它通過 team_create/team_join/team_leave/team_roster 等工具管理扁平團隊，利用 task_dispatch 進行結構化任務派發與狀態機管理，內置記錄員服務維護 progress.json，並提供 Web 看板用於查看主表和二級表。

• 維護者：whateverboy2333
• 許可證：MIT
• 所屬分類：工作流

核心功能¶

扁平團隊管理¶

插件提供基礎的團隊管理能力：
* team_create：建隊，可預置成員規格。
* team_join：已有窗口自注冊加入。
* team_leave：退出團隊。
* team_roster：查看花名冊（成員/領域/在線狀態）。

結構化任務派發¶

• task_dispatch：按成員名或負責領域派活。
• 狀態機：任務狀態流轉爲 pending → delivered → claimed → in_progress → completed | failed | cancelled。
• 投遞機制：任務先落盤並寫入收件成員郵箱，再盡力實時喚醒。離線投遞的任務會停在 delivered 狀態，留存在郵箱中。

記錄員服務與 Web 看板¶

• 記錄員：訂閱事件流維護 progress.json，可隨時從 events.jsonl 重建。
• Web 看板：安裝到 web profile 後，瀏覽器右上角出現”團隊看板”浮層。提供主表（成員數/在線數/進行中數）和二級表（花名冊/任務看板/進展時間線）。
• 查詢接口：Web 看板通過 GET /plugins/flat-teams/state 獲取數據（5s 輪詢）。

安裝與啓用¶

1. 安裝插件：
   使用官方推薦命令安裝：

    dsh plugin --profile <name> add dsh-flat-teams

或使用 git 形式：

    dsh plugin --profile <name> add github:whateverboy2333/dsh-flat-teams

*注：本地路徑形式用於開發調試。*

2. 重啓 Profile：
   安裝後必須重啓該 profile 才能生效。

3. 驗證安裝：
   通過配置檢查插件是否加載成功：

    dsh --profile <profile> --dump-config

組合樹中應出現 `flat-teams` 行。

工具速查¶

注意事項與限制¶

1. 運行環境：

   • 需要 DSH 0.1.0-rc.6 或更高版本。
   • 需要 Node 22.19 或 Node 24+。

2. 進程限制：

   • 僅同進程跨會話：所有成員窗口必須在同一個 DSH 進程內。
   • 跨工作區：支持同進程內跨工作區。

3. 狀態持久化：

   • 跨重啓成員窗口不自動復活：編程創建的成員窗口由插件 fiber 持有，進程退出或插件卸載即銷燬。窗口需重新創建。
   • 離線投遞無自動重投：目標離線且冷恢復失敗時，任務停留在 delivered 狀態，需上線後手動觸達。
   • 取消不撤回：task_cancel 只遷移狀態，已投遞到接收方窗口的消息不會被撤回。

4. 權限與規則：

   • area 不強制獨佔：area 僅做路由參考，允許多成員，派發時必須指明成員名。
   • 權限強制：取消僅限派發方；認領/完成僅限指定接收成員。

5. 數據目錄：

   • 團隊狀態存於 DSH_HOME 級，路徑爲 <DSH_HOME>/flat-teams/<teamId>/，包含 team.json、tasks/、events.jsonl、inbox/、progress.json。

短結尾¶

dsh-flat-teams 爲 DSH 用戶提供了輕量級的扁平團隊協作方案，通過結構化任務派發和記錄員服務解決了多窗口協作中的狀態同步問題。適合需要在單一進程內進行多 Agent 協作的開發者。

生態背景：DSH 理念是「一切皆插件」；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

鏈接：
* 插件目錄
* GitHub 倉庫