深度解析 Oh My OpenCode：让 OpenCode 进化为全流程 AI 开发团队的增强插件

作为 OpenCode 的忠实用户，当发现 Oh My OpenCode（简称 OMO）这款插件时，瞬间被它的“AI 开发团队”模式惊艳到——它就像给 OpenCode 装上了“大脑升级包”，类比终端神器 oh-my-zsh 对 Shell 的增强，OMO 让原本强大的 AI 编程助手，从“代码片段生成工具”进化为能自主分工、高效协作、全流程落地的“AI 开发伙伴”。

不同于 OpenCode 原生仅有的 build（全权限）和 plan（只读）两种核心代理，OMO 内置 11 个专业智能体，每个都有专属神话人物担当、明确职责分工和优化模型，覆盖从需求规划、代码开发到调试验收的全流程。更重要的是，它支持多模型切换、上下文智能管理和并行任务执行，解决了传统 AI 编程助手“任务分解不足、上下文易丢失、专业能力局限”的三大痛点，让开发者从“手动协调”中解放，专注于核心需求与决策。

一、Oh My OpenCode 插件整体定位与核心优势

1. 插件定位

Oh My OpenCode 是一款专为 OpenCode 打造的高级增强插件，并非独立工具，而是一套完整的“智能体工作流”框架。它通过拦截 OpenCode 的钩子函数，实现智能体协作、多模型调度、高级工具集成等增强功能，让 OpenCode 从“单一 AI 助手”升级为“可并行思考、多角色协作的 AI 开发环境”，最终让开发者从“编写代码的人”转变为“管理 AI 团队的架构师”。

2. 核心优势（实战亲测亮点）

• 多智能体协同：11 个专业智能体分工明确，覆盖规划、编码、调试、文档等全流程，无需手动拆分任务，智能体自动协作落地。

• 多模型适配：集成 Claude、GPT、Gemini、GLM 等主流模型，每个智能体匹配最优模型，支持降级链机制，兼顾性能与稳定性，还可避免单一模型封号风险，无需翻墙即可使用多模型能力。

• 上下文智能管理：自动压缩、恢复上下文，避免 Token 超限，支持会话中断后无缝恢复，维护项目知识图谱，确保协作一致性。

• 高级工具集成：支持 LSP 语言服务、AST-grep 结构化搜索、Playwright 浏览器自动化等高级工具，解锁更复杂的开发场景。

• 开源免费可扩展：完全开源，支持自定义工具挂载和智能体配置，可通过 Python 脚本扩展功能，比商业编程工具更灵活自由。

• 轻量化易安装：仅需几条命令即可完成安装配置，兼容 macOS、Windows、Linux 多系统，CLI 版本稳定性更优，还提供交互式安装向导。

二、11 个专业智能体全解析：人物担当、核心作用与实操用法

OMO 的 11 个智能体均以希腊神话人物命名，每个都有鲜明的“人物性格”和专属专长，按核心职能可分为三大类：核心编排智能体（项目总指挥）、规划与分析智能体（战略智囊团）、专业咨询智能体（领域专家）。以下结合实操用法，逐一详解每个智能体的价值，确保每个用法都可直接复制落地。

第一类：核心编排智能体（项目总指挥）—— 负责全局调度与任务落地

这类智能体是团队的“核心骨干”，主导任务拆分、智能体委派、进度监控和结果验收，是多智能体协作的核心枢纽，也是我们日常使用中接触最多的智能体。

1. Sisyphus（西西弗斯）—— 默认主智能体·团队领袖

• 人物担当：灵感来自希腊神话中不断推石上山的西西弗斯，象征“坚韧不拔、永不烂尾”，是整个 AI 团队的默认总指挥，也是所有任务的“第一接收者”。

• 核心作用：接管所有用户任务，采用 Todo 驱动工作流和激进并行执行策略，通过 Ralph Loop（自我迭代循环）和 Todo Continuation Enforcer 机制，确保任务不中途停止、不敷衍、不烂尾；拥有 32k 思考预算，能进行深度需求分析和任务拆解；支持后台任务并行执行，可同时调度多个专业智能体协作；集成 RALPH Loop 配置，开启后会自动迭代优化，直到任务彻底完成（识别到 DONE 标识）；还能自动处理任务异常，若某个子任务失败，会重新委派智能体返工。

