Oh-My-OpenCode：打造最强 AI 编程助手配置实战指南

小碗细面
VIP.5 如鱼得水
66 阅读13分钟

Oh-My-OpenCode：打造最强 AI 编程助手配置实战指南

开挂级别的编程体验——这就是 oh-my-opencode 的实战效果。

前言：如果你热爱编程和计算机，OpenCode 就是那个从 Windows 切换到 Linux 的兴奋时刻。但学习成本很高？Oh-My-OpenCode 让你的智能体像真正的开发团队一样工作，开箱即用。

🔥 为什么选择 Oh-My-OpenCode？

在 AI 编程时代，Claude Code 很棒，OpenCode 更棒——无限可扩展、无限可定制、零屏幕闪烁。但问题是：需要学习的东西很多，很复杂，而你的时间很宝贵。

Oh-My-OpenCode 解决了这个问题。它不是一个简单的配置插件，而是一个完整的智能体协作系统。

核心优势（你可能再也回不去了）

1️⃣ Sisyphus：像你一样编码的主智能体

在希腊神话中，西西弗斯因欺骗众神而被惩罚永恒地将巨石推上山坡。LLM 智能体和我们没有区别——它们每天推动着"石头"（思考）。

Sisyphus 的设计哲学：

  • ✅ 不会浪费时间自己寻找文件：保持上下文精简，向更快、更便宜的模型并行发起后台任务
  • ✅ 利用 LSP 进行重构：更确定性、更安全、更精准
  • ✅ 将繁重的前端任务委派给 Gemini 3 Pro
  • ✅ 遇到瓶颈时召唤 GPT 5.2 进行高智商战略支援
  • ✅ 受 TODO 列表约束：系统会强制它回到"推石头"模式——你的任务会被完成，句号。

用户评价："如果 Claude Code 能在 7 天内完成人类 3 个月的工作，那么 Sisyphus 只需 1 小时。它会持续工作直到任务完成。它是一个非常自律的智能体。" —— B, 量化研究员

2️⃣ 专业智能体团队：各司其职

Oh-My-OpenCode 不是单打独斗，而是一个完整的开发团队：

智能体职责为什么这样设计
Sisyphus主编排器、持续执行像团队负责人一样协调资源
Prometheus规划器制定策略，而非盲目执行
Oracle架构设计、复杂调试需要深度推理
Librarian官方文档、代码库探索擅长检索和组织信息
Explore极速代码库 grep（AST 感知）快速定位，上下文感知
Multimodal Looker图像/PDF 分析多模态能力

真实案例：45k 行 Tauri 应用 → 一夜之间转换成 SaaS Web 应用

"我使用 ohmyopencode 和 ralph loop 在一夜之间将一个 45k 行的 tauri 应用转换成了 SaaS Web 应用。看着它工作非常精彩，今早醒来发现网站基本上已经可以运行了！" — James Hargis

3️⃣ Hephaestus：自主深度工作者

在希腊神话中，赫菲斯托斯是神圣的铁匠——以无与伦比的精准和奉献打造武器。Oh-My-OpenCode 引入了 Hephaestus（GPT 5.2 Codex Medium）：合法的工匠代理。

Hephaestus 的革命性特性：

特性价值
目标导向给他目标，不是配方。他自己决定步骤。
行动前探索写代码前，并行启动 2-5 个 explore/librarian 代理。
端到端完成有验证证据证明 100% 完成之前不会停止。
模式匹配搜索现有代码库以匹配项目风格——没有 AI 垃圾。
合法的精准像大师铁匠一样编写代码——精准、最小化、只做需要的。

灵感来源：AmpCode 的深度模式——在采取决定性行动之前进行彻底研究的自主问题解决。

4️⃣ 🪄 魔法词：ultrawork（或 ulw）

不想读完文档？只需在你的提示中包含 ultrawork 或 ulw。

就这样。所有功能像魔法一样运行：

  • ✅ 并行智能体
  • ✅ 后台任务
  • ✅ 深度探索
  • ✅ 不懈执行直到完成

智能体自动理解其余的。其实，打 ulw 太费劲了。就 ulw。喝杯咖啡。你的工作完成了。

5️⃣ 并行智能体：像真正的开发团队

Oh-My-OpenCode 的后台智能体功能：

  • 并行运行多个智能体
  • 按提供商/模型配置并发限制
  • 像真正的开发团队一样协作

实际效果： Sisyphus 保持主智能体的上下文精简，向更快、更便宜的模型并行发起后台任务，让它们为他绘制地图。

