DeepSeek Harness 插件介紹：dsh-agent-team

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在默認的會話模式下，Agent 的狀態往往隨會話結束而重置，缺乏長期記憶。對於需要跨會話延續、持久化協作的團隊工作流，需要一個獨立的解決方案。

contexera/dsh-agent-team 是爲此設計的插件。它爲 DSH 提供持久化的 Agent 團隊，成員在會話中斷、重啓或上下文滾動後，仍能保留其記憶、筆記和技能。該插件由 Contexera 維護，採用 MIT 許可證。

核心功能¶

該插件主要解決 Agent 的長期記憶與協作問題：

• 持久化成員：每個成員擁有獨立的記憶、筆記和技能，這些狀態在會話結束後依然存在。
• 工作空間與通道：通過 Workspace 組織不同項目的團隊，通過 Channel 路由工作職責。
• 任務線程：管理單一的工作進度線，包含 Claims、Agent 切換、人工接收和後續回覆。
• 上下文管理：支持滾動（Rollover）、檢查點（Checkpoint）和壓縮（Compact）三種模式，讓 Agent 自主管理上下文，無需人工干預。
• Web 客戶端：提供可視化的操作界面，用於創建工作空間、管理成員、發送消息和處理任務。
• Agent 工具集：爲 Agent 提供 team_inbox, team_thread, team_attention, team_message, team_dm, team_claim, team_view 共 7 個工具。

安裝與啓用¶

在啓用 Team 模式前，請確認 DeepSeek Harness 的版本。該插件認證版本爲 DSH 0.2.0-rc.2。如果使用 0.1.7-rc.2 版本，需安裝 @wowyuarm/dsh-agent-team 0.1.15；如果使用 0.2.0-rc.1 版本，需安裝 0.2.0。

以下是啓用插件的步驟：

1. 安裝插件
   使用 dsh 命令將插件安裝到 web 配置文件中。

    dsh plugin --profile web add @contexera/dsh-agent-team@0.2.3

2. 啓動 Web UI
   插件安裝後，啓動 DSH 的 Web 界面。

    dsh web

3. 驗證配置
   在啓動 UI 之前，可以通過 --dump-config 檢查配置文件中是否包含了 wowyuarm-agent-team-scope 和 wowyuarm-agent-team-client 等項。

    dsh --profile web --dump-config

典型用法¶

在瀏覽器中進入 DSH 導航欄的 Team mode，這是使用該插件的主要入口。典型的工作流如下：

1. 進入 Team 模式。
2. 選擇或創建一個 Workspace。
3. 在 Channels 中創建新頻道併發送第一條消息。
4. 在 Agents 中添加 Agent，並選擇其初始所屬的 Channel。

適用場景與注意事項¶

這是一個可選插件。安裝後，普通 DSH 會話的預設保持不變；只有在使用 Team 模式時，纔會加載 Team 相關功能。

• 版本兼容性：務必使用與 DSH 版本匹配的插件版本號，否則可能導致功能異常。
• 運行方式：不要從源代碼 checkout 後通過 pnpm dsh web 啓動，必須使用編譯後的 CLI 工具。
• 權限管理：默認的 team-member 預設會授予 managed Agent Sessions danger-full-access 權限，請在受信任的工作空間中創建 Agent。

總結¶

dsh-agent-team 將 Agent 從臨時的會話實例轉化爲持久的團隊成員，配合工作空間、通道和任務線程機制，適合需要長期協作和知識沉澱的場景。

• GitHub 倉庫
• 插件目錄頁