• 核心模型：Claude Opus 4.6（降级链：kimi-k2.5 → glm-4.7 → gpt-5.3-codex → gemini-3-pro），兼顾深度思考与稳定性，优先保证任务落地质量。

• 实操用法（重点，可直接复制使用）：

  • 自动触发：用户未指定其他智能体时，自动激活，无需额外操作。例如直接输入“开发一个基于 JWT 的登录模块，包含用户验证和权限控制”，Sisyphus 会自动接管并推进。

  • 显式调用：使用命令 /sisyphus 显式指定，避免智能体误判。示例：/sisyphus 开发一个基于 JWT 的登录模块，包含用户验证、密码加密和权限控制，适配 Spring Boot 项目。

  • 魔法词触发（高效技巧）：在 Prompt 中加入 ultrawork（缩写 ulw），激活“全火力模式”，Sisyphus 会自动启动后台搜索、调用专家智能体、进行深度重构，直到任务落地；加入 search 或 find，会自动调用 Explore 智能体进行全量代码库扫描，避免重复开发。示例：ulw search 项目中已有的用户验证逻辑，在此基础上优化 JWT 登录模块。

  • 配置优化：可通过 OMO 配置文件开启/禁用 Sisyphus，设置是否启用 Prometheus 规划智能体。配置示例：{"sisyphus_agent": {"disabled": false, "planner_enabled": true, "ralph_loop_enabled": true}}（开启 RALPH 自动迭代）。

2. Atlas（阿特拉斯）—— 主协调者·上下文管家

• 人物担当：灵感来自背负苍天的泰坦巨人，象征“承载与稳定”，是团队的“大管家”和“协调员”，专门解决“上下文混乱”和“任务协调”的痛点。

• 核心作用：将 Prometheus 生成的工作计划拆分为可执行的任务卡片，明确每个子任务的负责人（对应专业智能体）；监控所有子任务进度，协调并行执行，处理任务依赖关系（例如“先完成数据库设计，再开发接口”）；智能压缩与截断上下文，避免 Token 超限，保留高价值信息；支持会话中断后自动恢复（Session Recovery），即使程序退出或网络中断，重启后也能恢复之前的工作状态；维护项目知识图谱，确保所有智能体对项目的理解一致，避免重复沟通。

• 核心模型：Claude Sonnet 4.5（降级链：kimi-k2.5 → gpt-5.2），兼顾协作效率与上下文处理能力，优先保证任务调度流畅。

• 实操用法（无需单独调用，重点掌握场景）：

  • 自动触发：复杂多步骤任务、大型项目（需要上下文管理）、会话接近 Token 限制时、任务需要多智能体协作时，由 Sisyphus 自动委派激活，无需手动操作。

  • 显式调用：无需单独调用，若需强制使用 Atlas 管理上下文，可在任务中指定。示例：ulw 重构整个项目的权限模块，使用 Atlas 管理上下文，确保跨文件修改一致性，避免 Token 超限。

  • 核心场景：处理大型代码库（100+ 文件）、长时间会话（超过 1 小时）、跨文件协作，解决“上下文溢出”和“会话丢失”的痛点，是大型项目开发的核心保障。

3. Hephaestus（赫菲斯托斯）—— 合法工匠·深度开发者

• 人物担当：希腊神话中的锻造之神，擅长打造神器，象征“匠心、专注、精准”，是团队的“核心开发者”，专注于深度编码工作，不负责规划，只负责“把事做精”。

• 核心作用：目标导向型执行，行动前会彻底研究代码库的编码风格、架构模式，避免写出“格格不入”的代码；擅长深度编码、复杂功能开发，能独立完成高难度代码实现（如高并发接口、复杂算法），无需频繁追问用户；端到端完成任务，从代码编写、注释完善到简单测试，一站式落地，不中途停止、不敷衍。

