核心用法
AgentRelay 是一种智能体间可靠通信协议，专为解决 sessions_send 传输大负载时的超时问题而设计。其核心机制是通过共享文件存储实际内容，仅通过短消息传递文件指针引用，从而实现任意大小数据的可靠传输。
标准工作流程：
1. 发送方：将任务内容写入共享文件 → 生成包含文件指针的短消息（REQ 类型）→ 通过 sessions_send 发送
2. 接收方：识别 AgentRelay: 前缀 → 解析 CSV 消息获取文件指针 → 读取共享文件内容 → 执行任务 → 更新结果文件 → 发送 ACK 确认消息
3. 确认机制：接收方必须返回文件中的 6 位随机密钥（Secret Code），发送方验证通过后才视为通信成功
核心命令：
receive <csv_message>：解析消息并读取共享文件update <event_id> <json_updates>：更新共享文件内容ack <event_id> <secret>：生成 ACK 确认消息
显著优点
1. 突破传输限制：通过文件中转规避 sessions_send 约 30 字符的传输上限，支持任意大小的 JSON 数据
2. 可靠性保障：ACK/NACK 确认机制 + Secret Code 验证，确保消息被实际读取和处理
3. 安全特性：可选的阅后即焚（burn-on-read）、SHA-256 完整性校验、24 小时自动过期
4. 协议标准化：CSV 格式消息简洁明确，前缀触发机制便于 LLM 自动识别调用
5. 调试友好：内置 Ping 测试、多跳中继测试（5-hop/10-hop）及完整的交易日志
潜在缺点与局限性
1. 依赖共享文件系统：需要所有参与智能体访问同一文件系统，分布式部署场景受限
2. 延迟增加：相比直接传输增加文件读写 I/O，高频小消息场景效率较低
3. 垃圾文件风险：未启用 burn-on-read 时可能残留临时文件，需依赖 TTL 清理
4. 无原生加密：文件内容以明文 JSON 存储，依赖底层文件系统权限控制
5. 单点瓶颈：共享文件目录可能成为并发性能瓶颈
适合人群
- 多智能体协作系统开发者，尤其是需要传递复杂任务描述、大型数据分析结果或生成内容的场景
- 需要可靠消息确认机制的关键业务流程（如金融交易、医疗诊断辅助）
- 对消息传输大小有硬性限制但内容负载较大的应用（如图表数据、长文本生成）
常规风险
1. 文件权限泄露：共享目录权限配置不当可能导致未授权智能体读取敏感任务
2. Secret 暴力破解：6 位字母数字密钥理论上有 2176782336 种组合，但低熵场景存在风险
3. ACK 重放攻击：需确保 event_id 全局唯一，防止旧确认消息被恶意复用
4. 存储 DoS：恶意智能体可能大量创建文件耗尽存储空间，需配合配额限制
5. 路径遍历：文件指针解析需严格校验，防止 ../ 等恶意路径注入