别再被 Agent「产品」锁死：我把编程助手换成了自己的 harness——Pi

大家好，我是珂抖屁。

今天聊一个我最近反复打开文档、反复装包、又反复跟朋友安利的东西：Pi（官网 pi.dev）。

它的一句话自我介绍很克制，也很刺耳——

There are many agent harnesses but this one is yours.
世上有很多 agent harness，但这一个是你的。

注意关键词：harness（挽具 / 框架），不是「又一个更聪明的聊天框」，也不是「订阅期内功能最全的密封产品」。Pi 把自己定位成 minimal agent harness：核心尽量薄，默认工具尽量少，系统提示尽量短；你真正要用的能力，靠扩展、技能、提示模板、主题，以及能打包分享的 Pi packages 补齐。

作者侧是 Earendil / Mario Zechner 那条线。社区英文圈里我常看到一种说法（我把它当成「共识口吻」转述，而不是我个人的百小时实测）：Claude Code 适合日用开箱，Pi 适合定制、多模型与成本可控。中文圈也已经有小白教程、压缩机制解读帖在流传——说明「怎么用、怎么改、怎么控上下文」这几件事，正在被认真写进公开笔记里。

下面按我自己的体验口吻，把「它是什么 → 和 Cursor / Claude Code 差在哪 → 公开评测里 token / 成本大概长什么样 → 为什么有人会切换过来 → 装哪些包、怎么装」串一遍。读完你可以直接去 pi.dev 装上，先试一周。

一、先把工具说清楚：Pi 到底是什么

如果用一句人话：Pi 是一个跑在终端里的、极简的编程 agent 底座。

官网强调几件事，我按自己理解翻译成「你会感受到的差别」：

1. 极简核心

默认不把「子代理 / plan 模式 / MCP / 权限弹窗」全塞进内核。官方叙事很直白：这些功能别人做成产品功能；Pi 选择 跳过，让你用包补齐，或者直接让 Pi 帮你写扩展。

2. 扩展是同进程 TypeScript

不是「再开一个黑盒插件进程」，而是扩展以 TypeScript 模块的方式接入工具、命令、快捷键、事件和 TUI。这意味着：你想加一个 /xxx、换一个状态栏、改压缩策略，路径是「写代码 / 装包」，而不是「等厂商下个版本」。

3. 包生态：pi install npm: / git:

扩展、skills、prompts、themes 可以打成包，通过 npm 或 git 安装。目录在 pi.dev/packages。装法类似：

4. 多模型，会话中途可切

官网写的是 15+ providers、数百模型（Anthropic、OpenAI、Google、Azure、Bedrock、Mistral、Groq、xAI、OpenRouter、Ollama……）。会话里用 /model（或快捷键）切换；喜欢的模型可以快速轮换。

5. 会话是树，不是一条直线

/tree 回到任意历史节点继续；/share / /export 把会话变成可分享形态。试方案、试模型、试提示词时，「分支」比「删了重来」舒服太多。

6. 要什么，可以让 Pi 改自己

缺命令就让它写；改完 /reload，同会话继续。这个动作我第一次用的时候有点上头：不是「下次启动再生效」，而是 当场改 harness。

安装官方给了多种方式，文中示例即可（以官网为准）：

装完登录 / 配 API Key 或 OAuth，进交互式 TUI 就能开干。它还有 print/JSON、RPC、SDK 四种模式——脚本化、嵌入自家应用也行；官网点名 OpenClaw 一类集成作为现实例子。

安全一句先钉死（后面装包还会再说）： 第三方 Pi 包拥有很高权限——扩展可执行任意代码，skills 也能驱动模型去跑危险操作。安装前请审源码。 官方文档写得很硬：Review source code before installing third-party packages.

二、和 Cursor、Claude Code 比，差在「产品形态」而不只是「功能清单」

我习惯把三者想成三种「座位」：

Cursor｜编辑器里的 Agent
强项：改代码、看 diff、和 IDE 一体
代价：工作流偏锁在 IDE
适合：我就在 Cursor 里把活干完

Claude Code｜开箱 CLI 产品
强项：sub-agent / plan / MCP / 权限密、自家模型体验强
代价：定制天花板在「产品允许的地方」
适合：少配置、多产出

Pi｜极简 harness
强项：短系统提示、可自改、多模型、会话树、包生态
代价：默认功能少；安全责任更多在你
适合：要拥有 harness、多模型与成本可控

英文社区常把 Pi 叫成「你拥有的 harness」——我认同这个比喻：不是换了一个更贵的司机，而是换了一套你能拧螺丝的底盘。还有一个我很在意的点是上下文工程（context engineering）：最小系统提示 + 可扩展压缩 + AGENTS.md / skills / 动态注入，让你更主动地决定「什么进窗口、什么被摘要」。agent 好不好用，常常不是模型智商差一分，而是窗口里塞了什么、怎么瘦身。

三、公开评测里，token 与成本大概长什么样（标明出处）

社区说「Pi 更省」，我不会甩自己未核对的账单。下面是公开第三方评测里的图——带着出处看，不要当成「珂抖屁个人实测」。

Composio｜各 harness 总 token

出处：8 Best AI Agent Harnesses（https://composio.dev/content/best-ai-agent-harnesses）

读法：同一套任务口径下，Pi 总 token 大约只有 Claude Code 一半量级——快照，不是永恒定律。

Composio｜任务通过与成本卡片

出处：Pi Agent vs Claude Code（https://composio.dev/content/pi-agent-vs-claude-code）

读法：同一模型硬任务里，通过率与成功成本差一截；差在 harness 开销与计费路径，不是「模型突然变聪明」。

