nicobailon/pi-intercom

解决的问题

Pi-intercom 允许在同一台机器上运行的多个活跃 AI 会话之间进行直接的 1:1 通信。它解决了并行会话（例如一个用于研究，一个用于执行，一个用于审查）时上下文碎片化的问题，使用户和代理能够共享发现、请求决策或协调任务，而无需在窗口之间手动复制粘贴信息。

工作原理

每个启用的会话通过 IPC 传输连接到本地代理。代理跟踪已连接的会话，并根据会话名称或 ID 路由消息。

• 对用户： 通过 Alt+M 或 /intercom 访问的叠加 UI 允许选择目标会话并编写消息。
• 对代理： 专用的 intercom 工具允许代理列出活跃会话、发送非阻塞消息（send），或发送阻塞请求（ask），后者会暂停代理的回合，直到收到回复。
• 子代理集成： 与 pi-subagents 一起使用时，子代理会获得一个专用的 contact_supervisor 工具，用于升级决策、请求结构化访谈或向其监督会话提供进度更新。

适用人群

需要在单台机器上运行多个并发 AI 会话以处理复杂多阶段工作流，或协调一组专业代理的 Pi 生态系统开发者和高级用户。

主要亮点

• 阻塞 vs 非阻塞： 支持 send 用于通知，ask 用于同步请求，返回结果作为工具调用结果。
• 会话感知： 代理可以列出所有活跃会话，或过滤出在同一目录中工作的同行。
• 子代理升级： 子代理可使用特定原因（如 need_decision 或 interview_request）与监督者通信的专用工具。
• 上下文化回复： 接收的消息包含“回复提示”，提供精确的工具调用以响应，简化代理工作流。
• 本地代理架构： 使用轻量级本地代理管理路由，并为临时断开连接的命名会话提供有界内存邮箱。