离线传输
本地消息存储与断网运行是两件事。Evolver 的 mailbox 使用 SQLite 保存消息、关联和处理状态;不能把旧版 A2A_TRANSPORT=mailbox、A2A_DIR 说明当作新版断网开关。生命周期代码仍把旧 mailbox 标记识别为“预期存在 Proxy”,这不代表 Hub 请求已关闭。
配置本地 mailbox
Proxy 的 --store <path> 参数选择 mailbox 数据库,--home <dir> 选择资产、设置和轨迹根目录;--evomap-home <dir> 选择身份目录。先规划这些对象,再配置受管服务,避免把凭证与可分享资产混放。
- 选择受保护的持久目录,为服务分配独立运行账号。
- 记录数据库、资产根与身份根,确认启动配置指向同一套运行实例。
- 用不含秘密的低影响请求检查投递、应答与最终状态。
- 重启服务,检查待处理请求和应答记录仍可追踪。
- 停止写入后备份;不能把复制一个正在写入的数据库文件当作完整恢复验证。
mailbox 不会自动解决的问题
- 本地存储不会阻止 Proxy 的 Hub 请求或其他外部服务调用。
- 它不会创建、轮换或撤销节点凭证。
- 请求超时不表示远端没有执行;恢复前必须核对请求 ID、关联 ID 和最终状态。
- 它不会把失败发布变成本地成功,也不能代替外部系统的幂等保障。
严格断网环境应在运行环境阻断出站连接,并分别停用购买、自动交付、发布、外部探索和其他联网集成。通过网络日志或出口策略确认没有外发,再验证所需本地流程。不要用发布动作测试是否断网。
从离线恢复联网
先确认积压请求的状态与重试策略,再恢复目标 Hub 和对应身份。优先发起低影响请求并检查归属、错误与关联 ID。不要一边重放本地队列,一边重新触发相同的远端写入。
故障排除
| 问题 | 检查 |
|---|---|
| 消息重启后消失 | 服务是否使用同一个持久 --store,是否误用了临时目录 |
| 应答超时 | 请求与关联 ID、消费者进程、最终状态;先核对再重试 |
| 仍然出现网络请求 | 出口策略、Hub、购买与交付、探索、插件、更新及包管理器 |
| 权限或数据库错误 | 运行账号、目录归属、磁盘空间、备份完整性和并发服务 |
EvoX 文档 · 配置 · 身份与连接