Pi：极简、开源的终端 AI 编程 Agent

摘要：Pi 是一个极简、开源的终端 AI 编程 Agent，由 libGDX 作者 Mario Zechner 主导开发（Earendil Inc. 出品）。核心设计哲学是"编码 Agent 只需要四个工具 + 不到 1000 token 的系统提示词"，其余能力按需扩展。一句话概括：Pi 是"你可以完全掌控和改造"的 AI 编程工作台，而不是功能堆砌的黑盒 SaaS。

---

基本信息

项目	信息
官网	pi.dev
开源协议	MIT
GitHub	earendil-works/pi（约 9.3 万 Star）
语言	TypeScript（最新 v0.84.1，2026 年 8 月）
安装	npm / bun / pnpm 全局安装，或官方一键脚本
架构	完全本地终端运行，零 SaaS 后端，无需注册账户

核心设计哲学

Pi 的设计直接体现 "Agent = Model + Harness" 公式：

• 极简核心只内置 4 个工具：read（读文件）、write（写文件）、edit（精确编辑）、bash（执行命令）
• 系统提示词严格控制在 不到 1000 token（对比 Claude Code 约 55000 token），把上下文窗口留给真实项目内容
• 刻意不内置 MCP、子代理、权限弹窗、计划模式、待办清单、后台 bash 等 —— 全部通过扩展按需添加
• 提供的是可组合的基础原语，让用户搭建自己的工作流，而非适应工具预设的流程

四种运行模式

模式	说明
Interactive（TUI）	默认的日常交互式终端编程模式
Print / JSON	pi -p "query" 脚本化非交互输出，适合自动化
RPC	通过 stdin/stdout 的 JSONL 协议，供非 Node 进程集成
SDK	嵌入 Node.js 应用（如 OpenClaw 等产品的集成方式）

四层扩展体系（所有维度都可替换）

1. Extensions（扩展）：TypeScript 模块，拥有完整系统访问权限；可添加自定义工具、注册命令快捷键、注入 UI 组件、实现 RAG/长期记忆、子代理、MCP 集成、权限门控等
2. Skills（技能）：遵循 Agent Skills 标准，通过 /skill:name 调用，按需加载不占用提示缓存
3. Prompt Templates（提示词模板）：本地 Markdown 文件，通过 /模板名 展开，支持变量插值
4. Themes（主题）：视觉自定义 + 热重载

四层可打包成 Pi Packages，通过 npm 或 git 分发共享。

多模型支持（模型无关）

• 自带 API Key，支持 15+ 提供商、数百个模型
• 订阅制：Anthropic Claude Pro/Max、OpenAI ChatGPT Plus/Pro（Codex）、GitHub Copilot
• API Key：Anthropic、OpenAI、Google Gemini、Azure、Amazon Bedrock、DeepSeek、Groq、Cerebras、Mistral、xAI、OpenRouter、Kimi、MiniMax 等
• 本地模型：Ollama 及兼容本地推理服务
• 会话中随时 /model 或 Ctrl+L 切换，无需重启，不被单一厂商锁定

会话与上下文管理

• 会话采用 JSONL 文件树结构存储，支持分支、分叉、克隆；/tree 可回到任意历史节点继续对话
• 接近上下文上限时自动压缩（Compaction）旧消息，也可用扩展实现自定义压缩策略
• 自动加载全局（~/.pi/）与项目级（.pi/）的 AGENTS.md、CLAUDE.md、SYSTEM.md
• /export 导出 HTML，/share 上传 GitHub Gist 生成分享链接
• 实时介入：Enter 发送 steering 消息（当前工具执行完立即生效）、Alt+Enter 排队 follow-up

与主流竞品对比

维度	Pi	Claude Code
核心工具	4 个	40+ 个
系统提示词	<1000 token	~55000 token
开源	MIT	闭源
模型	15+ 提供商	仅限 Anthropic
架构	纯本地无后端	依赖云端

与 OpenCode 相比：Pi 更极简（4 工具 vs 6 个）、系统提示词更小（1000 vs 15000 token），但 OpenCode 支持 75+ 模型且原生支持 MCP 和子代理。

Pi 的差异化优势：核心极简、完全可控、数据主权 —— 而不是功能数量。

安全特性

1. 零后端架构：完全本地运行，无 SaaS 账户、无云端工作区，代码不上传任何第三方服务器
2. 供应链安全：依赖精确版本锁定、lockfile 验证、shrinkwrap 可复现安装、CI 自动安全审计
3. 容器隔离：官方推荐用容器化替代权限弹窗设计，通过沙箱环境限制 Agent 操作范围

适合谁用

• 追求数据主权和透明度的开发者/企业（合规行业、代码安全敏感团队）
• 不想被单一模型锁定的人（Claude、GPT、DeepSeek、本地模型自由切换）
• 喜欢折腾、定制工作流的极客型开发者
• 需要把 AI 编程能力嵌入自己产品的团队（SDK / RPC 模式）
• 从 Cursor、Claude Code、Codex CLI、Cline 迁移过来、想要更多控制权的用户

总结

Pi 的本质是一个 "AI 编程 Agent 的操作系统" —— 不替你决定怎么写代码，而是给你一个极简、稳健、可完全改造的底座。它的竞争力不在于功能多，而在于核心足够可靠、扩展足够灵活、数据足够安全。

参考资料

• Pi 官网
• GitHub: earendil-works/pi

关联词条

• Harness（智能体执行框架）（concept）
• DeepSeek Harness 与 Pi 的架构拆解对比（comparison）