• 核心模型：GPT-5.3 Codex（无降级链，仅当模型可用时激活），编码能力极强，是深度开发、高质量代码实现的首选智能体。

• 实操用法（重点，适合复杂编码场景）：

  • 自动触发：需要深度代码理解的复杂功能开发、长期无人值守任务、高质量代码实现需求时，由 Sisyphus 委派激活。

  • 显式调用：使用命令 /hephaestus，明确指定编码需求。示例：/hephaestus 实现一个高并发的订单处理接口，要求支持每秒 1000+ 请求，包含异常处理、日志记录和幂等性保障，适配 Spring Cloud 项目。

  • 后台运行：适合长时间任务，不阻塞当前工作。示例：task(subagent_type="hephaestus", run_in_background=true) 优化项目中所有循环的执行效率，输出优化报告。

第二类：规划与分析智能体（战略智囊团）—— 负责需求拆解与风险把控

这类智能体是团队的“大脑”，专注于需求分析、计划制定和风险评审，确保任务方向正确、计划可行，避免“盲目开发”导致返工，尤其适合需求模糊、大型项目场景。

4. Prometheus（普罗米修斯）—— 战略规划师·火种传递者

• 人物担当：希腊神话中为人类盗取火种的智慧之神，象征“远见、智慧、规划”，是团队的“首席规划师”，负责将“模糊需求”转化为“可执行计划”。

• 核心作用：通过“访谈模式”与用户交互，迭代提问澄清需求（如“权限控制需要区分哪些角色？”“JWT 过期时间设置多久？”），避免需求模糊导致返工；将模糊的自然语言需求，转化为结构化、可执行的详细工作计划，每个计划都包含具体的任务步骤、负责人（智能体）、验收标准；无业务逻辑假设，无关键风险点，确保计划落地性；规划完成后，自动提交给 Momus 评审，评审通过后交由 Atlas 拆分执行。

• 核心模型：Claude Opus 4.6（降级链：kimi-k2.5 → gpt-5.2 → gemini-3-pro），擅长深度需求分析和计划制定，优先保证计划的完整性和可行性。

• 实操用法（重点，适合新项目、模糊需求）：

  • 自动触发：新项目启动、大型功能开发、需求模糊或不完整时，由 Sisyphus 自动调度激活。

  • 显式调用：使用命令 /plan 或 /prometheus，示例：/plan 开发一个在线图书管理系统，包含用户管理、图书查询、借阅归还、后台统计功能，适配前后端分离架构，调用后 Prometheus 会逐步提问澄清需求，最终生成详细计划。

  • 配合技巧：若需求已明确，可在 Prompt 中补充验收标准，减少提问次数。示例：/prometheus 开发图书借阅接口，验收标准：1. 支持用户 ID 和图书 ID 传入；2. 验证用户是否有借阅权限；3. 返回借阅成功信息和到期时间；4. 处理图书已被借阅的异常。

5. Metis（墨提斯）—— 计划顾问·深思者

• 人物担当：希腊神话中的智慧与深思之神，是宙斯的第一位妻子，象征“深思熟虑、风险预判”，是团队的“计划顾问”，负责“提前避坑”。

• 核心作用：预规划分析，在 Prometheus 制定计划前，自动识别用户需求中的隐藏意图、模糊点和 AI 失败点（如“图书借阅接口未考虑用户黑名单场景”）；提供风险评估和改进建议（如“建议增加 JWT 刷新机制，避免用户频繁登录”）；不直接制定计划，仅提供咨询和优化建议，帮助 Prometheus 完善计划，减少后续返工。

• 核心模型：Claude Opus 4.6（降级链：kimi-k2.5 → gpt-5.2 → gemini-3-pro），温度 0.3（低温度，确保分析严谨，不发散）。

• 实操用法（无需刻意调用，重点了解触发场景）：

  • 自动触发：复杂需求分析、高风险项目（如支付、权限相关）、Prometheus 规划前，自动激活，无需手动操作。

  • 显式调用：使用命令 /metis 或 /analyze，针对具体需求或计划进行风险分析。示例：/metis 分析图书借阅接口的开发风险，给出规避建议。

