临夏回族自治州网站建设_网站建设公司_VPS_seo优化

Oh My OpenCode 深度使用教程：开启智能体协作的“超频”模式

1. 简介

Oh My OpenCode (OMO)是一款专为 OpenCode 打造的高级增强插件。它不仅仅是一个工具集，更是一套完整的“智能体工作流”。

通过 OMO，你的 OpenCode 将进化为一套能够并行思考、多模态协作、并拥有专业团队支撑的 AI 开发环境。它集成了最强的模型（如 Claude 3.7/4.5、GPT-5.2 等），并提供了一系列生产力工具，让你从“编写代码的人”转变为“管理 AI 团队的架构师”。

2. 功能特性

• 多智能体协作：内置专家级队友，涵盖架构设计、文档编写、前端开发等领域。
• 魔法词激活：通过ultrawork/ulw关键字一键开启极致工作模式。
• 后台并行任务：支持同时运行多个子智能体，告别等待。
• 专业级工具链：支持 LSP 重构、AST-grep 结构化搜索、Session 会话管理。
• Claude Code 兼容层：完美支持 Claude Code 的 Hooks、Skills、Commands 和 MCP。
• Sisyphus 永动机模式：Todo 强制执行机制，确保任务 100% 完成，不达目的不罢休。

3. 认识 Sisyphus (西西弗斯)

Sisyphus是 OMO 的核心主智能体（默认使用 Claude Opus 4.5）。在希腊神话中，西西弗斯受罚推石上山；而在 OMO 中，它象征着一种“不懈执行”的精神。

• 它的职责：接收你的原始需求，制定计划，拆解任务，并调度其他“专家智能体”去执行。
• 它的特点：极强的逻辑推理能力，超长的思维链路（Thinking Mode），以及对 TODO 列表的病态执着。只要石头还没推到山顶（任务未完成），它就会持续工作。

4. 环境要求

在开始之前，请确保你已具备：

• OpenCode: 已安装并可运行（建议版本 >= 1.0.150）。
• API 订阅: 建议拥有 Claude Pro/Max、ChatGPT Plus 或 Gemini 高级版订阅之一。
• Node.js/Bun: 用于运行安装命令。

5. 安装步骤

在你的终端中运行以下交互式安装命令：

npx oh-my-opencodeinstall# 或者使用 bunbunx oh-my-opencodeinstall

按照提示配置你的订阅情况。安装程序会自动：

1. 在opencode.json中注册插件。
2. 初始化用户层级的配置文件。
3. 引导你完成opencode auth login认证。

6. 配置说明

OMO 支持两级配置，采用 JSON/JSONC 格式（支持注释）。

配置文件路径

• 全局配置:~/.config/opencode/oh-my-opencode.json
• 项目配置:.opencode/oh-my-opencode.json
• Windows 备选:%APPDATA%\opencode\oh-my-opencode.json

第一步：注册插件 (opencode.json)

首先，需要在 OpenCode 主配置中注册 oh-my-opencode 插件：

{"$schema":"https://opencode.ai/config.json","plugin":["oh-my-opencode"]}

第二步：配置 OMO (oh-my-opencode.json)

为了获得最佳体验，你可以参考以下配置。建议在文件顶部加入$schema以获得 IDE 自动补全。

{"$schema":"https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json","agents":{"sisyphus":{"model":"anthropic/claude-opus-4-5","thinking":{"budget":32000}},"oracle":{"model":"openai/gpt-5.2"},"librarian":{"model":"anthropic/claude-sonnet-4-5"}},"background_task":{"defaultConcurrency":5,"providerConcurrency":{"anthropic":3,"openai":2}},"ralph_loop":{"enabled":true,"default_max_iterations":100},"claude_code":{"mcp":true,"hooks":true,"skills":true}}

7. 使用方法

🪄 魔法词 (Magic Keywords)

这是 OMO 最强大的特性。你不需要详细描述如何分工，只需在 Prompt 中包含魔法词：

• ultrawork/ulw: 激活“全火力”模式。Sisyphus 会自动启动后台搜索、调用专家、进行深度重构，直到任务彻底完成。
• ultrathink: 强制开启深度思考模式，适用于解决极其复杂的逻辑 Bug 或架构选型。
• search/find: 自动并行启动多个 Explore 智能体进行全量代码库扫描。

