传统模式：信息沿层级单向流动。coms / coms-net 让两个 Agent 成为平等的对话者——信息双向流动，最好的想法胜出，无关来自哪个 Agent。
子Agent、调度队列、链式编排——信息都是单向流动。对等通信翻转了这个模式：prompt → response → prompt → response，两个 Agent 是平等关系，不是父子。
生产环境 Agent 在服务器，开发 Agent 在笔记本。生产侧保持数据脱敏，仍然回答开发侧的问题——真正的工程协作，零数据泄露。
同一个池子里跑 claude-opus、gpt-5.5、deepseek——每个模型的 RL 训练不同，组合起来能捕获单个模型遗漏的问题。
每个 Agent 只关注自己的领域，而不是一个臃肿的 Agent 同时处理所有问题。聚焦 = 高性能，上下文越杂、错误率越高。
它只是一个 Agent + 扩展。需要层级时可以组合回编排器模式，不需要时保持扁平。灵活适配，不强制架构。
基于 Unix Socket / Windows 命名管道，同一台机器上的 Agent 直接对话，零依赖外部服务。
基于 HTTP + SSE 中心服务器，Agent 可分布在不同机器、LAN 或远程 URL，通过共享 Hub 中转消息。
整个通信面的工具只有四个：发现同伴、发送消息、非阻塞查询、阻塞等待。三种使用风格——即发即忘、同步等待、异步轮询——全部由同一组原语派生。
① A 调用 coms_send → ② B 收到 prompt 自动触发一个 turn，最终回复自动打包 → ③ A 用 coms_await 或 coms_get 获取结果
| 维度 | coms 本地 | coms-net 网络 |
|---|---|---|
| 传输层 | Unix Socket / Windows 命名管道 | HTTP + Server-Sent Events |
| 作用范围 | 同一台机器 | 同机 / LAN / 远程 URL |
| 发现机制 | 文件注册表 ~/.pi/coms/projects/ |
共享 Hub ~/.pi/coms-net/projects/ |
| 服务器 | 无 — Agent 直接监听 | bun scripts/coms-net-server.ts |
| 工具前缀 | coms_* |
coms_net_* |
| 认证 | OS 文件权限 | PI_COMS_NET_AUTH_TOKEN |
| UI | 编辑器上方实时 Agent 池面板 | |
每个消息信封携带 hops 计数，默认 MAX_HOPS=5，可通过 PI_COMS_MAX_HOPS / PI_COMS_NET_MAX_HOPS 配置。防止 A→B→A→B 无限转发。
每次 send/receive 记录 msg_id、sender、hops（不含消息内容）到 coms-log / coms-net-log，可追溯不可窥探。
coms 每次 list 时探测失联 socket 并清理僵尸 PID；coms-net 每 10s 心跳，未响应标记 stale/offline。
Hub 默认绑定 127.0.0.1，拒绝绑定其他地址——除非显式设置 PI_COMS_NET_AUTH_TOKEN。LAN/远程模式必须配置认证。
除了 Agent 通信，pi-vs-claude-code 还提供 17 个扩展，覆盖 UI 定制、多 Agent 编排、安全审计等场景。所有扩展可自由叠加组合。