1. 当全能变成负担我为什么开始给 AI 编程工具做减法第一次接触 Claude Code 的时候我承认自己被震撼到了。一个终端里跑起来的智能体能读文件、能改代码、能跑命令、能自己规划任务几乎把AI 结对编程这件事做到了极致。但用了大概两周之后一种奇怪的感觉开始冒出来我花在管理这个工具上的时间比花在写代码上的时间还多。上下文窗口被各种工具定义、系统提示、历史记录塞得满满当当一个简单的重构任务它要先读一堆无关文件再规划半天最后才动手。那种感觉就像你请了一个全能管家结果他每次做饭前都要把整个厨房重新盘点一遍。这不是 Claude Code 的错它本来就是奔着通用智能体去的。问题在于大多数人的日常开发任务根本不需要那么全能。我们 80% 的时间在做的事情其实很固定读几个文件、改几处代码、跑一下测试、看看报错。为这 80% 的场景配一个什么都能干的重型工具性价比并不高。所以当我看到 pi 这个项目的时候第一反应是这才对嘛。pi 的核心思路非常克制只给你 4 个工具把智能体的能力边界收窄换来的是更快的响应、更低的 token 消耗、更可预测的行为。而 oh-my-pi简称 omp则是围绕 pi 搭起来的一套全家桶配置把常用能力打包好让你开箱即用。这套组合特别适合那些已经厌倦了重型智能体、想要一个轻快顺手工具的人也适合刚入门、不想一上来就被复杂配置劝退的新手。这篇文章我会把 pi 和 oh-my-pi 这套东西拆开讲清楚它到底解决了什么问题、4 个工具分别是什么、为什么这样设计、怎么配、怎么用、踩过哪些坑。如果你正在用 Claude Code 或者类似的 AI 编程工具但总觉得太重了那这篇应该能给你一个不一样的思路。2. pi 的四个工具到底砍掉了什么一次关于能力边界的取舍2.1 从什么都能干到只干四件事的设计哲学要理解 pi得先理解它反着来的地方。主流 AI 编程工具的思路是能力越多越好工具列表越长用户越觉得强大。但工具越多模型在选择上的负担就越重。每次你给一个任务模型都要在几十个工具里挑挑错了就浪费一轮挑对了也可能因为工具描述太长而挤占上下文。这是一个隐形成本很多人没意识到。pi 的做法是把工具数量压到 4 个每个工具职责极其清晰。我实测下来这种收窄带来的最大好处不是功能少所以简单而是模型的行为变得高度可预测。你大概能猜到它下一步会干什么不会出现那种我只是让它改个变量名它却去重构了整个模块的惊吓。对于需要精确控制的场景这一点比全能重要得多。提示工具数量少不等于能力弱。pi 的 4 个工具是经过精心挑选的最小完备集覆盖了读、写、执行、检索这四类最核心的操作。绝大多数日常任务都能用这四类操作组合出来。2.2 四个工具分别对应哪四类核心操作虽然 pi 的具体工具命名可能随版本演进但从它的设计意图来看这 4 个工具基本对应下面四类操作。我按它解决什么问题来讲而不是死抠名字工具类别核心职责典型使用场景为什么不可替代文件读取类读取指定文件或目录内容看代码、查配置、读日志没有它模型就是瞎子文件写入类创建或修改文件改代码、写配置、生成文档落地的唯一出口命令执行类运行 shell 命令跑测试、装依赖、执行脚本连接真实环境的桥梁内容检索类在代码库中搜索找函数定义、查引用、定位报错大项目里靠读文件根本读不完这四类操作构成了一个闭环检索定位 → 读取细节 → 执行验证 → 写入修改。你会发现几乎所有编程任务都能拆解成这四步的循环。pi 的聪明之处在于它没有为重构调试写测试这些具体任务单独造工具而是让模型用这四类基础操作去组合。这就像给了一个厨师四把刀而不是四十种专用厨具——真正的高手用四把刀能做出一桌菜。2.3 砍掉工具之后token 和响应速度的真实变化我做过一个不太严谨但很直观的对比。同样一个任务找到项目里所有调用getUserById的地方把参数从 id 改成 userId。用重型工具的时候光是工具定义和系统提示就占了不少上下文模型还要先规划、再逐个工具调用中间穿插大量解释性输出。换成 pi 之后流程明显短了检索一次定位所有调用点读取相关文件批量修改跑一下测试确认。整个过程干净利落。token 消耗的下降是实打实的。工具定义少了模型在选工具上的思考就少了输出里的冗余解释也少了。响应速度的提升更明显因为每一轮交互的输入都更短模型处理起来更快。对于我这种一天要跑几十次 AI 辅助操作的人来说单次省几秒累积起来就是可观的效率差。注意token 消耗的降低不是线性的它取决于任务复杂度。简单任务上差距最明显复杂任务上因为本身就需要多轮交互差距会被稀释。但无论如何pi 在轻任务上的优势是压倒性的。2.4 什么场景下 pi 比全能工具更合适不是所有场景都适合 pi。我总结下来下面这几类场景用 pi 特别舒服日常小改动改个 bug、调个参数、加个日志这种任务用重型工具纯属杀鸡用牛刀。需要精确控制的场景你明确知道要改哪里、怎么改不希望模型自作主张。上下文敏感的项目项目很大上下文窗口宝贵工具定义越少越好。快速迭代需要频繁地改一下、跑一下、再看一下pi 的轻快节奏很搭。学习和理解代码用检索加读取的组合快速摸清一个陌生代码库的结构。反过来如果你要做的是从零搭一个项目大规模重构跨多个模块的复杂改动那全能型工具可能更省心因为它的规划能力更强。工具没有绝对好坏只有合不合适。3. oh-my-pi 全家桶把 pi 从能用变成好用的那层配置3.1 omp 到底补了哪些 pi 故意不做的部分pi 本身很克制克制到有点素。它给你 4 个工具但怎么配模型、怎么设提示词、怎么管理常用命令、怎么处理不同项目的差异这些它都不管。这就是 oh-my-pi 出场的地方。omp 本质上是一套围绕 pi 的配置集合和增强层把那些每个用户都要自己搞一遍的东西提前打包好了。我理解 omp 的定位就像给一台裸机装了一套精心调过的系统。pi 是发动机omp 是变速箱、仪表盘和座椅。它补的主要是这几块模型接入配置、提示词模板、常用工作流封装、项目级配置管理。这些东西单看都不难但一个个配起来很烦omp 帮你省了这一步。3.2 模型接入与 base url 配置的实操细节omp 里最实用的部分之一就是模型接入的配置模板。很多人卡在第一步怎么把 pi 接到自己想用的模型上。核心就是配置 base url 和对应的密钥。这里我不展开具体某个服务商只讲通用逻辑因为原理是相通的。配置通常落在一个配置文件里结构大致是这样{ provider: your-provider, baseUrl: https://your-endpoint.example.com/v1, apiKey: your-key-here, model: your-model-name }几个容易踩的点我提前说base url 结尾的斜杠有的服务商要求带/v1有的不带配错了会直接 404。omp 的模板里一般会标注清楚照着改就行。模型名称要精确模型名写错一个字符请求就会失败而且报错信息往往很含糊让人以为是网络问题。密钥不要硬编码进版本库用环境变量或者单独的本地配置文件别把密钥提交上去。提示omp 的配置模板通常会区分全局配置和项目配置。全局放你的默认模型和密钥项目配置放这个项目特有的设置。这样切换项目时不用反复改。3.3 提示词模板与工作流封装带来的效率提升omp 另一个让我觉得值的地方是提示词模板。pi 本身不预设你该怎么跟它说话但实际用下来某些提示词结构确实效果更好。比如让它改代码时明确告诉它只改这一处不要动其他文件比笼统地说帮我优化一下要靠谱得多。omp 把这些经验固化成了模板你直接调用就行。工作流封装也是类似思路。比如读文件 → 改 → 跑测试这个循环omp 可能把它封装成一个命令你一句话就能触发整个流程。这种封装的价值在于减少重复劳动把那些你每次都要手动敲的步骤自动化掉。3.4 项目级配置让不同项目用不同的 pi 行为这一点我觉得是 omp 最被低估的功能。不同的项目对 AI 工具的需求是不一样的。前端项目你可能希望它多关注组件和样式后端项目你希望它懂数据库和接口脚本项目你希望它别搞太复杂。omp 允许你在项目根目录放一个配置文件定义这个项目下 pi 的行为。这样一来你在 A 项目里配好的规则不会污染 B 项目。切换项目时pi 自动读取对应的配置行为跟着变。对于同时维护多个项目的人来说这个设计省心太多了。4. 从零把 pi 和 omp 跑起来一份不绕弯的配置流程4.1 环境准备先确认你的基础环境没问题在动手之前先把基础环境确认一遍。pi 和 omp 都是命令行工具所以你需要一个能正常用的终端环境。Windows 用户建议用 WSL因为很多命令行工具在原生 Windows 上会有路径和权限的坑WSL 里跑起来顺畅得多。macOS 和 Linux 用户直接用系统终端就行。需要确认的几样东西Node.js 环境大部分这类工具依赖 Node版本别太老建议用较新的 LTS 版本。包管理器npm 或者 pnpm 都行看你习惯。网络能正常访问你配置的模型服务这一步很关键配置对了但网络不通一样跑不起来。node -v npm -v这两条命令能正常输出版本号基础环境就没问题。4.2 安装 pi 与 omp 的完整命令序列安装本身不复杂但顺序和细节要注意。一般流程是先装 pi再装 omp因为 omp 是围绕 pi 的增强层依赖 pi 的存在。# 安装 pi npm install -g pi-cli # 安装 oh-my-pi npm install -g oh-my-pi # 验证安装 pi --version omp --version如果安装过程中报权限错误尤其是那种 no write permission to npm prefix 的提示说明你的 npm 全局目录权限有问题。解决办法有两个一是用管理员权限重装二是改 npm 的全局目录到一个你有写权限的位置。我更推荐后者一劳永逸。# 查看当前全局目录 npm config get prefix # 改到一个你有权限的目录 npm config set prefix ~/.npm-global改完之后记得把~/.npm-global/bin加到 PATH 里否则命令找不到。4.3 初始化配置base url、密钥和模型选择装完之后第一件事是初始化配置。omp 一般会提供一个初始化命令帮你生成配置文件模板。omp init它会引导你填 base url、密钥、模型名。填完之后配置文件会落在你的用户目录下。这时候别急着跑任务先用一个最简单的命令测试连通性。pi 列出当前目录下的文件如果它能正常返回结果说明配置通了。如果报错八成是 base url 或密钥的问题回去检查这两项。注意模型选择上别一上来就选最贵的。先用一个中等能力的模型把流程跑通确认工具链没问题再根据实际需求换更强的模型。很多问题其实是配置问题不是模型能力问题。4.4 验证安装用一个真实小任务跑通全流程配置通了之后用一个真实的小任务验证整个流程。我建议选一个你熟悉的项目让它做一件明确的小事比如给某个函数加一行日志或者把某个变量名改掉。这个验证步骤很重要因为它能暴露配置之外的问题模型能不能正确读取你的项目文件、能不能理解你的项目结构、改完之后能不能跑测试。这些是配置层面看不出来的。我自己的验证任务通常是找到项目里所有 TODO 注释列出来。这个任务用到了检索和读取两个工具能验证基础能力又不会真的改动代码很安全。5. 实际用起来才知道的事pi 加 omp 的踩坑与调优记录5.1 工具调用失败时先查这三处用 pi 的过程中最常见的报错就是工具调用失败。遇到这种情况别急着怀疑模型先按顺序查这三处文件路径pi 读文件用的是相对路径还是绝对路径如果它读不到文件很可能是路径基准不对。确认你启动 pi 的目录是不是项目根目录。权限要改的文件是不是只读的要执行的命令是不是需要特殊权限这类问题在 WSL 和原生 Windows 之间切换时特别容易遇到。命令是否存在pi 要执行的命令在你的环境里真的存在吗比如它想跑pytest但你项目用的是unittest那自然失败。我踩过最坑的一次是路径问题我在子目录里启动 pi结果它把相对路径都算错了读了一堆不存在的文件。后来养成习惯永远在项目根目录启动问题就少了。5.2 上下文被塞满时的处理策略即使 pi 很克制长时间对话之后上下文还是会满。这时候有几个策略主动开新会话一个任务做完就开新的别在一个会话里堆太多不相关的事。让它先总结再继续上下文快满时让它把当前进展总结一下然后你带着总结开新会话。用检索代替全量读取别让它一次读一堆文件用检索精确定位需要的部分。omp 在这方面有一些辅助功能比如自动压缩历史、按需加载配置能缓解一部分压力。但根本上还是得靠你自己控制会话的节奏。5.3 让 pi 少犯错的提示词技巧pi 的工具少意味着它对提示词的依赖更重。同样一个任务说法不同结果可能差很远。我总结了几条实用的明确边界只改这个文件不要动其他文件比帮我改一下靠谱。给出验证方式改完之后跑一下这个测试能让它自己检查。分步骤说复杂任务拆成几步说比一口气说完效果好。提供上下文这个函数被 A 和 B 调用比让它自己去找要快。这些技巧本质上是在帮模型减少不确定性。工具越少模型越依赖你的指令来定位问题所以指令越清晰效果越好。5.4 什么时候该切回全能工具最后说个实在的pi 不是万能的。有些任务我会毫不犹豫地切回全能型工具。比如大规模重构涉及几十个文件的改动全能工具的规划能力更省心。探索性任务我自己都不知道要干什么需要工具帮我理清思路。跨领域任务既要改代码又要写文档又要调配置全能工具更顺。工具是拿来用的不是拿来站队的。pi 和全能工具不是替代关系而是互补关系。我的做法是日常小任务用 pi复杂大任务用全能工具各取所长。6. 把 pi 用成肌肉记忆我的日常组合拳用了一段时间之后我慢慢形成了一套固定的用法基本成了肌肉记忆。分享出来你可以参考着调整成适合自己的。第一招检索先行。不管什么任务先让它检索定位别一上来就读文件。检索的结果能帮你和它都快速建立对问题的认知。第二招小步验证。改一点跑一下确认没问题再继续。别让它一口气改一堆最后出问题了都不知道是哪一步坏的。第三招会话隔离。一个任务一个会话做完就关。这样上下文干净行为可预测。第四招配置分层。全局配置放通用的东西项目配置放项目特有的。切换项目时不用反复改配置。第五招定期清理。omp 的配置和缓存会随着使用积累定期清理一下保持工具轻快。这套组合拳的核心逻辑就一句话把不确定性降到最低。pi 的设计本身就是在做减法你的用法也应该配合这个思路别把它当全能工具使。说到底工具的价值不在于它有多少功能而在于它能不能让你更专注地做真正重要的事。pi 加 omp 这套组合对我来说最大的价值就是不打扰——它安安静静地待在终端里我需要的时候叫它一下它快速干完活就退场不抢戏、不添乱。这种克制在如今这个什么都要全能的时代反而是一种稀缺品质。