ARTICLE · 1132671
只有四个工具的AI助手,凭什么拿11万星?我在终端里试了Pi
最近我在终端里试了一款 AI 工具,叫 Pi。
大多数 AI 工具都在做加法:更多功能、更多按钮、更多你要学的东西。
Pi 反着来。
它默认只给 AI 四个工具:读文件、写文件、改文件、执行命令。系统提示词加上工具定义,总共不到 1000 个 token,少到几乎可以忽略。
就这么个"极简到离谱"的东西,GitHub 上拿到了 超过 11 万颗星。

它的设计哲学只有一句话:
下面不讲复杂技术,只说三件事:Pi 是什么、它和别的工具有什么不同、以及一个普通职场人怎么用它解决实际问题。
一、Pi 是什么?
Pi 是一个跑在命令行里的 AI 助手。不用装客户端,不用开网页,在终端里敲一句话,它就能读你电脑上的文件、执行命令,把一整套多步骤任务做完。
它的几个关键点:
支持 20 多家模型:Claude、GPT、DeepSeek、Gemini、Ollama 都能接,随时能换
一个终端界面搞定:不用多个软件之间来回切换
默认只给 AI 四个工具:跑得轻,也花得少
完全开源免费:MIT 协议,只为自己选的模型 API 付费
官方定位是:"Primitives, not features"——先给基础构件,不预置功能。
二、它和 Claude Code、Codex 有什么不同?
Claude Code 和 Codex 是功能强大的"专业工具",Pi 更像一套灵活的"底层系统"。核心区别:谁听谁的。
三、核心思路:流程自主
这部分是 Pi 真正的价值所在,也是最容易绕晕的地方。用一个真实例子走一遍。
场景:每周整理国内外体育新闻 10 条
你每周要交一份"本周国内外体育事件新闻汇总",要求是:
总共 10 条
国内至少 5 条,国外至少 5 条
覆盖不同项目:足球、篮球、网球、田径、赛车等
每条要有标题、来源、时间、摘要、看点
不能编造,必须可溯源
以前手动刷十几个网站,复制、粘贴、再排版。现在把这个流程写一次、固化下来,以后一句话就能跑。
第一步:创建提示模板目录
打开 PowerShell:
mkdir -Force "$env:USERPROFILE\.pi\agent\prompts"
这会创建目录:
C:\Users\你的用户名\.pi\agent\prompts
第二步:创建流程文件
新建文件:
C:\Users\你的用户名\.pi\agent\prompts\整理体育新闻.md
把下面内容复制进去。这段有点长,不用逐字读懂——你只需要改里面的规则,剩下的交给 Pi:
---
description: 整理本周国内外体育事件新闻,输出10条
argument-hint: "[输出目录]"
---
请整理本周国内外体育事件新闻,共10条。
## 目标
- 国内体育新闻:至少5条
- 国外体育新闻:至少5条
- 总条数严格为10条
- 每条必须真实、可溯源,不得编造
- 覆盖不同项目,避免全是同一类运动
## 时间范围
- 从本周一 00:00 到当前时间
- 先用 powershell 执行 `Get-Date` 获取当前日期
- 再计算本周一的日期
## 来源要求
国内优先:新华社体育、人民网体育、央视体育、新浪体育、腾讯体育
国外优先:BBC Sport、ESPN、Reuters Sports、AP Sports、Sky Sports
优先使用 RSS 或公开网页。若某个来源无法访问,跳过并记录,不要编造。
## 抓取方式
- 如果已配置联网 MCP,优先使用 MCP 搜索/抓取
- 否则用 powershell 的 `Invoke-WebRequest` 访问 RSS 或网页
- 只保留发布时间在本周内的条目
- 去重:同一事件只保留一条
- 排除传闻、未证实消息、广告、旧闻
## 选择规则
1. 先按重要性、影响力排序
2. 国内选5条,国外选5条
3. 尽量覆盖足球、篮球、网球、田径、赛车等不同项目
4. 若某类新闻不足,可适当调整,但总数必须10条
## 输出格式
用 Markdown 表格输出,列:
| 序号 | 标题 | 来源 | 时间 | 国家/地区 | 摘要 | 看点 |
|---|---|---|---|---|---|---|
要求:
- 摘要不超过80字
- 看点一句话说明为什么值得关注
- 每条附上来源链接
## 保存
保存到:${1:-C:\Users\你的用户名\体育新闻}\体育新闻_YYYY-MM-DD.md
文件名中的日期用当天日期。
## 最后
- 打印一句总结:本周共整理10条,国内X条,国外Y条
- 列出所有来源链接
- 如果无法联网,停止并提示用户粘贴新闻素材
第三步:在 Pi 中调用
启动 Pi(命令行输入 pi),进入界面后输入:整理体育新闻。
第四步:输出效果
Pi 最终会生成这样的内容:


核心思路
你只需要写一次 整理体育新闻.md,以后每周只要一句:整理体育新闻
Pi 就按你的规则干活。
流程是你写的,Pi 只是执行者。
四、快速上手(简化版)
安装
需要 Node.js 22.19 或更高版本。
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
配置模型
以 DeepSeek 为例:
[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "你的key", "User")
然后关闭并重新打开终端,环境变量才会生效。
开始使用
终端输入:pi


可能遇到问题及解决办法
在安装pi的过程中,由于配置环境等原因,可能出现Node.js版本不满足要求、fd和ripgrep自动下载超时等问题,我的解决办法是:把终端中显示的故障直接复制给deepseek,由deepseek引导逐一解决问题,均迎刃而解。
五、对职场人的启示
Pi 对职场人的价值,不在于它是一个"AI 编程工具",而在于它展示了一种思路:
1. 做减法比做加法更难每多一个工具,AI 就要多花一份精力判断该用哪个。精简往往比堆砌更有效。
2. 把适应成本降到最低好的工具应该让你用已有的方式工作,而不是逼你改掉习惯。
3. 你当导演,工具当演员流程你写,Pi 执行。它从"一个你要去适应的产品",变成"一套你自己攒的装备"。