6️⃣ Todo 继续执行器：强制完成

这是让 Sisyphus 继续推动巨石的关键：

  • ✅ 如果智能体中途退出，强制它继续
  • ✅ 你的任务会被完成，句号

真实案例："用 Oh My Opencode 仅用一天就清理了 8000 个 eslint 警告" — Jacob Ferrari

7️⃣ LSP & AST 工具：确定性重构
能力价值
重构像人类一样精确
重命名不遗漏任何引用
诊断精准定位问题
AST 感知代码搜索语义级别搜索，不是文本匹配

LSP 按文件自动激活：CSS（vscode-css-language-server），支持 .css, .scss, .sass, .less

8️⃣ 上下文智能管理：多智能体分担

Oh-My-OpenCode 积极利用多个智能体来减轻上下文负担：

  • 你的智能体现在是开发团队负责人
  • 你是 AI 经理

不再需要担心上下文管理，已经处理好了。

9️⃣ 开箱即用：电池已包含

所有功能默认启用。你不需要做任何事情：

  • ✅ 智能体团队
  • ✅ 后台任务
  • ✅ LSP/AST 支持
  • ✅ Todo 执行器
  • ✅ MCP 插件
🔟 注释检查器：保持代码库整洁
  • ✅ 防止 AI 添加过多注释
  • ✅ Sisyphus 生成的代码与人类编写的代码无法区分
1️⃣1️⃣ 精选 MCP：即时可用

开箱即用的 MCP 插件：

  • Exa：高质量网页搜索
  • Context7：官方文档智能查询
  • Grep.app：GitHub 代码搜索
1️⃣2️⃣ Claude Code 完整兼容性
  • ✅ Command
  • ✅ Agent
  • ✅ Skill
  • ✅ MCP
  • ✅ Hook（PreToolUse、PostToolUse、UserPromptSubmit、Stop）

📦 安装与配置

方式一：直接安装（推荐）

只需在 ~/.config/opencode/opencode.json 中添加插件：

{
  "plugin": [
    "opencode-antigravity-auth@latest",
    "oh-my-opencode@latest"
  ]
}

就是这样。直接安装就行。开箱即用，电池已包含。

方式二：让智能体安装

复制以下提示并粘贴到你的 LLM 智能体（Claude Code、AmpCode、Cursor 等）：

按照以下说明安装和配置 oh-my-opencode：
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md

我们强烈建议让智能体来处理。人会犯错，智能体不会。

⚙️ 核心配置详解

主配置文件：oh-my-opencode.json

配置文件位置：

  • 用户级：~/.config/opencode/oh-my-opencode.json
  • 项目级：.opencode/oh-my-opencode.json（优先级更高）

支持 JSONC（带注释和尾随逗号的 JSON）。

Agent 配置：专业化的智能体

以下是我的生产环境配置：

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "agents": {
    "sisyphus": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "oracle": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "librarian": {
      "model": "github-copilot/claude-sonnet-4.5"
    },
    "explore": {
      "model": "github-copilot/gemini-3-flash-preview"
    },
    "multimodal-looker": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "prometheus": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "metis": {
      "model": "github-copilot/claude-opus-4.5"
    }
  }
}
为什么这样配置？
Agent模型选择理由
sisyphusClaude Opus 4.5强推理，主编排需要深度思考
oracleClaude Opus 4.5架构设计和调试需要强推理
librarianClaude Sonnet 4.5文档搜索和代码组织，平衡速度和质量
exploreGemini 3 Flash100万+ tokens，快速代码库探索
multimodal-lookerClaude Opus 4.5多模态分析需要强推理
prometheusClaude Opus 4.5规划策略需要强推理
metisClaude Opus 4.5需求分析和歧义识别需要强推理

Category 配置：任务分类路由

{
  "categories": {
    "visual-engineering": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "ultrabrain": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "artistry": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "quick": {
      "model": "github-copilot/gemini-3-flash-preview"
    },
    "unspecified-low": {
      "model": "github-copilot/claude-sonnet-4"
    },
    "unspecified-high": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "writing": {
      "model": "github-copilot/claude-sonnet-4.5"
    }
  }
}

Sisyphus Agent 配置

{
  "sisyphus_agent": {
    "default_builder_enabled": true,
    "replace_plan": false
  }
}
  • default_builder_enabled：启用默认构建器
  • replace_plan：不替换原始计划（保留 Prometheus 的规划）

LSP 配置

{
  "lsp": {
    "css": {
      "command": ["vscode-css-language-server", "--stdio"],
      "extensions": [".css", ".scss", ".sass", ".less"]
    }
  }
}

