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 事件钩子与注册接口

pi-agent-core / pi-ai SDKPi Durable 持久会话Pi RPC 协议ACP(Agent Client Protocol)兼容加载 pi.extensions

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 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)