Oh My OpenCode 插件
确保已安装 Node.js 18+ 和包管理器(npm/bun/yarn/pnpm)。
# 推荐:使用 bunx(最快)bunx oh-my-opencode install
# 或使用 npmnpm install -g oh-my-opencode
# 或使用其他包管理器bun install -g oh-my-opencodeyarn global add oh-my-opencodepnpm add -g oh-my-opencode# 检查代理是否加载opencode agent list
# 应显示类似以下输出:# sisyphus (primary)# oracle (primary)# librarian (primary)# explore (subagent)# prometheus (primary)# ...内置代理简介
Section titled “内置代理简介”Oh My OpenCode 提供 10+ 个专业化代理,每个代理针对特定任务优化。以下是各代理的推荐模型配置:
| 代理 | 推荐模型 | 职责 | 适用场景 |
|---|---|---|---|
| Sisyphus | Claude Opus 4.6 / Kimi-K2.5 / GLM-5 | 主编排器,规划任务、委派子任务、驱动完成 | 复杂开发任务、日常编码 |
| Hephaestus | GPT-5.3-Codex / Claude Sonnet 4.6 | 自主深度工作者,端到端执行无需手把手指导 | 大型功能开发、架构重构 |
| Prometheus | Claude Opus 4.6 / Kimi-K2.5 / GLM-5 | 战略规划师,采访式需求分析后生成计划 | 复杂多日项目、新功能规划 |
| Oracle | Claude Opus 4.6 / GPT-5.2 / DeepSeek-V3.2 | 架构决策、复杂调试、代码审查 | 架构设计、调试失败后求助 |
| Librarian | Gemini 3.1 Flash / Grok Code Fast / Qwen3-Coder-Next | 文档查询、OSS 实现示例搜索 | 查询第三方库文档、找开源实现 |
| Explore | Gemini 3.1 Flash / Claude Haiku 4.5 / Qwen3-Coder-Next | 代码库模式搜索、结构理解 | 理解新代码库、找代码模式 |
| Metis | Claude Sonnet 4.6 / GPT-5 | 计划前顾问,分析隐藏意图和失败点 | 复杂任务的范围澄清 |
| Momus | Claude Sonnet 4.6 / GPT-5 | 计划审查员,检查计划的完整性和清晰度 | 验证生成计划的质量 |
| Multimodal Looker | Gemini 3.1 Pro / Claude Sonnet 4.6 | 图像、PDF、图表分析 | 截图分析、文档解读 |
模型推荐详解
Section titled “模型推荐详解”编排与规划类代理(Sisyphus、Prometheus)
| 优先级 | Anthropic | OpenAI | 开源模型 |
|---|---|---|---|
| 首选 | Claude Opus 4.6 | - | Kimi-K2.5、GLM-5 |
| 次选 | Claude Sonnet 4.6 | GPT-5.2 | DeepSeek-V3.2 |
- Claude Opus 4.6: SWE-bench Verified 80.8%,最适合多代理协调和深度推理
- Kimi-K2.5: 开源首选,SWE-bench 领先,支持大规模上下文
- GLM-5: 国产开源旗舰,代理编排能力强
代码生成与深度工作(Hephaestus)
| 优先级 | Anthropic | OpenAI | 开源模型 |
|---|---|---|---|
| 首选 | Claude Sonnet 4.6 | GPT-5.3-Codex | Qwen3-Coder-480B |
| 次选 | Claude Opus 4.6 | GPT-5.2-Codex | DeepSeek-Coder-V2 |
- GPT-5.3-Codex: OpenAI 专为代理编码优化的旗舰,Terminal-Bench 77.3%
- Claude Sonnet 4.6: SWE-bench 79.6%,性价比极高($3/$15 vs Opus $15/$75)
- Qwen3-Coder-480B: 开源最佳,SWE-bench 70.6%,MoE 架构高效
调试与架构(Oracle)
| 优先级 | Anthropic | OpenAI | 开源模型 |
|---|---|---|---|
| 首选 | Claude Opus 4.6 | GPT-5.2 xHigh | DeepSeek-V3.2-Speciale |
| 次选 | Claude Sonnet 4.6 | GPT-5 | Kimi-Dev-72B |
- Claude Opus 4.6: GPQA Diamond 91.3%,最适合复杂推理
- DeepSeek-V3.2-Speciale: 开源最强推理,AIME 2025 87.5%
快速任务与搜索(Librarian、Explore)
| 优先级 | Anthropic | OpenAI/Google | 开源模型 |
|---|---|---|---|
| 首选 | Claude Haiku 4.5 | Gemini 3.1 Flash | Qwen3-Coder-Next |
| 次选 | Claude Sonnet 4.6 | GPT-5 Nano | Grok Code Fast |
- Gemini 3.1 Flash: 最快最便宜,$0.25/$1.50 per 1M tokens
- Claude Haiku 4.5: 高吞吐量低延迟,适合批量任务
- Qwen3-Coder-Next: 仅 3B 活跃参数,本地运行友好
使用 ultrawork 命令
Section titled “使用 ultrawork 命令”安装后,最简单的使用方式是输入 ultrawork(或简写 ulw):
ultrawork 实现用户登录功能,包括表单验证和错误处理这会自动:
- 启动 Sisyphus 作为主编排器
- 并行委派任务到专业代理
- 持续工作直到任务完成
使用特定代理
Section titled “使用特定代理”通过 @ 符号调用特定代理:
@oracle 为什么这个异步函数会导致竞态条件?@librarian 查找 React useEffect 的最佳实践文档@explore 找到项目中所有使用 Redux 的地方对于复杂项目,先用 Prometheus 生成计划:
/start-work这会进入采访模式,Prometheus 会询问需求细节,然后生成详细的实施计划。
配置文件位置
Section titled “配置文件位置”Oh My OpenCode 配置文件位于:
| 配置类型 | 路径 |
|---|---|
| 全局配置 | ~/.config/opencode/oh-my-opencode.json |
| 项目配置 | .opencode/oh-my-opencode.json |
如需卸载:
# 移除插件配置jq '.plugin = [.plugin[] | select(. != "oh-my-opencode")]' \ ~/.config/opencode/opencode.json > /tmp/oc.json && \ mv /tmp/oc.json ~/.config/opencode/opencode.json
# 删除配置文件(可选)rm -f ~/.config/opencode/oh-my-opencode.json