乐于分享
好东西不私藏

只有4个工具的AI编程助手Pi

只有4个工具的AI编程助手Pi
《AI时代漫游指南》第 187 章《戏服与演员》记载:「能力长在演员身上,身份缝在戏服里面——分清这两样,你才知道换掉一个的时候,能带走什么。」

一、一个让人不安的问题:你的 AI 助手,命根子在谁手里

先说我们为什么会去调研这个东西。
我的日常工作重度依赖 Claude Code——二十多个自动化服务、每天几十次定时巡检、几乎所有代码和文章都经它的手。
它很好用,好用到让人后背发凉:如果有一天它不可用了呢?
账号风控、区域政策、价格暴涨、服务调整——AI 工具的"断供"剧本,过去两年每一种都真实上演过。依赖越深,这个问题越不敢想。
于是我们花了几轮调研加一次实测,去找"保底件":万一主力工具不可用,能顶上来的备用 AI 助手。
最后选中的候选,是一个叫 Pi 的开源项目。
调研它的过程,比结论本身有意思得多——它逼着我们想清楚了一件事:AI 助手的"能力"和"身份",到底哪些在厂商手里,哪些可以攥在自己手里。
这篇是调研笔记的公开版。

二、Pi 是什么:一个反潮流的存在

先报公开档案:
•作者:Mario Zechner(网名 badlogic),奥地利工程师,开源游戏框架 libGDX 的作者,开源圈老江湖
•首发:2025 年 8 月;到 2026 年 6 月,GitHub 已积累 6 万多颗星,是最热门的开源编码 agent 之一
•协议:MIT——最宽松的开源协议,谁都能用、能改、能商用
•形态:终端命令行工具,一行命令安装
但真正让它出圈的,是一个反潮流的数字:它只给 AI 四个工具——读文件、写文件、改文件、执行命令。
作为对比:主流 AI 编程助手动辄内置几十项能力——子代理、计划模式、权限系统、插件协议、网页检索……
而 Pi 的哲学是一句话:这些都不该由工具预装。模型足够聪明的话,会用这四个基础动作自己组合出一切。
需要网页检索?让 AI 自己敲命令去抓。需要分身干活?让 AI 再启动一个自己。需要更多能力?用扩展系统自己长——而不是等厂商内置。
编者注:这有点像做菜。别的工具给你配全套料理机:切菜机、和面机、空气炸锅。Pi 只给一把好刀和一口锅,然后说:会做菜的人,这就够了。潜台词是——不会做菜的人,机器再多也是外卖选手。

三、"厚度光谱":AI 工具正在分成两个流派

调研中我们纠正过自己一个错误认知,值得单独讲。
一开始我们以为 Pi 是"没有外壳的裸 AI"。错了。
只要不是直接裸调 API,就必然有一层外壳在干三件事:把工具执行结果喂回模型、真正去执行读写命令、管理会话记录。Pi 这三件都做了——所以它不是没有外壳,而是把外壳做到了不可再薄。
真正的分歧是外壳的厚度,这是一条光谱:
层级代表特点
裸 API自己写调用代码一切自理
极简外壳Pi循环+4工具+会话
富外壳Claude Code 等内置全家桶
外壳+平台各类 Agent 平台再包一层调度
厚外壳的好处显而易见:开箱即用、新手友好、边界情况都替你想好了。
代价藏在水面下:每多一个内置能力,就多一份常驻开销、多一层你控制不了的行为、多一处升级时可能变卦的地方。
Pi 的赌注是:外壳的边际价值,会随模型变强而递减。 模型越聪明,越不需要工具替它铺路——最终你只需要最薄的那层。
编者注:有趣的是,两派正在殊途同归。极简派用着用着也长出了技能库(Pi 已原生支持加载技能文件);区别只在于:厚外壳的能力是厂商预装的,极简派的能力是用户自己长出来的——收敛的是形态,分岔的是所有权。

四、戏服模型:你的 AI 助手里,什么能带走

这是整轮调研里我们最满意的思维模型,分享给你。
把 AI 助手拆成三层,用剧团打比方:
演员 = 模型本身。 聪明程度、代码能力、审美——长在模型身上,换了模型就没了。演技不可转让。 戏服 = 你喂给它的一切文本。 偏好设定、积累的技能文件、项目文档、历史记录——本质上都是文本,是你花几个月"缝"出来的。戏服可以迁移:换一个演员,衣服照穿。 剧场 = 外壳和周边系统。 工具执行、消息通道、定时调度——工程设施,可以重建。
分清三层之后,"断供焦虑"突然就可以拆解了:
•演员被撤走 → 找新演员,损失的是演技差距
•戏服在自己手里 → 零损失——前提是你一直把它存成自己文件夹里的文本,而不是存在厂商的云端设置里
•剧本要改译 → 技能文件里难免有"假设某个工具存在"的写法,换引擎时需要翻译适配
编者注:这就是为什么我一直劝人把 AI 的记忆和偏好写成本地 Markdown 文件,而不是全托管给某家的"记忆功能"。文本文件是你的戏服,云端记忆是租的戏服——剧团散伙时,租的是要还的。
而 Pi 在这个模型里的位置就清楚了:一个任何演员都能穿进去的最简剧场——模型无关(接得上各家 API,也接得上本地开源模型)、MIT 协议(没人能收回)、纯文本配置(一切在你的文件夹里)。

