dsh-agent-relay

多 Agent 协作中继（DeepSeek Harness 插件）：让本机各 Agent（dsh / Codex / Claude / Hermes / OpenClaw…）经一个轻量、HMAC 认证的 broker 互相收发消息。默认单机回环、零第三方依赖、5 分钟跑通闭环。

为什么需要它

Agent 框架给每个 Agent 一张"嘴"，却没有"对讲机"。dsh、Codex、Claude、Hermes 共处一台机器时，彼此之间没有互发消息的通道——除非你自己搭。dsh-agent-relay 就是这条通道：一个完整可部署的 starter-kit（broker + dsh 插件 + CLI 客户端 + Python 客户端 + setup 脚本），任何人都能在几分钟内部署。

• 不是编排引擎：不管 workflow/DAG/调度，只负责"把消息送到"。
• 不是记忆系统：不落库消息内容（除未读排队外）。共享记忆请用 unified-agent-memory。
• 不是聊天服务器：没有房间概念，只有在线/离线心跳。

特性

• 协议先行：一份版本化 wire protocol（docs/PROTOCOL.md），所有适配器（JS 插件 / JS CLI / Python 客户端）按同一协议实现，天然互通。
• 默认单机、零配置：broker 默认监听 127.0.0.1:19121，无需服务器 / TLS / 云。
• HMAC-SHA256 认证：时间戳防重放、连续失败 5 次锁定 5 分钟、按 IP 限流。
• 可靠投递：增量轮询游标、7 天 TTL、JSONL 落盘重启不丢、2/4/8s 退避重试、消息 id 幂等（发送端重试 + 接收端去重）。
• dsh 一等公民：cordis 插件注册 relay_send / relay_recv / relay_peers / relay_history 模型工具，另附可选侧边栏状态面板。
• 隐私设计：broker 与插件只记 id 与事件，不记消息内容。
• 分布式（可选进阶）：一台 broker、多台机器，文档强制要求 TLS。

快速开始（5 步，单机）

# 1. 克隆
git clone https://github.com/Noelune/dsh-agent-relay.git && cd dsh-agent-relay
# 2. 生成配置与随机密钥
node setup/setup.js init
# 3. 启动 broker
node setup/setup.js start
# 4. 另开终端，接入两个 agent
export DSH_RELAY_SECRET=

node adapters/cli/relay.mjs register --agent alpha --secret $DSH_RELAY_SECRET
node adapters/cli/relay.mjs register --agent beta  --secret $DSH_RELAY_SECRET
# 5. 互发消息
node adapters/cli/relay.mjs send beta "hello from alpha" --agent alpha --secret $DSH_RELAY_SECRET
node adapters/cli/relay.mjs recv --agent beta --secret $DSH_RELAY_SECRET

装 dsh 插件（替代 CLI 接入）：