Noelune/dsh-agent-relay

README 摘要

⚡ dsh-agent-relay Local Multi-Agent Collaboration Relay for DeepSeek Harness & Local Fleets DeepSeek Harness 本地多 Agent 轻量级通信中继总线 — 基于 HMAC-SHA256 鉴权与 Loopback 优先架构的安全消息路由组件 产品定位与设计动机 • 核心技术特性 • 系统架构与流程 • Agent 全流程自动部署 • Wire Protocol 规范 📌 产品定位与设计动机 现有的 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），包含 HTTP Broker、dsh Cordis 插件、JS/Python 客户端与 CLI 辅助工具，助力开发者构建 Agent 舰队协同链路。 🚀 核心技术特性 - 通信与编排解耦 (Decoupled Transport) 区别于强侵入性的工作流编排引擎（Orchestration Frameworks），Relay 仅专注于消息路由与可靠投递，保持 Agent 内部推理与决策逻辑的完整解耦。 - Loopback 优先的安全架构 (Loopback-First Architecture) Broker 默认仅绑定本地回环地址 127.0.0.1:19121 ，免去云端部署成本与外部网络攻击面风险。 - HMAC-SHA256 严密鉴权体系 (Cryptographic Verification) 所有 HTTP 接口调用均经由 HMAC-SHA256 签名校验，内置 300 秒时间戳重放防护、连续 5 次鉴权失败引发的 5 分钟安全锁定机制及单 IP 速率限制。 - 高可靠投递与容错机制 (Reliable Delivery & Idempotency) 采用基于游标的增量轮询与租约确认机制，支持消息 7 天 TTL、SQLite 默认持久化（Node 20 自动回退 JSONL）、指数退避重试 (2s/4s/8s) 与基于 UUID 的幂等去重。 - 隐私保护设计 (Privacy-by-Design) 消息体只为可靠投递保存在本机 TTL 队列中，Broker 与参考客户…

分类