10 二开形态
Pi 正在变成基础设施:发行版 Fork、SDK 嵌入、聊天网关与编辑器协议接入
1. 这个方向的插件试图解决什么问题
Pi 核心的极简定位(pi-ai + pi-agent-core + pi-coding-agent + pi-tui)使它不只是一个终端工具,更成为一套可被二次打包和嵌入的 Agent 运行时底座。不同团队正在把它拆成发行版、桌面/Web 驾驶舱、移动端助手或即时通讯机器人。
单纯的插件已经不足以表达某些形态变化:当你需要内置 31 个 Rust 加速工具和调试器时,需要做 CLI 级 Fork;当你想通过 WhatsApp/Slack/Matrix 随时遥控编码会话时,需要用网关或 RPC 包装 Pi;当编辑器想以统一协议接入 Pi 时,则需要 ACP 适配器;而像 Po 套件则直接围绕 Pi 运行时重建了多包插件与 Web 驾驶舱体系。
2. 在 Pi 里怎么体现
这一方向超越了单个 ExtensionAPI,直接消费 Pi 的分层架构与外部协议:底层复用 @earendil-works/pi-agent-core、pi-ai 与 Pi Durable 持久会话协议;中层通过 Pi RPC 模式(如 pi-courier)或 ACP(Agent Client Protocol,如 pi-acp)对外暴露控制接口;上层则分化为开箱即用发行版(@oh-my-pi/pi-coding-agent)、多通道网关(OpenClaw)、移动端多人网页(pi-pocket)与模块化套件(@agimon-ai/po-*)。
延伸实测阅读
关于 Pi 1.0 引入的实验性长任务持久化底座 Pi Durable(支撑 pi-pocket 等上层多端应用)与版本演进时间线,可对照阅读:Pi Agent 1.0 与 1.1 深度解析 及博客观察 Pi 1.0 与 1.1:一个靠说「不」出名的工具,开始说「是」了。
涉及的 Pi 事件钩子与注册接口
3. 代表包与生态实例
下表包名均核实自 npm、GitHub 与 pi.dev/packages(核对日期 2026-11-22)。前 3 项已上线独立机制详评页,正文不展示容易过期的静态下载量快照。
| 包名 | 分发形态 | 主要作用 | 详情 / 源码 |
|---|---|---|---|
@oh-my-pi/pi-coding-agent | npm / 二进制(Pi 分叉发行版) | Stencil Labs(can1357)维护的 Pi 发行版 Fork(命令 omp),内置 Rust 核心、31 个工具、LSP、DAP 调试与 60+ 模型接入。 | |
openclaw | npm(独立多通道网关) | 开源多通道 AI 网关,可运行在本地设备并接入 20+ 聊天平台,底层以可插拔 Harness 形态集成 Pi 等编码代理。 | |
@agimon-ai/po-core | npm | AgiFlow Po 套件的共享运行时与核心服务契约层,与 @agimon-ai/po-web-dashboard、po-ui、po-logsink 等组成模块化驾驶舱生态。 | |
pi-acp | npm(独立 CLI / 应用) | Pi Coding Agent 的 ACP(Agent Client Protocol)适配器,用于把 Pi 接入支持 ACP 的编辑器与 IDE。 | |
gentle-pi | npm | 将 Pi 封装为带专注子代理、TDD 验证证据与原生审查的 ODD(Opinionated Driven Development)开发工作台。 | |
pi-pocket | npm(独立 CLI / 应用) | 基于 Pi Durable 构建的多人、移动端优先 Web 应用,支持在手机与本地设备间无缝接续持久会话。 | |
pi-courier | npm | 通过 Pi RPC 协议在 Matrix 聊天室中远程运行 Pi,完整支持斜杠命令、skills 与提示词。 | |
pi-chat | npm(独立 CLI / 应用) | 基于 pi-tui 与 Cloudflare Workers 构建的终端团队聊天客户端示例。 | |
4. 怎么装
bun install -g @oh-my-pi/pi-coding-agent - 方向 10 中的不少项目以独立运行的 CLI、网关服务、Web 应用或协议适配器形态分发,不通过 `pi install` 安装为单个普通扩展。
- 关于 oh-my-pi 包名:主流“全家桶”高配 Fork(can1357/oh-my-pi,CLI 命令为 omp)的 npm 包名为 @oh-my-pi/pi-coding-agent;npm 上另有一个同名为 oh-my-pi(acidsugarx/oh-my-pi,0.2.0)的社区编排扩展包,安装前注意核对命名空间。
- OpenClaw 是独立的多通道 AI 网关,内置了包括 Pi 运行时在内的多种 Agent Harness 集成,其 npm 下载量反映整个 OpenClaw 网关的分发量。
5. 和同类怎么选
| 项目 / 包名 | 二开形态 | 基于 Pi 的层级 | 适用场景 |
|---|---|---|---|
@oh-my-pi/pi-coding-agent (omp) | Batteries-included 发行版 Fork | Fork 自 Pi,内建 31 个工具、Rust 核心、LSP/DAP 与多记忆后端 | 想要开箱即用、不愿自己拼装十几个扩展的终端重度用户 |
openclaw | 多通道常驻 AI 网关 | 以 Pi 等 Agent 运行时作为执行后端,挂载 20+ 聊天平台与定时任务 | 把 Agent 变成挂在 Discord/Slack/Telegram/WhatsApp 里的常驻数字助理 |
@agimon-ai/po-core(Po 套件) | 可组合扩展基础设施 + Po Web 驾驶舱 | 提供独立 runtime 服务契约,保留 Pi 扩展兼容宿主并配套 po-web-dashboard 等 20+ 子包 | 基于标准化服务契约构建系列内部扩展或 Web 控制面 |
gentle-pi | ODD 开发规范套件包 | 基于 Pi 扩展体系封装子代理、TDD 证据与代码审查流水线 | 偏好 Opinionated Driven Development 工程流派的团队 |
pi-pocket | 移动端优先多人 Web 应用 | 基于 Pi Durable 持久会话打造,支持手机/Termux 与多用户协作 | 出门在外用手机浏览器继续看管或接管正在跑的 Pi 会话 |
pi-acp | 编辑器 ACP 协议适配器 | 实现 Agent Client Protocol,让支持 ACP 的编辑器/IDE 直接挂载 Pi | 想在 Zed 或其他支持 ACP 的编辑器界面里驱动 Pi |
pi-courier | Matrix 即时通讯桥接 | 通过 Pi RPC 协议把终端会话完整映射到 Matrix 聊天室 | 使用自托管 Matrix 协议远程收发 Pi 斜杠命令与任务 |
pi-chat | 终端多人协作聊天 | 客户端直接使用 pi-tui 构建界面,服务端跑在 Cloudflare Workers | 复用 Pi TUI 组件栈做轻量化终端协作用例 |
看完「10 二开形态」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。