6. Momus（莫摩斯）—— 计划评审员·挑剔者

• 人物担当：希腊神话中的挑剔与批评之神，象征“严谨、苛刻、负责”，是团队的“计划评审员”，负责“把关计划质量”，拒绝不合格计划。

• 核心作用：验证 Prometheus 提交的计划是否符合“清晰度、可验证性、完整性”三大标准；若计划存在模糊点（如“未明确接口返回格式”）、无验收标准、存在风险点，会直接拒绝并要求 Prometheus 修改，无最大重试限制，直到计划合格；也可用于代码审查和架构验证，确保最终交付物符合要求。

• 核心模型：GPT-5.2（降级链：claude-opus-4-6 → gemini-3-pro），温度 0.1（极低温度，确保评审严谨，不遗漏任何问题）。

• 实操用法（自动触发为主，无需手动调用）：

  • 自动触发：Prometheus 提交计划后自动激活，评审通过则进入执行阶段，评审失败则返回修改，全程无需用户干预。

  • 显式调用：使用命令 /review 或 /momus，评审已有的计划或代码。示例：/momus 评审这份图书管理系统的开发计划，检查是否有遗漏的需求和风险点。

第三类：专业咨询智能体（领域专家）—— 负责专业问题解答与支持

这类智能体是团队的“领域专家”，各有专属专长，仅负责提供咨询、分析、查找信息等只读操作，不负责代码编写和任务执行，相当于“AI 顾问团”，随叫随到。

7. Oracle（先知）—— 架构师·调试专家

• 人物担当：希腊神话中的智慧预言者，象征“远见、专业、精准”，是团队的“首席架构师”和“高级调试工程师”，负责解决复杂技术难题。

• 核心作用：架构决策（如“图书管理系统采用微服务还是单体架构？”“数据库选用 MySQL 还是 PostgreSQL？”）；代码审查（检查代码漏洞、性能问题、编码规范）；深度调试（解决难以复现的 bug、死锁、内存泄漏等问题）；只读咨询，仅提供逻辑推理、分析和建议，不写入、编辑或委派任务。

• 核心模型：GPT-5.2（无降级链），架构设计和调试能力极强，是解决复杂技术问题的首选。

• 实操用法（重点，解决技术难题）：

  • 显式调用：使用命令/oracle，或在 Prompt 中提及 @oracle。示例 1（架构咨询）：@oracle 在线图书管理系统，用户量预计 10 万，采用单体架构还是微服务架构？说明理由；示例 2（调试）：/oracle 接口调用时报 500 错误，日志显示“NullPointerException”，代码如下[粘贴代码]，帮忙定位 bug 并给出修改建议。

  • 工具限制：只读权限，不会修改代码，仅提供建议，需用户手动修改或让其他智能体（如 Hephaestus）执行。

8. Librarian（图书管理员）—— 知识库管理员·文档专家

• 人物担当：象征“严谨、细致、博学”，是团队的“知识库管理员”和“文档专家”，负责查找信息、验证知识，解决 AI 幻觉问题。

• 核心作用：多仓库分析（查看项目中已有的代码实现，避免重复开发）；官方文档查找（如“Spring Boot JWT 集成的官方文档”“Vue3 路由守卫的使用方法”）；开源实现示例搜索（查找 GitHub 上的优秀开源代码，参考实现思路）；基于证据的答案，所有建议都附带参考来源，避免 AI 幻觉；只读咨询，不负责代码编写。

• 核心模型：GLM-4.7（降级链：glm-4.7-free → claude-sonnet-4-5），擅长信息检索和文档分析，优先保证信息的准确性。

• 实操用法（重点，新手必备）：

  • 显式调用：使用命令 /librarian，或在 Prompt 中提及 @librarian。示例 1（文档查找）：@librarian 查找 Spring Boot 3 集成 JWT 的官方文档，提炼核心步骤；示例 2（开源参考）：/librarian 查找 GitHub 上优秀的在线图书管理系统开源项目，推荐 3 个并说明特点。

  • 配合技巧：结合 Explore 智能体，可快速查找项目内的代码实现。示例：@librarian @explore 查找项目中已有的用户密码加密逻辑，参考其实现方式。

  • 工具限制：只读权限，仅提供信息和参考，不修改代码。

