Pi 是什么
Pi 是一个极简、开源（MIT 协议）、跑在终端里的 AI 编码 Agent。它由 libGDX 的作者 Mario Zechner 创建，目标是做一个「少即是多」的编码助手。
和很多功能堆叠的同类工具不同，Pi 的核心信条只有一条：一个编码 Agent 只需要四个内置工具，外加一个不到 1000 tokens 的系统提示词。
| 对比 | 同类工具常见做法 | Pi 的做法 |
|---|---|---|
| 内置工具 | 十几个到几十个 | 只有 read / write / edit / bash 四个 |
| 系统提示词 | 7000–10000 tokens | < 1000 tokens |
| 额外功能 | 默认全开 | 全部可选，靠扩展系统按需加 |
一句话：Pi 不替你决定你要什么，把选择权交给你。
四个内置工具
Pi 默认给模型的就是这四把「钥匙」：
| 工具 | 作用 |
|---|---|
read |
读取文件 |
write |
创建或覆盖文件 |
edit |
打补丁式修改文件 |
bash |
运行 shell 命令 |
外加一些只读辅助（grep、find、ls）通过工具选项可用。
Pi 运行在你当前的工作目录，可以修改那里的文件。想方便回滚？用 git 或别的检查点工作流——Pi 自己不强制。
什么被「刻意省略」了
Pi 文档明确列出了一堆同类工具默认带、但 Pi 故意不做的东西：
- 没有 MCP 支持
- 没有子 Agent（sub-agents）
- 没有计划模式（plan mode）
- 没有权限弹窗
- 没有内置待办清单
- 没有后台 bash
听起来很「简陋」？其实这是设计选择：这些都可以通过扩展、技能或第三方 Pi Packages 加回来，但由你自己决定要不要。
md-tools 的「Markdown 文档处理工具箱」。现在你只需要记住目标——用 pi 的极简四工具，做出一套能处理 markdown 文件的实用脚本。一个关键认知：工具 ≠ 模型
和 Claude Code / Codex 一样，Pi 是工具，模型是可换的。Pi 支持 15+ 家模型提供方，包括 Anthropic、OpenAI、Google、DeepSeek 等，还能通过 Ollama 接本地模型。
这意味着：你可以把 pi 接到国内大模型上，全程国内网络可用——这正是本站「无需翻墙」定位的又一次落地。
落地练习：想清楚「为什么选 Pi」
不用装任何东西，先在纸面上想一件事：
- 列一下你平时用编码 Agent 干的 3 件事
- 想想这几件事分别对应 Pi 的哪个内置工具（
read/write/edit/bash） - 问自己：如果工具要精简到四个，我最需要哪几个？
怎么判断做对了？——你能说出「我主要需要 read + edit + bash 就够了」这类判断，而不是「工具越多越好」。
卡住了怎么办？ 想不出具体任务？就用本课的 md-tools。觉得精简很难理解？记住核心就好：Pi 相信「少即是多」，缺的按需加。
常见坑：用「功能多少」来衡量工具
新手最容易踩的坑，是用「内置功能多少」来判断一个编码 Agent 好不好。
对 Pi 来说恰恰相反——它刻意少给，把决定权交给你。真正该看的是：①四个工具够不够干实事 ②扩展系统能不能让你按需补 ③系统提示词小，省不省 token。理解了「少即是多」，你才算真正开始懂 Pi。
小结
- Pi 是极简、开源、终端的 AI 编码 Agent
- 四个内置工具：
read/write/edit/bash - 系统提示词 < 1000 tokens
- 没有的功能（MCP/子Agent/计划模式等）都靠扩展按需加
- 工具与模型分离，可接 DeepSeek 等国内大模型
下一节，我们把它装到电脑上。