Noelune/dsh-agent-relay
31最近提交 2026年8月16日
dsh-agent-relay DSH 插件
dsh-agent-relay 是一个轻量级消息中继总线，让同一台宿主机上的多个 AI Agent 之间能够进行点对点通信。它包含 HTTP Broker、DSH 原生 Cordis 插件、JS/Python 客户端和 CLI 工具，默认采用回环优先的安全架构和 HMAC-SHA256 加密验证。
如何安装 dsh-agent-relay DSH 插件
dsh plugin --profile web add dsh-agent-relay复制不会执行命令。安装 dsh-agent-relay DSH 插件前请核对仓库和版本。
dsh-agent-relay DSH 插件数据来源
dsh-agent-relay DSH 插件快照日期：2026年8月16日
discovered
dsh-agent-relay DSH 插件能做什么
- HMAC-SHA256 签名请求鉴权，含 300 秒时间戳重放防护和速率限制
- 默认绑定 127.0.0.1:19121 的回环优先架构，无需云端部署
- 零依赖 Broker，使用 SQLite 持久化（旧版 Node.js 自动回退 JSONL），消息保留 7 天 TTL
- DSH 一级 Cordis 插件，暴露五个模型工具：agent_relay_send、agent_relay_status、agent_relay_history、agent_relay_peers、agent_relay_retry
- 基于游标的增量轮询与租约确认，指数退避重试（2s/4s/8s），基于 UUID 的幂等去重
- 隐私优先设计：消息体不会写入应用日志或遥测数据
dsh-agent-relay DSH 插件适合哪些场景
- Agent 间发起代码评审请求（如 DSH 请求 Claude Code 审查代码片段）
- 同一台机器上多个 Agent 之间的事实交叉验证
- 协作任务分发：协调 Agent 将子任务委托给专门 Agent
- 构建本地 Agent 舰队，无需外部网络依赖即可共享上下文和结果
dsh-agent-relay DSH 插件适合谁
- 在同一台宿主机上运行多个 AI Agent（DSH、Codex、Claude Code、Hermes）的开发者
- 希望通过插件系统实现 Agent 间通信的 DeepSeek Harness 用户
- 注重安全与隐私的本地多 Agent 系统研究人员和工程师
dsh-agent-relay DSH 插件的限制
- Broker、CLI 和 DSH 插件需要 Node.js 20+；推荐 Node.js 22.5+ 以使用原生 SQLite
- 默认回环绑定意味着 Agent 必须位于同一台机器上；远程部署需要显式配置 TLS，但 README 不推荐
- 消息仅保留 7 天 TTL，过期自动删除
- 社区维护，针对 dsh 0.1.0-rc.6 测试；不保证与新版兼容
dsh-agent-relay DSH 插件的仓库 README 摘录
以下文字摘自 dsh-agent-relay DSH 插件的上游仓库 Noelune/dsh-agent-relay 的 README，版权归原作者，仅作引用。
### *Local Multi-Agent Collaboration Relay for DeepSeek Harness & Local Fleets* *DeepSeek Harness 本地多 Agent 轻量级通信中继总线 — 基于 HMAC-SHA256 鉴权与 Loopback 优先架构的安全消息路由组件* [](https://www.npmjs.com/package/dsh-agent-relay) [](LICENSE) [](#) [](#) [](#) [产品定位与设计动机](#-产品定位与设计动机) • [核心技术特性](#-核心技术特性) • [系统架构与流程](#-系统架构与工作流) • [Agent 全流程自动部署](#-agent-全流程自动部署流程) • [Wire Protocol 规范](#-wire-protocol-v10-规范) </div> --- ## 📌 产品定位与设计动机 现有的 Agent 框架多数专注于单体 Agent 内部的推理链条与工具调用（Task Execution），但缺乏标准化的 Agent 间对等通信机制（Peer-to-Peer Inter-Agent Communication）。当在同一宿主机上并行运行 `dsh`、`Codex`、`Claude Code` 与 `Hermes` 等多个独立 Agent 时，代理之间无法直接发起代码评审（Code Review）、事实交叉验证或协作任务分发。 **`dsh-agent-relay` 旨在填补这一架构空白**：它是一个完全解耦、轻量且自建的 Agent 通信总线（Communication Bus
阅读完整 README仓库许可: MIT
dsh-agent-relay DSH 插件常见问题
如何安装 dsh-agent-relay？
在终端中运行 `dsh plugin --profile web add dsh-agent-relay` 即可安装。安装后，下一次 DSH 会话会自动执行 `docs/AGENT-DEPLOY.md` 中描述的自主部署流程，包括生成 HMAC 密钥、启动 Broker 以及为各 Agent 配置环境变量。
默认端口和绑定是什么？
Broker 默认绑定到 `127.0.0.1:19121`（仅回环地址）。这是出于安全考虑，将流量限制在本地，避免暴露到外部网络。你可以通过配置文件修改端口和绑定，但 README 强烈建议不要在没有 TLS 的情况下将 Broker 暴露在公网。
Agent 如何向 Broker 进行身份验证？
每个非 GET / 请求必须包含三个 HTTP 头：`X-Relay-Agent`（Agent 名称）、`X-Relay-Timestamp`（Unix 纪元秒数）和 `X-Relay-Signature`（HMAC-SHA256 十六进制摘要）。签名计算方法为：方法 + 换行 + 路径+查询参数 + 换行 + 时间戳 + 换行 + 请求体，然后使用共享密钥进行 HMAC-SHA256。Broker 会验证签名，检查时间戳是否在 300 秒内，并执行速率限制。
能否与使用 Python 编写的 Agent 一起使用？
可以。仓库在 `adapters/hermes/` 下提供了纯 Python 标准库的客户端适配器。你也可以使用 CLI 工具（`adapters/cli/relay.mjs`）通过子进程发送和接收消息，Wire Protocol v1.0 是语言无关的。
如果 Broker 崩溃或消息丢失怎么办？
消息会持久化到 SQLite（或 JSONL 回退），保留 7 天 TTL。Broker 采用基于游标的增量轮询和租约确认机制来确保可靠投递。如果失败，客户端会以指数退避（2s、4s、8s）重试。消息通过 UUID 实现幂等，重复消息会被自动丢弃。