FrontierHarness｜通过率相近，单次成本可差一个数量级

出处：FrontierHarness

读法：通过率差不多时，把 Claude Code 那颗点往右挪一眼就懂「成本差十几倍」从哪来；别把单点极端值当成日常账单。

我怎么读这些图：

四、怎么切换过来：从「功能被锁死的产品」到「自己拥有 harness」

切换动机，我综合公开叙事，归纳成四条（仍然是「共识转述」，不是编造经历）：

1. 功能在别人的路线图里

你想要的交互、权限策略、子代理编排，产品不一定给你开关；Pi 的答案是：写扩展，或装别人写好的包，或让 Pi 当场帮你实现再 /reload。

2. 模型与成本想自己握在手里

会话中途 /model 换模型，用 OpenRouter / 本地 Ollama / 各家 API——「同一条会话树，不同模型试跑」很自然。公开评测里那几张 token / 成本图，也是在说同一件事：外壳不同，账单可以差很多。

3. 会话要可回退、可分享

/tree + /share 让「探索」变成一等公民。你不是在一条不可逆的聊天记录里硬扛，而是在一棵树上长出分支。

4. 把「我的工作流」打包带走

扩展 + skills + prompts + themes → 一个 package → pi install。团队可以共享 .pi/settings.json（项目级 -l 安装），而不是每人在 GUI 里点一堆开关却无法版本化。

迁移时我建议的心态：

一句话动机：不是「抛弃好用的产品」，而是「当你需要拥有 harness 时，Pi 站在开源与可扩展这一边」。

五、值得装的插件（精选）与怎么用

包目录：pi.dev/packages 统一安装：pi install npm:包名 也可临时试跑：pi -e npm:包名（不写入长期设置）

下面 8 个是我按「场景覆盖」挑的起步组合。第三方包全权限，先看源再装。

1）pi-mcp-adapter — 接 MCP

场景： 你已经有 Cursor / Claude / Codex 的 MCP 配置，或一堆 MCP server，想接到 Pi 上。 适配器把 MCP 能力桥进 Pi，避免「核心没 MCP = 用不了生态」。目录页上它也是热度很高的一类基础包。

2）pi-web-access — 搜网页 / 抓 URL / PDF / YouTube 等

场景： 让 agent 具备上网检索、拉取页面、抽 PDF、理解 YouTube 等能力（具体后端取决于你配置的搜索 / 抓取提供方）。写调研、对文档、跟官网核对时很常用。

3）pi-subagents 或 @tintinweb/pi-subagents — 补子代理

场景： 官方跳过了内置 sub-agents；你要委派、并行、编排时用包补。前者偏委托与脚本化多代理工作流；后者社区描述更接近「带 live widget / fleet 观感」的子代理体验。二选一即可，先读 README 再装。

4）@narumitw/pi-plan-mode — plan 模式

场景： 大改动前先只读协作规划（包描述为 Codex-like 的 /plan）。适合「先对齐方案，再动手改仓库」。

5）@gotgenes/pi-permission-system 或 cc-safety-net — 权限 / 安全网

场景： Pi 默认很信任你自己；一旦 agent 能跑 bash，你就需要闸门。权限系统做策略执行；cc-safety-net 一类则侧重挡住破坏性命令与敏感路径访问。生产仓库、含密钥的机器，这一步不要省。

6）pi-extmgr — 扩展管理 UI

场景： 装多了包之后，用 /extensions 在 TUI 里浏览、搜索、安装、更新、移除。比纯手改 settings 友好，适合「包囤积患者」自救。

7）pi-skill-hub — skill 浏览与安装

场景： 打开 /skill-hub，在 Browse / Inventory / Install 等面板里发现、预览、安装与管理 skills。skills 是「按需加载的能力说明书 + 工具」，对上下文更友好；这个 hub 让发现过程不再靠纯口口相传。

8）pi-memory（或 pi-hermes-memory）— 记忆，选一

场景： 跨会话记住你的偏好、项目约定、长期笔记。pi-memory 偏 qmd 语义检索 + 日志 / 长期记忆 / scratchpad；pi-hermes-memory 则强调持久记忆、会话搜索与密钥扫描等（看包页与测试说明）。只装一个记忆方案，避免两套记忆互相抢戏。

我建议的「第一周最小集合」（可直接照抄）：

用起来时再记几个官方味道很浓的命令：/model、/tree、/share、/reload。缺功能时，优先问自己：「是装包，还是让 Pi 写一个最小扩展？」——这才是 harness 思维。

六、结尾：去拥有它，而不是又订阅一个黑盒

回到口号：There are many agent harnesses but this one is yours.

Cursor 让 Agent 住进编辑器；Claude Code 把丰富功能做成开箱产品；Pi 把决定权还给你——用极简核心换可编程表面，用包生态换功能清单，用 /reload 换「等下次更新」。公开评测里那几张「token 更少 / 成功成本更低」的图，只是这套心智的一张成绩单；真正长期值钱的，是你能读懂、改得动、装得走的 harness。

如果你也腻了「功能在产品墙的另一边」，这周就做两件事：

七天后你会更清楚：你要的是不是「又一个 agent 产品」——还是 一套属于自己的 harness。

我是珂抖屁。工具与产品，我会继续拆、继续装、继续说实话。下篇见。

延伸阅读
pi.dev · https://pi.dev/
pi.dev/packages · https://pi.dev/packages
8 Best AI Agent Harnesses · https://composio.dev/content/best-ai-agent-harnesses
Pi Agent vs Claude Code · https://composio.dev/content/pi-agent-vs-claude-code
FrontierHarness · https://frontierharness.org/