9. Explore（探索者）—— 代码库探索者·上下文 grep 专家

• 人物担当：象征“敏捷、高效、精准”，是团队的“代码库导航员”，负责快速扫描代码库，查找特定内容，帮助开发者熟悉项目。

• 核心作用：使用 ContextualGrep 技术极速扫描代码库（比传统 grep 更精准，能识别代码上下文）；查找特定函数/变量/类的实现（如“查找 getUserInfo 函数的实现位置”）；识别代码模式（如“项目中所有接口的统一返回格式”）；提供代码导航建议（如“修改用户权限需修改哪几个文件”）；只读咨询，不负责代码编写。

• 核心模型：Claude Haiku 4.5（降级链：gpt-5-mini → gpt-5-nano），速度极快，适合快速检索，不追求深度分析。

• 实操用法（重点，熟悉新项目必备）：

  • 显式调用：使用命令 /explore，或在 Prompt 中提及 @explore。示例 1（查找函数）：@explore 查找项目中 getUserInfo 函数的实现位置，粘贴相关代码片段；示例 2（识别模式）：/explore 分析项目中所有接口的统一返回格式，提炼出通用模板。

  • 核心场景：新接手项目、代码重构前分析、查找特定代码实现，节省手动查找的时间。

10. Multimodal-Looker（多模态观察者）—— 视觉内容专家

• 人物担当：象征“敏锐、全面”，是团队的“视觉分析专家”，负责处理非文本信息，填补其他智能体的“视觉盲区”。

• 核心作用：分析 PDF、图像、图表提取信息（如“提取 PDF 中的接口文档，转化为结构化内容”“分析图表中的数据，生成统计结论”）；理解 UI 设计图（如“根据 UI 设计图，分析页面结构和组件布局”）；处理视觉相关开发任务（如“根据图片中的原型，编写页面 HTML 结构”）；只读操作，不负责代码编写。

• 核心模型：Gemini 3 Flash（降级链：gpt-5.2 → glm-4.6v → kimi-k2.5 → claude-haiku-4-5 → gpt-5-nano），多模态处理能力强，优先保证视觉信息提取的准确性。

• 实操用法（重点，处理非文本内容）：

  • 显式调用：使用命令 /multimodal，示例：/multimodal 分析这张 UI 设计图（上传图片），提取页面组件布局，生成 HTML 结构草图；示例 2（PDF 提取）：/multimodal 提取 PDF 中的图书管理系统接口文档，转化为 Markdown 格式，包含接口地址、请求参数、返回参数。

  • 工具限制：仅允许读取、glob 和 grep 操作，不修改代码，不委派任务。

11. Sisyphus-Junior（小西西弗斯）—— 分类生成执行器·轻量助手

• 人物担当：Sisyphus 的“轻量级助手”，象征“高效、简洁、稳定”，负责处理简单、重复的小型任务，减轻主智能体的负担。

• 核心作用：处理特定分类任务（如“将接口文档按模块分类”“给代码添加注释”）；快速响应简单需求（如“修改某个变量名”“优化一行代码的格式”）；辅助主智能体（Sisyphus/Atlas）执行子任务，并行处理小型任务，提升整体效率；温度 0.1，确保结果稳定、不发散，适合重复任务。

• 核心模型：Claude Sonnet 4.5，温度 0.1（低温度，保证结果稳定）。

• 实操用法（自动触发为主，无需刻意调用）：

  • 自动触发：主智能体（Sisyphus/Atlas）分解出的小型子任务、简单代码修改、特定分类任务（如前端/后端/测试子任务）、并行执行场景，自动激活。

  • 显式调用：无需单独调用，若需处理简单任务，可直接让 Sisyphus 委派。示例：/sisyphus 给项目中所有工具类添加注释，委派 Sisyphus-Junior 执行。