后台任务配置

{
  "background_task": {
    "max_concurrent": 10
  }
}

配置并发限制，防止资源耗尽。

🛠️ MCP 插件生态

Oh-My-OpenCode 内置精选的 MCP 插件：

插件类型功能
Exaremote高质量网页搜索
Context7local官方文档智能查询
Grep.appremoteGitHub 代码搜索
Fetchlocal网页抓取与解析
Playwrightlocal浏览器自动化

额外 MCP 插件（需要手动配置）

{
  "mcp": {
    "deepwiki": {
      "enabled": true,
      "type": "remote",
      "url": "https://mcp.deepwiki.com/mcp"
    },
    "web-search-prime": {
      "enabled": true,
      "type": "remote",
      "url": "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp"
    },
    "zai-mcp-server": {
      "command": ["npx", "-y", "@z_ai/mcp-server"],
      "enabled": true,
      "type": "local"
    }
  }
}

📚 内置技能

Oh-My-OpenCode 内置实用技能：

技能功能
playwright浏览器自动化、网页测试
git-masterGit 高级操作（原子提交、历史搜索）

钩子系统

25+ 内置钩子，均可通过 disabled_hooks 配置：

  • PreToolUse：工具调用前
  • PostToolUse：工具调用后
  • UserPromptSubmit：用户提交提示时
  • Stop：智能体停止时

🚀 使用技巧与最佳实践

1️⃣ 使用 ultrawork 魔法词

# 在任何提示中包含 ultrawork 或 ulw
ulw: 重构这个 React 组件，添加 TypeScript 类型

# 智能体会自动：
# - 启动并行 explore/librarian 代理
# - 使用 LSP 进行确定性重构
# - 强制完成任务

2️⃣ 根据任务类型选择 Agent

# 快速代码库探索 - explore agent
# 自动路由到：gemini-3-flash-preview（100万+ tokens）

# 复杂架构设计 - oracle agent
# 自动路由到：claude-opus-4.5（强推理）

# 文档搜索 - librarian agent
# 自动路由到：claude-sonnet-4.5（平衡速度和质量）

# 多模态分析 - multimodal-looker agent
# 自动路由到：claude-opus-4.5（多模态强）

3️⃣ 利用并行智能体

Oh-My-OpenCode 会自动：

  • 并行启动多个 explore/librarian 代理
  • 按提供商/模型配置并发限制
  • 像真正的开发团队一样协作

你不需要手动管理，系统自动处理。

4️⃣ 上下文管理已优化

  • ✅ OhMyOpenCode 积极利用多个智能体来减轻上下文负担
  • ✅ 你的智能体现在是开发团队负责人
  • ✅ 你是 AI 经理

不再需要担心上下文窗口。

🔧 高级配置

禁用特定功能

如果不想启用所有功能，可以选择性禁用：

{
  "disabled_hooks": [
    "preToolUse",
    "postToolUse"
  ],
  "disabled_features": [
    "comment_checker",
    "todo_enforcer"
  ]
}

项目级配置

在项目根目录创建 .opencode/oh-my-opencode.json：

{
  "agents": {
    "sisyphus": {
      "model": "project-specific-model"
    }
  }
}

项目级配置优先级高于用户级配置。

环境变量

支持通过环境变量配置：

export OMO_MAX_CONCURRENT=10
export OMO_DEBUG=true

📈 真实案例

案例 1：清理 8000 个 ESLint 警告

"用 Oh My Opencode 仅用一天就清理了 8000 个 eslint 警告" — Jacob Ferrari

工作原理：

  1. Sisyphus 启动并行 explore 代理分析项目结构
  2. 利用 AST-Grep 进行语义级别的搜索和替换
  3. LSP 确保重构的确定性
  4. Todo 执行器强制完成所有警告的修复

案例 2：45k 行 Tauri 应用 → SaaS Web 应用

"我使用 ohmyopencode 和 ralph loop 在一夜之间将一个 45k 行的 tauri 应用转换成了 SaaS Web 应用。从访谈提示开始，要求它对问题进行评分和建议。看着它工作非常精彩，今早醒来发现网站基本上已经可以运行了！" — James Hargis

工作原理：

  1. Prometheus 制定详细迁移计划
  2. Hephaestus 自主深度工作者端到端完成
  3. 多个并行智能体协作
  4. 上下文智能管理处理大项目

案例 3：3 个月的工作 → 7 天 → 1 小时

