运行在 Pi CLI 中的多人 Agent 群聊工具。
多个用户可以带着各自的 Pi Session 加入同一个群组。在保留本地代码和工作环境的同时，用户可以把任务交给群里的其他用户或 Agent 接力完成。
群聊中的 @Agent 消息会发送到目标 Pi Session，Agent 的回答会回到群聊。普通对话、任务和 Agent 回复都公开显示，参与者可以看到完整的协作过程。
当前发行版是 v0.1.0。阶段 0～16A 已完成；真实设备局域网验收正在按 Roadmap 推进。
现在可以：
- Linux x64、macOS Apple Silicon 和 macOS Intel
- 同一台设备或同一个普通 IPv4 网络
- Pi Agent 和纯文本群聊
- 人与人、人与 Agent、Agent 与 Agent 通信
- mDNS 附近发现；发现失败时可粘贴完整群组加入信息
- 短暂离线、Session 重开或网络变化后的长期成员恢复
Pi Comms 是 Pi Extension。先安装 Pi CLI，再安装本项目。
要求：macOS 或 Ubuntu/Linux、Node.js 22.19+ 且低于 23、npm 和 git。
先确认 Node.js 和 npm：
node -v
npm -vmacOS 上，已有 Node.js 22 时，最简单是直接用 npm 安装 Pi：
npm install -g --ignore-scripts @earendil-works/pi-coding-agentUbuntu 上，可以先安装 Node.js 22，再安装 Pi：
sudo apt-get update
sudo apt-get install -y curl git build-essential python3
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm install -g --ignore-scripts @earendil-works/pi-coding-agentPi 官方也提供 Linux 和 macOS 通用安装脚本：
curl -fsSL https://pi.dev/install.sh | sh安装后确认 Pi 能启动：
pi --versionPi 的官方安装文档见 https://pi.dev/docs/latest/quickstart。
安装最新可用版：
pi install https://github.com/LetItBe12345/pi-comms这个命令跟随 GitHub 仓库默认分支。以后更新到最新可用版：
pi update --extensions如果要固定到当前已发布版本 v0.1.0：
pi install git:github.com/LetItBe12345/pi-comms@v0.1.0固定版本不会被 pi update --extensions 移到新 Tag。升级固定版本时，需要重新执行带新 Tag 的 pi install 命令。
Pi 会从 GitHub 安装 Extension 和运行依赖。本机群聊服务会在首次使用时自动启动，不需要手动运行。
启动 Pi：
pi进入群聊：
/comms
首次进入：
- 设置用户名称和 Agent 名称。
- 创建群组，或者从“我的群组”“已加入”“附近群组”中选择。
- 输入普通消息并按 Enter 发送。
同一网络中的其他用户可以看到允许附近加入的群组。群组默认可以直接加入；群主也可以在创建时要求邀请码。首次加入后会作为长期成员自动恢复。
打开或关闭 VPN 不会改变群组。如果 VPN 禁止访问本地网络，需要在 VPN 设置中允许局域网访问。
向 Agent 发任务时，把 @Agent名称 放在消息开头：
@Alice-Pi 检查当前项目的 package.json
@用户名称：只做公开提醒。@Agent名称：公开显示消息，同时把任务注入目标 Pi Session。Ctrl+P：打开 Agent 权限和请求控制面板。Shift+Enter：换行。Esc：退出群聊，返回原 Pi 界面。
注意：/session 是 Pi 自带命令；Pi Comms 的入口是 /comms。
每个用户继续使用自己的电脑、代码库和 Pi Session。Pi Comms 负责把群聊中的公开任务发送给被 @ 的 Agent，并把结果带回群组。
小林：@API-Pi 请检查接口返回结构。
API-Pi：字段名不一致，建议统一为 traceId。
小周：@Web-Pi 按新的字段更新调用代码并运行测试。
代码和工作环境不需要集中到同一台设备。群组成员只会收到群聊中公开发送的内容。
完整的多用户、私有代码库协作示例见协作 Demo。
- 在真实 Linux 和 macOS 设备间完成局域网验收。
- 根据真实网络测试改进附近群组发现、网络切换和自动重连。
- 支持 Windows，并补齐 Windows CI 和真实设备验收。
Pi Session A Extension ─┐
├── loopback TCP ── Local Broker ── SQLite
Pi Session B Extension ─┘
- TypeScript
- Node.js 22
- Pi Extension
- TCP IPv4（默认
127.0.0.1:43127） - SQLite
- Vitest
npm ci
npm run check
npm run broker准备三台真实设备的引导式验收：
npm run accept:lan -- --role A