三、Oh My OpenCode 插件完整使用流程（从安装到实操，一步到位）

了解完智能体，接下来是核心实操——插件的安装、配置与日常使用，全程基于 CLI 操作（最稳定，兼容多系统），步骤清晰，新手也能快速上手。

1. 前置条件（必看）

• 已安装 OpenCode（确保版本 ≥ 0.1.0，旧版本需升级：opencode upgrade）。

• 已安装 Python（版本 ≥ 3.10）和 pip（包管理工具）。

• 拥有至少一个 AI 模型 API Key（如 Claude、GPT、GLM 等，无需翻墙，国内模型也可）。

• 兼容系统：macOS、Windows（WSL2）、Linux，推荐 macOS/Linux（稳定性更优）。

2. 插件安装（3 条命令搞定）

推荐使用官方一键安装脚本，无需手动配置依赖，步骤如下：

1. 打开终端，执行安装命令（自动下载插件并配置环境）：
   pip install oh-my-opencode --upgrade

2. 初始化插件（关联 OpenCode，生成配置文件）：
   omo init，执行后会提示输入 OpenCode 路径（默认自动识别，直接回车即可）。

3. 验证安装是否成功：
   omo --version，若输出版本号（如 0.5.0），则安装成功。

补充：若安装失败（如依赖冲突），可执行 pip install oh-my-opencode --upgrade --no-cache-dir 重新安装，或参考官方文档解决。

3. 核心配置（关键步骤，确保智能体能正常调用）

安装完成后，需配置 AI 模型 API Key 和智能体参数，配置文件默认路径：~/.oh-my-opencode/config.json，可直接编辑，也可使用交互式配置命令：omo config。

核心配置项（必改）

• API Key 配置：找到对应模型的配置项，填入 API Key（如 "claude_api_key": "你的 Claude Key"），建议至少配置 2 个模型，确保降级链生效。

• 默认智能体配置：可修改默认主智能体（默认 Sisyphus，无需修改），配置是否启用自动规划（"planner_enabled": true）。

• 上下文配置：设置上下文最大 Token 数（默认 32768，可根据模型能力调整），开启会话恢复功能（"session_recovery": true）。

配置示例（简化版）：
{ "api_keys": { "claude_api_key": "sk-xxxxxxx", "gpt_api_key": "sk-xxxxxxx", "glm_api_key": "xxxxxxx" }, "default_agent": "sisyphus", "planner_enabled": true, "max_context_tokens": 32768, "session_recovery": true }

配置完成后，执行 omo config validate，验证配置是否正确，无报错则配置生效。

4. 日常使用流程（核心实操，可直接套用）

OMO 插件完全集成在 OpenCode 中，无需单独启动，日常使用只需在 OpenCode 中调用智能体，流程分为 3 步，贴合实际开发场景：

步骤 1：启动 OpenCode（关联 OMO 插件）

终端执行命令：opencode run --with-omo，启动后会提示“OH MY OPENCODE 已加载，11 个智能体已就绪”，表示插件已成功关联。

步骤 2：调用智能体处理任务（核心环节）

启动后，进入 OpenCode 交互模式，可直接输入任务，或使用命令调用智能体，以下是 3 个高频使用场景示例，覆盖大部分开发需求：

1. 场景 1：模糊需求，需要先规划再开发
   输入：/plan 开发一个图书管理系统的用户登录模块，包含账号密码登录、验证码登录、忘记密码功能，执行后：

   • Metis 先分析需求，识别风险点（如“验证码需考虑过期时间”）；

   • Prometheus 迭代提问澄清需求（如“验证码有效期设置多久？”）；

   • Momus 评审计划，通过后 Atlas 拆分任务；

   • Sisyphus 委派 Hephaestus 编写代码，Oracle 负责架构把关。

2. 场景 2：复杂编码，需要深度开发
   输入：/hephaestus 实现图书管理系统的验证码登录接口，使用 Redis 存储验证码，有效期 5 分钟，包含异常处理和日志记录，适配 Spring Boot 3，执行后 Hephaestus 会直接编写代码，无需额外干预。