"如果 Claude Code 能在 7 天内完成人类 3 个月的工作，那么 Sisyphus 只需 1 小时。它会持续工作直到任务完成。它是一个非常自律的智能体。" — B, 量化研究员

关键因素：

  • Todo 执行器强制完成
  • 并行智能体加速
  • LSP/AST 工具提升精度
  • 上下文智能管理

🎯 用户评价

"它让我取消了 Cursor 订阅。开源社区正在发生令人难以置信的事情。" — Arthur Guiot

"我还没能准确表达出它为什么如此出色，但开发体验已经达到了一个完全不同的维度。" — 苔硯:こけすずり

"用了 oh-my-opencode，你再也不会回头了" — d0t3ch

"你们应该把这个合并到核心代码并招募他。认真的。这真的非常非常非常好。" — Henning Kilset

"如果你能说服他的话就雇用 @yeon_gyu_kim，这个人彻底革新了 opencod" — [截断]

⚠️ 常见问题与解决方案

Q1: 为什么选择 oh-my-opencode 而不是其他插件？

A:

  • ✅ 完整的智能体团队，不只是工具集合
  • ✅ Hephaestus 自主深度工作者，目标导向执行
  • ✅ Todo 执行器，强制完成任务
  • ✅ LSP/AST 支持，确定性重构
  • ✅ 开箱即用，无需复杂配置
  • ✅ 24,000 美元 token 的实战经验融入

Q2: 如何切换模型？

在 oh-my-opencode.json 中修改对应 agent 或 category 的 model 字段：

{
  "agents": {
    "sisyphus": {
      "model": "your-preferred-model"
    }
  }
}

Q3: 如何添加新 MCP 插件？

在 opencode.json 的 mcp 字段中添加：

{
  "mcp": {
    "your-mcp": {
      "command": ["your-command"],
      "enabled": true,
      "type": "local"
    }
  }
}

Q4: 如何调试配置？

启用调试模式：

{
  "debug": true
}

或在环境变量中设置：

export OMO_DEBUG=true

Q5: 如何优化性能？

  1. 使用 Gemini 3 Flash 处理大文件（100万+ tokens）
  2. 合理设置并发限制：max_concurrent
  3. 利用并行智能体：系统自动管理
  4. 使用 LSP 重构：比文本替换更精确

📋 总结

Oh-My-OpenCode 的核心价值

特性价值
Sisyphus 主智能体像你的团队一样编码
专业智能体团队各司其职，协作高效
Hephaestus 自主工作者目标导向，自主决策
ultrawork 魔法词一键启动高级功能
并行智能体像真正的开发团队
Todo 执行器强制完成任务
LSP/AST 工具确定性重构
上下文智能管理多智能体分担负担
开箱即用默认启用所有功能
精选 MCPExa、Context7、Grep.app

与其他工具的对比

特性Oh-My-OpenCode其他工具
智能体团队✅ 完整团队❌ 单一智能体
并行执行✅ 后台智能体❌ 串行执行
强制完成✅ Todo 执行器❌ 可能半途而废
LSP/AST✅ 完整支持❌ 文本匹配
上下文管理✅ 多智能体分担❌ 单智能体负担
开箱即用✅ 默认启用❌ 需要复杂配置
开源✅ MIT 许可证⚠️ 闭源/部分开源

下一步建议

  1. 直接安装就行：添加插件到 opencode.json
  2. 使用 ulw 魔法词：一键启动高级功能
  3. 尝试不同的智能体组合：根据项目需求调整
  4. 探索 MCP 插件：扩展 AI 能力
  5. 加入社区：Discord

资源链接

🎓 作者札记

OpenCode 是 Debian/Arch，Oh-My-OpenCode 就是 Ubuntu。

我纯粹为个人开发使用了价值 24,000 美元 token 的 LLM。 尝试了每一个工具，把它们配置到极致。但始终是 OpenCode 胜出。

我遇到的每个问题的答案都融入了这个插件。直接安装使用。

不要再为智能体工具的选择而烦恼了。 我会进行研究，借鉴最好的，然后发布更新。

警告：生产力可能飙升太快。别让你的同事发现。

其实，我会传播这个消息。让我们看看谁会赢。

如果这篇文章对你有帮助，欢迎点赞、收藏、评论！有问题也欢迎在评论区讨论～

别忘了使用 ulw 魔法词，让智能体像真正的开发团队一样工作！

#AI编程 #OpenCode #OhMyOpenCode #Claude #开发工具 #Sisyphus #智能体 #编程助手

avatar
文章
阅读
粉丝