dsh-groupx: 將本地 GroupX 多智能體房間引入 DeepSeek Harness

前言¶

DeepSeek Harness (DSH) 的插件化設計允許開發者將不同功能模塊注入 Web 界面。在本地多智能體協作場景中，開發者通常需要維護獨立的房間和會話管理工具。dsh-groupx 插件解決了這一割裂問題，它將本地的 GroupX 多智能體房間橋接至 DSH Web 環境，使用戶能在 DSH 的統一界面中查看 Agent 狀態、共享時間線，並向 Agent 發送消息。

插件定位¶

該插件由 Harzva 維護，採用 MIT 許可證。它是一個獨立、非官方的 DSH 集成方案。DSH 負責宿主和 UI，GroupX 繼續保留對原生會話、SQLite 存儲、內存和路由的控制權。該插件不捆綁 GroupX 源碼，不上傳房間數據，也不重寫 Agent CLI 配置。

核心功能¶

DSH 原生標籤頁：在 DeepSeek Harness 的設置路徑 Settings → Plugins → GroupX 下提供原生標籤頁。
Loopback Host Bridge：提供默認 http://127.0.0.1:4310 的 Host bridge，僅支持 Loopback 連接。
會話與事件視圖：展示 Agent 名單、狀態、最近語義事件及當前回合摘要。
消息路由：支持通過 to[] 參數顯式指定單 Agent 或多 Agent 消息路由。
安全校驗：嚴格拒絕發送者僞造字段和非 Loopback 來源的連接。
離線容錯：當 GroupX 離線或版本不兼容時，DSH 仍可安全啓動。

安裝與啓用¶

啓動 GroupX：確保 Node.js 版本符合要求（>=24.14.1 <25），安裝並啓動 GroupX。
構建並打包插件：克隆倉庫、安裝依賴、檢查代碼並打包。
安裝到 DSH：使用 CLI 命令將打包後的 tgz 文件安裝到 Web Profile。

典型用法¶

啓動 GroupX：

    npm install --global @susyimes/groupx
    groupx start --no-open

構建 DSH 插件包：

    git clone https://github.com/Harzva/dsh-groupx.git
    cd dsh-groupx
    pnpm install --frozen-lockfile
    pnpm check
    pnpm run pack:dsh

安裝插件到 DSH Web Profile：

    dsh plugin --profile web add ./artifacts/harness-flow-dsh-groupx-0.1.0-alpha.0.tgz

（可選）配置不同的 GroupX 端口：

    $env:DSH_GROUPX_ORIGIN = 'http://127.0.0.1:5000'
    dsh web

注意事項與邊界¶

獨立與安全：這是獨立、非官方集成。協議和 DSH 離線安全切片已測試；實時瀏覽器 E2E 測試狀態爲 Open；SSE 恢復/取消/重啓功能爲 Planned。
連接限制：僅允許 Loopback 連接，拒絕 LAN、HTTPS、帶憑證及帶路徑的來源。
項目邊界：DSH Web 負責展示和交互，GroupX Broker 負責實際的消息轉發和會話管理。

通過該插件，開發者可以在 DSH 界面中直接管理本地多智能體協作，實現了工具鏈的統一。更多詳情與源碼請訪問 GitHub。