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。