五、两种断供,两种脆弱

调研里第二个值得公开的判断:"断供"其实是两种完全不同的风险,抗性也完全不同。
第一种:厂商级切断。 账号没了、区域封了、服务关了。
这种风险 Pi 几乎免疫——不绑任何厂商,API 可以换,模型可以换成本地开源模型,代码 MIT 谁也收不走。这是它作为保底件的核心价值。
第二种:能力级降档。 主力模型用不了,备用模型比原来笨一截。
这时 Pi 反而最裸露——厚外壳内置的护栏(自动纠错、边界处理、权限确认)能兜住一部分笨模型的失误,而 Pi 的哲学决定了它什么都不兜:演员不行,薄戏服遮不了丑。
一句话总结:Pi 抗的是"人没了",抗不了"人变笨了"。
编者注:这个区分适用于一切备份方案。异地备份抗的是机房失火,抗不了你自己删库——不同的灾难需要不同的保险,没有一张保单包所有。

六、实测:一次真实的冒烟测试

调研不能只看文档,我们做了一次端到端验证(2026 年 8 月 1 日):
环境:一台 Mac 上安装 Pi(当时版本 0.73.1),后端不接任何云端 API,指向本地跑的 Qwen 35B 级开源模型——整条链路完全离线、零云账号、零 API 费用。 任务:给它一段有真实 bug 的代码——温度转换公式少了括号,运算优先级错了,结果全错。要求它找到、修复、并自己跑命令验证。 结果:读文件 → 精准定位 → 修复 → 自己执行验证脚本确认输出正确,全闭环通过。
这个结果的含金量要说明白:它证明的不是"Pi + 本地模型能替代 Claude"——一次测试什么也证明不了(我们内部规矩:样本量 1 不构成任何成功率结论)。
它证明的是这条保底链路是通的:最坏情况下,一台本地 Mac + 开源模型 + 一个 MIT 工具,可以完成真实的代码修复工作。
保险的意义从来不是比主力好用,是确认它拉得响。
编者注:测试用的 bug 是刻意挑的"经典款"——运算符优先级是人类程序员的祖传翻车点。让 AI 修人类最常犯的错,有种考驾照先考倒车入库的仪式感。

七、适合谁:一张诚实的对照表

你的情况建议
刚开始用 AI 编程用主力工具,别碰 Pi
重度依赖单一 AI 工具配一个 Pi 当保底
有本地算力+隐私需求Pi+本地模型是完整方案
大量重复性轻任务Pi+本地模型省 API 费
展开说两句:
新手请直接用厚外壳工具。 Pi 的极简对新手不是自由,是荒野。没有权限确认、没有防呆护栏,它假设你知道自己在干什么。 重度用户建议花一个下午装一个。 不是为了日常用,是为了把"断供预案"从焦虑变成一条验证过的操作流程。顺便你会被迫想清楚:自己的戏服(技能、偏好、记忆文件)到底存在哪,能不能穿到别的演员身上。 成本敏感的自动化玩家可以认真研究。 每天跑几十次、不需要顶级智力的机械任务(格式检查、日志摘要、状态巡检),切到"Pi + 本地模型"这条免费链路,云端配额留给真正难的活。我们下一阶段就在做这个:用一批真实任务跑分,产出一张"什么任务用什么演员"的路由表。
编者注:注意"路由"这个思路的通用性——AI 用量大了之后,真正的省钱之道从来不是找更便宜的模型,而是承认任务有档次之分,让每个档次的活配得上恰好的智力。大材小用烧的是钱,小材大用烧的是你。

写在最后

三个带走的要点:
1.Pi 是把 AI 助手外壳做到最薄的开源方案:4 个工具、MIT 协议、模型无关,6 万星不是白来的
2.它抗"厂商级断供"能力一流,但对"能力级降档"最裸露——它是保底件,不是替代品
3.比工具更值钱的是戏服模型:把你的偏好、技能、记忆存成自己手里的文本文件,换演员的时候才带得走
调研完 Pi,我们没有换掉主力工具的打算——但睡得比以前踏实了。
保险买完不希望用上;但没买的时候,你半夜想的都是它。

我是漫游君,一个把 AI 当同事用的独立开发者。这里记录 AI 时代的实操笔记:哪些工具真的有用、哪些坑真的会踩。
如果这篇让你开始盘点自己的"戏服",分享给那个和你一样重度依赖 AI 的朋友——断供预案这种东西,最好在用不上的时候就备好。

相关学习资料