示例用法:

ulw 请重构整个登录模块，使用最新的 JWT 方案并添加完整的单元测试。

调用专家智能体

你可以直接在对话中通过@符号指派任务给特定队友：

• Ask @oracle 帮我分析这段代码的潜在并发风险。
• 让 @frontend-ui-ux-engineer 把这个列表页改成美观的响应式网格布局。
• @librarian 查找一下项目中所有使用了旧版 API 的地方。

8. 智能体战队 (The Team)

OMO 预置了一支专业的开发团队：

9. 后台智能体与并行执行

OMO 打破了传统 AI 对话“一问一答”的阻塞式限制。

• background_task: 当主智能体需要进行耗时的全库搜索或文档阅读时，它会启动一个后台任务并立即继续处理其他逻辑。
• 并行优势: 你可以同时让 Oracle 检查后端，Gemini 编写前端，而 Librarian 在外部文档中查找 API 示例。所有任务结果在完成后会自动同步给主智能体。

10. 高级工具集

OMO 为智能体配备了真正意义上的“开发者武器”：

LSP (Language Server Protocol)

不再仅仅是简单的 Grep 搜索，智能体现在可以使用：

• lsp_goto_definition: 精准跳转到定义。
• lsp_find_references: 查找全局引用。
• lsp_rename: 全局重构重命名（安全且彻底）。
• lsp_diagnostics: 在提交前获取编译器的错误和警告。

AST-grep

支持基于抽象语法树的结构化搜索与替换。例如：搜索所有“带两个参数且第一个参数为 string 的异步函数”，这在普通正则下几乎无法实现。

Session 管理

• session_search: 跨会话搜索之前的对话记忆。
• session_read: 回溯之前的执行细节。

11. Claude Code 兼容性

如果你习惯了 Claude Code，OMO 可以无缝接管你的资产：

• Hooks: 支持PreToolUse、PostToolUse等钩子，可实现自动 Linter 修复等功能。
• Skills: 放置在.claude/skills/下的工具包会被自动加载。
• MCP: 支持模型上下文协议。内置了Exa(网页搜索)、Context7(官方文档) 和Grep.app(GitHub 搜索)。

12. 高级配置选项 (Advanced)

禁用特定功能

{"disabled_agents":["frontend-ui-ux-engineer"],"disabled_hooks":["comment-checker","startup-toast"],"disabled_skills":["playwright"]}

Sisyphus 智能体配置

{"sisyphus_agent":{"disabled":false,"default_builder_enabled":false,"planner_enabled":true,"replace_plan":true}}

Ralph Loop 配置

{"ralph_loop":{"enabled":true,"default_max_iterations":100}}

• ralph_loop: 开启后，智能体会进入"自我迭代"循环，直到识别到<promise>DONE</promise>。
• comment_checker: 强制要求智能体在添加注释前进行辩解，减少代码中的"垃圾注释"。
• context_window_monitor: 当 Token 使用率超过 70% 时自动提醒智能体，防止因上下文挤压导致的回答质量下降。

智能体权限控制

{"agents":{"explore":{"permission":{"edit":"deny","bash":"ask","webfetch":"allow"}}}}

Claude Code 兼容性开关

{"claude_code":{"mcp":true,"commands":true,"skills":true,"agents":true,"hooks":true,"plugins":true}}

设置为false可禁用对应的 Claude Code 功能加载。

13. 常见问题 (Troubleshooting)

1. 认证失败: 运行opencode auth login重新登录。如果使用 Gemini，确保安装了opencode-antigravity-auth。
2. 任务中断: 包含ultrawork关键字，OMO 会激活 Todo 强制执行机制，自动尝试恢复中断的任务。
3. 模型限流: 在配置中增加providerConcurrency限制，或配置多账号负载均衡（针对 Gemini）。

14. 参考链接

• GitHub 仓库: code-yeongyu/oh-my-opencode
• 官方 Discord: 加入社区
• OpenCode 官方文档: opencode.ai

本教程由 Antigravity 智能体自动生成。人工审核，就像西西弗斯一样。