核心用法
Pilot Protocol 是一款面向 AI Agent 设计的点对点（P2P）通信协议，通过 pilotctl 命令行工具实现 Agent 之间的安全互联。用户需先安装系统级二进制文件，随后通过 pilotctl register 在 Registry 服务器（34.71.57.205:9000）完成节点注册，获取唯一的 Agent ID（如 AGENT-7a3f...）。注册后，Agent 可通过 STUN Beacon（34.71.57.205:9001）实现 NAT 穿透，建立加密直连通道。
主要功能模块包括：
- Agent 发现与握手：基于 Registry 的分布式节点发现，支持
pilotctl trust 建立双向信任关系 - 安全消息传输：使用 X25519 密钥交换 + AES-256-GCM 端到端加密，消息存储于
~/.pilot/inbox/ - 文件传输：支持大文件分片传输，接收文件存放于
~/.pilot/received/ - Gateway 桥接：可选功能，通过
sudo pilotctl gateway 将 Pilot 网络桥接至标准 TCP/UDP 端口，实现与现有 IP 网络的互通 - Webhook 集成：支持将事件推送至用户配置的任意 HTTPS 端点，便于集成外部系统
显著优点
1. 原生 P2P 架构：无需中心化消息队列，Agent 间直接通信，降低单点故障风险
2. 强加密保障：采用现代加密标准（X25519、AES-256-GCM），满足高安全场景需求
3. NAT 穿透能力：内置 STUN/TURN 机制，解决内网 Agent 的互联互通难题
4. 极简依赖：仅依赖系统 pilotctl 二进制，无第三方库引入，依赖审计得分达 85
5. 开源透明：AGPL-3.0 许可，代码可审计，符合开源社区治理模式
潜在缺点与局限性
1. 网络依赖外部服务器：Registry 和 STUN 服务器为固定 IP（34.71.57.205），存在中心化依赖，若服务不可用将影响节点发现
2. Gateway 需 root 权限：桥接至标准端口（<1024）时必须使用 sudo，增加权限管理复杂度
3. Webhook 端点不可控：用户可配置任意 URL，存在数据外泄至不可信端点的风险
4. 项目成熟度不足：v1.0.3 处于早期阶段，GitHub 社区指标（star、贡献者数）待验证，长期维护存不确定性
5. 动态代码下载风险：文档推荐的 curl | sh 安装方式属于 L1 级别动态加载，无签名验证
适合的目标群体
- 多 Agent 协作开发者：需要构建分布式 AI 系统、工作流编排的工程师团队
- 边缘计算场景：需要在设备间安全传输数据、指令的 IoT/边缘 AI 项目
- 隐私敏感型应用：对通信加密有严格要求，不愿依赖云服务商消息队列的用户
- 开源技术探索者：愿意承担早期技术风险，参与社区共建的开发者
不建议用于：金融交易核心系统、医疗级敏感数据传输、无网络隔离的公共环境
使用风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| **供应链攻击** | `curl \| sh` 安装模式无法预审查脚本 | 先下载本地审查，等待签名版本 |
| **数据外泄** | Webhook 可配置至任意端点 | 严格审查 URL，使用 HTTPS，避免敏感数据 |
| **文件安全风险** | `~/.pilot/received/` 接收任意文件 | 定期扫描，隔离打开，限制目录权限 |
| **网络暴露** | 外部通信至 34.71.57.205:9000/9001 | 防火墙限流，监控出站连接 |
| **权限滥用** | Gateway sudo 可能扩大攻击面 | 非必要不启用，使用高位端口替代 |
| **项目可持续性** | T2 来源，维护状态待观察 | 关注 GitHub 动态，等待 v2.0+ 稳定版 |
综合来看，Pilot Protocol 代表了 Agent 互联协议的创新方向，但当前版本更适合技术验证和沙箱实验，关键业务场景建议等待社区验证成熟或自行托管 Registry 服务。