omp：Oh My Pi (omp) 完全指南：终端里功能最全的 AI 编程代理

Oh My Pi (omp) 是终端 AI 编程代理中功能最全的一个，GitHub 17.7k+ stars，MIT 协议。32 个内置工具、LSP/DAP 集成、子代理、浏览器控制、55k 行 Rust 原生核心。本文覆盖安装配置、日常使用、高级技巧和真实案例。

什么是 Oh My Pi

Oh My Pi（简称 omp）是一个终端 AI 编程代理，fork 自 Mario Zechner 的 Pi，由 Can Bölük 重写为编码优先的工具。和 Claude Code、Codex CLI 是竞品。

核心特性：

• 开源（MIT），~55k 行 Rust 核心，跨平台原生
• 32 个内置工具（读写文件、搜索、shell、LSP、调试器、浏览器、子代理……）
• 40+ 模型 provider，自定义 models.yml 接入任何 OpenAI 兼容端点
• Hashline 编辑格式：基于内容哈希锚点，编辑精准、省 token
• 子代理（subagents）：并行任务分发，隔离工作区
• LSP 深度集成：重命名、引用查找、诊断——IDE 知道的它都知道
• DAP 调试器：lldb、dlv、debugpy，直接附加进程调试
• 浏览器驱动：Puppeteer 控制 Chromium 或 Electron 应用
• MCP 支持：标准化外部工具接入
• 25 个搜索后端：auto 模式自动链式查找

和竞品对比：

简单说：omp 是功能最全的——别人需要装插件的东西它出厂自带。代价是体积更大、配置项更多。

安装

各平台安装命令

# macOS / Linux（推荐）
curl -fsSL https://omp.sh/install | sh

# Homebrew
brew install can1357/tap/omp

# Bun（推荐，最快）
bun install -g @oh-my-pi/pi-coding-agent

# Windows PowerShell
irm https://omp.sh/install.ps1 | iex

WSL 用户推荐用 bun 安装（避免权限问题，安装到 ~/.bun/bin）：

bun –version || npm install -g bun
bun install -g @oh-my-pi/pi-coding-agent
hash -r; omp –version # 应显示 omp/16.x

⚠️ 别装在 /mnt/c 等 Windows 挂载盘上，I/O 慢。

配置 API 接入

omp 通过 ~/.omp/agent/models.yml 配置自定义模型 provider。以七牛云为例：

providers:
qiniu:
baseUrl: https://api.qnaigc.com/v1
api: openai–completions
apiKey: sk–your–api–key
authHeader: true
models:
– id: gpt–5.5
name: GPT–5.5
reasoning: true
input: [text, image]
contextWindow: 400000
maxTokens: 128000
– id: openai/gpt–5.6–sol
name: GPT–5.6 Sol
reasoning: true
input: [text, image]
contextWindow: 400000
maxTokens: 128000

获取 API Key：

验证配置：

omp models find qiniu # 应显示你配的模型
omp –model gpt-5.5 -p "你好"

日常使用

启动方式

# 交互模式（默认）
cd my-project
omp

# 指定模型
omp –model "DeepSeek-V4-Pro"

# 单次命令
omp -p "解释这个项目的架构"

# 继续上次会话
omp -c
omp –resume # 选择历史会话

核心快捷键

常用斜杠命令

/model # 切换模型
/mcp # 查看 MCP server 状态
/review # 代码审查
/collab # 协作分享会话
/debug # 调试面板
/advisor # 开启/查看 advisor 模型状态

单次命令示例

# 理解项目
omp -p "解释这个项目的架构，列出核心模块依赖关系"

# 写代码
omp -p "实现一个 LRU Cache，支持 TTL 过期"

# 修 Bug
omp -p "运行测试，分析失败用例，修复它们"

# 重构
omp -p "把这个文件的回调地狱改成 async/await"

# Git 操作
omp -p "看 main..HEAD 的 diff，写一个清晰的 PR 描述"

模型角色系统

omp 有独特的模型角色设计，按任务意图路由不同模型：

实用配置策略：

# 默认用 DeepSeek V4 Flash（快、便宜）
# 复杂任务切 GPT-5.6 Sol
# 子代理用 GPT-5.4 Mini
omp –model "DeepSeek-V4-Flash" –slow "gpt-5.6-sol" –smol "gpt-5.4-mini"