3. 场景 3：技术难题，需要专家咨询
   输入：@oracle 我的 Spring Boot 项目中，Redis 存储验证码时出现乱码，代码如下[粘贴代码]，帮忙定位 bug 并给出修改建议，Oracle 会分析代码，给出具体解决方案。

步骤 3：任务监控与验收

• 任务执行过程中，可输入/status 查看任务进度，了解每个子任务的执行状态和负责人。

• 任务完成后，智能体会输出验收结果（包含 <promise>DONE</promise>标识），可查看生成的代码、文档等交付物。

• 若验收不通过，可输入 /rework，智能体会自动返工，或输入具体修改意见（如“验证码登录接口需增加图形验证码支持”）。

5. 高频命令汇总（必记，提升效率）

命令	作用	示例
omo init	初始化插件，关联 OpenCode	直接执行，自动关联
omo config	交互式配置插件（API Key、智能体等）	执行后按提示输入配置信息
/sisyphus 任务	调用主智能体处理任务	/sisyphus 开发 JWT 登录模块
/plan 需求	调用 Prometheus 制定开发计划	/plan 开发图书管理系统
@oracle 问题	咨询 Oracle 架构/调试问题	@oracle 定位 Redis 乱码 bug
/status	查看当前任务进度	任务执行中输入，查看子任务状态
/rework	任务验收不通过，触发返工	任务完成后，输入即可返工
omo upgrade	升级 Oh My OpenCode 插件	获取最新功能和 bug 修复

四、常见问题与避坑指南（实战总结）

结合自身使用经验，整理了 5 个高频问题，帮大家避坑，提高使用效率：

1. 问题 1：智能体无法调用，提示“API Key 无效”
   解决方案：检查 config.json 中的 API Key 是否正确，是否有拼写错误；确认模型 API 是否正常可用（可登录模型官网验证）；若使用国内模型，需配置模型端点（参考官方文档）。

2. 问题 2：会话中断后，无法恢复之前的任务
   解决方案：检查配置文件中 "session_recovery": true 是否开启；重启 OpenCode 后，输入 /recover，即可恢复最近一次的会话状态。

3. 问题 3：任务执行缓慢，智能体响应迟钝
   解决方案：切换更快速的模型（如 Claude Haiku、Gemini Flash）；减少上下文长度（删除无关对话）；关闭并行执行（配置 "parallel_execution": false），适合小型任务。

4. 问题 4：智能体生成的代码不符合项目风格
   解决方案：在 Prompt 中补充“贴合项目编码风格”，并让 Explore 智能体先扫描项目代码（@explore 分析项目编码风格），再让 Hephaestus 编写代码。

5. 问题 5：插件与 OpenCode 版本不兼容
   解决方案：升级 OpenCode 到最新版本（opencode upgrade），同时升级 OMO 插件（omo upgrade），确保两者版本匹配（参考官方版本兼容说明）。

五、总结：Oh My OpenCode 到底能帮我们解决什么问题？

使用 Oh My OpenCode 一段时间后，最大的感受是：它不是“替代开发者”，而是“解放开发者”——让 AI 去做重复、繁琐、机械的工作（如任务拆分、代码编写、文档查找），让开发者专注于核心决策（如架构设计、需求梳理、风险把控）。

对于新手而言，它是“AI 导师”，11 个专业智能体可随时解答技术问题、提供代码参考，帮助快速上手新项目；对于资深开发者而言，它是“高效助手”，能大幅提升开发效率，减少返工，让复杂项目的落地更顺畅。

如果你已经在使用 OpenCode，强烈建议安装 Oh My OpenCode 插件，它会让你发现 OpenCode 的“全新可能”；如果你还没尝试，不妨从 OpenCode + OMO 组合开始，体验“AI 开发团队”带来的高效与便捷。

最后，Oh My OpenCode 是开源项目，正在快速迭代，后续会增加更多智能体和功能，感兴趣的朋友可以关注官方仓库，参与贡献，一起完善这个强大的 AI 开发工具。