核心用法
AgentRelay 是一套专为 Agent 间通信设计的可靠传输协议，主要解决 sessions_send 在大于 30 字符负载下的超时问题。其工作流程为：发送方将完整数据写入共享 JSON 文件，生成包含文件指针的短 CSV 消息（如 REQ,r1_r,s/r1_r.json,,），通过 sessions_send 传输；接收方解析 CSV、读取文件内容、执行任务后，通过 ack 命令生成带 Secret Code 的确认消息返回。核心命令包括 receive（解析消息并读取文件）、update（更新共享文件内容）、ack（生成 ACK 确认）。
显著优点
1. 突破传输限制：使用文件中转规避 sessions_send 的字符数限制，支持任意大小的 payload 传输
2. 可靠性保障：通过 6 位随机 Secret Code 验证机制，确保接收方确实读取了文件而非仅转发消息
3. 安全特性：支持 SHA-256 完整性校验、可选 burn-on-read 阅后即焚、24 小时 TTL 自动清理
4. 协议清晰：CSV 格式简洁明确，带 AgentRelay: 前缀便于 LLM 快速识别触发
5. 可观测性：完整的交易日志与注册表机制，便于调试和审计
潜在缺点与局限性
1. 基础设施依赖：依赖共享文件系统，分布式部署需额外配置存储同步
2. 延迟增加：相比直接传输增加文件读写开销，不适合高频小数据场景
3. 复杂度提升：多命令交互流程对开发者理解成本较高，调试链路变长
4. 安全边界：Secret Code 为 6 位纯字母数字，暴力破解理论可行，高敏感场景需额外加密层
5. 版本兼容性：v2.0.0 与早期版本可能存在协议差异，升级需注意兼容性
适合人群
- 开发多 Agent 协作系统的工程师
- 需要传输大体积结构化数据（如报告、分析结果、长文本）的场景
- 对传输可靠性有要求的生产环境（而非原型验证）
- 熟悉 Python 及命令行工具的技术团队
常规风险
- 文件残留风险：若 receiver 异常崩溃未正常 ACK，文件可能滞留至 TTL 到期
- Secret 泄露风险：CSV 消息中的 Secret 若被中间节点截获，可被伪造 ACK
- 路径遍历风险：需确保
ptr参数严格校验，防止../等路径逃逸攻击 - 存储配额风险：高频使用可能快速消耗共享存储空间，需监控清理策略