Ctrl+P 在当前角色的模型间循环切换。

高级玩法

1. 子代理（Subagents）

omp 的杀手锏之一。把任务拆分成多个并行 worker：

> 帮我重构 src/services/ 下的 5 个文件，每个文件转成 TypeScript 并加类型注解

omp 会自动用 task 工具 spawn 多个子代理，每个处理一个文件，互不干扰。

2. Plan 模式

先规划再执行：

omp –plan-yolo "把这个项目从 CommonJS 迁移到 ESM"

agent 先用 plan 模型制定方案，确认后切到执行模型实施。

3. Advisor（顾问模型）

开启后，一个独立模型实时审阅主 agent 的每一步：

omp config set advisor.enabled true

顾问发现问题会内联提示（concern/blocker），主 agent 看到后自行修正。

4. LSP 深度操作

不只是诊断——支持重命名、查找引用、跳转定义、代码操作：

> 把 getUserName 重命名为 getUsername，确保所有引用都更新

omp 调用 lsp 工具的 workspace/willRenameFiles，barrel files、re-exports 全部自动更新。

5. 调试器集成

> 这个程序段错误了，帮我用 lldb 附加调试找到问题

omp 通过 DAP 协议驱动 lldb/dlv/debugpy，能设断点、单步、查看变量、评估表达式。

6. 浏览器控制

> 打开 http://localhost:3000，截个图看看页面渲染是否正确

内置 Puppeteer 驱动，隐身模式默认开启。还能控制 Electron 应用（如 Slack）。

7. 协作会话

/collab # 生成共享链接 + 二维码
/collab view # 只读分享

别人用 omp join <link> 或浏览器加入，实时协作。端到端加密，relay 看不到内容。

8. 记忆系统（Hindsight）

omp config set memory.backend hindsight

agent 跨会话记住你的项目：用 retain 写入事实，recall 检索，reflect 综合分析。项目级隔离。

9. MCP 扩展

~/.omp/agent/mcp.json 注册外部工具：

{
"mcpServers": {
"imagegen": {
"command": "npx",
"args": ["-y", "tsx", "~/projects/imagegen-mcp/src/server.ts"],
"env": { "SILICONFLOW_API_KEY": "sk-xxx" }
}
}
}

10. 自动继承其他工具配置

omp 自动读取 .claude/、.cursor/、.codex/、.cline/、.vscode/ 等目录的规则和 MCP 配置。不需要迁移。

性能调优

Thinking Level

omp –thinking high # 复杂任务
omp –thinking low # 简单问答
omp –thinking max # 最深度推理

Prewalk 模式

规划完成后自动切到便宜模型执行：

omp –prewalk –prewalk-into "gpt-5.4-mini"

Fallback 链

模型 429 时自动降级：

# 在 config.yml 中
retry:
fallbackChains:
"gpt-5.6-sol": ["gpt-5.5", "gpt-5.4-mini"]

真实案例

案例 1：大规模重构

omp –model "gpt-5.6-sol" –thinking high
> 这是一个 Express + JS 项目，帮我：
> 1. 分析模块依赖
> 2. 从底层开始逐个转 TypeScript
> 3. 每转完一个文件就跑测试确认没破坏

omp 会用 subagents 并行处理独立模块，用 LSP 确保类型正确。

案例 2：调试 segfault

omp –model "DeepSeek-V4-Pro"
> 编译运行 src/main.c，程序 segfault 了。
> 用 lldb 附加调试，找到崩溃位置和原因，修复它。

案例 3：PR Review

omp
/review main..feature-branch

spawn 专门的 reviewer subagent，按 P0-P3 分级输出问题和 verdict。

常见问题

omp 免费吗？

omp 本身开源免费。需要 API（按量付费）。用七牛云/SiliconFlow 等国内中转即可。

启动后默认是 gemma4:31b-cloud？

models.yml 没放对位置。必须在 ~/.omp/agent/models.yml。用 omp config path 确认。

和 Claude Code 选哪个？

omp 工具最全（调试器、浏览器、子代理都内置），适合重度终端用户。Claude Code 推理强但功能少。建议都装。

支持哪些模型？

40+ provider 内置，任何 OpenAI/Anthropic 兼容端点都能通过 models.yml 接入。

Tip: Please use nerdfont？

运行 omp config set symbolPreset nerd，终端字体设为 Nerd Font。

延伸阅读