8、Oh-My-OpenCode快速上手指南

什么是 Oh My OpenCode

Oh My OpenCode（OMO）是 OpenCode 的增强配置框架，提供开箱即用的智能体（Agent）和自动化功能。

核心特点：

29K+ GitHub Stars
开源免费，无供应商锁定
多模型编排支持
20+ 内置工作流钩子
Sisyphus 主智能体编排器

与原生 OpenCode 对比：
| 特性 | 原生 OpenCode | Oh My OpenCode |
|------|--------------|---------------|
| 安装 | 手动配置 | 交互式安装 |
| 智能体 | 基础 | 专业分工 |
| 工作流 | 无 | 自动化钩子 |
| 配置 | 基础 JSON | 高级配置 |

安装 Oh My OpenCode

最最最简洁安装

进入opencode
输入当前系统是windows 安装 oh-my-opencode 回车坐等AI帮你安装；

方式一：交互式安装（推荐）

bunx oh-my-opencode install

安装过程会询问：

AI 提供商选择（Claude、OpenAI、Gemini 等）
API 密钥配置
自动生成最优配置

方式二：Bun 安装

先安装bun，因为已经安装了node 则执行
npm install -g bun
安装成功后 安装 oh-my-opencode
bun install oh-my-opencode

方式三：手动安装

git clone https://github.com/code-yeongyu/oh-my-opencode.git
cd oh-my-opencode
bun install

配置 AI API

支持的提供商

Anthropic Claude
OpenAI GPT-4/GPT-5
Google Gemini
本地模型（Ollama）

配置文件位置

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

配置示例

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "agents": {
    "oracle": { "model": "anthropic/claude-3-5-sonnet" },
    "librarian": { "model": "openai/gpt-4" }
  },
  "providers": {
    "anthropic": {
      "apiKey": "{env:ANTHROPIC_API_KEY}"
    }
  }
}

核心智能体系统

Oh My OpenCode 包含多个专业智能体：

1. Sisyphus（主编排器）

默认智能体，负责任务规划和执行
智能分解复杂任务
系统化执行和验证

2. Oracle（问题诊断）

复杂逻辑和架构分析
调试问题解决方案
代码审查和优化建议

3. Librarian（文档检索）

文档搜索和代码探索
外部参考资料查找
API 文档查询

4. Explore（代码分析）

项目结构和模式分析
代码库搜索
跨文件引用查找

5. Metis & Momus（规划验证）

计划分析和验证
工作流审查
质量保证

第五步：配置智能体

基础配置

{
  "agents": {
    "build": {
      "model": "anthropic/claude-3-5-sonnet",
      "enabled": true
    },
    "plan": {
      "model": "openai/gpt-4",
      "enabled": true
    }
  }
}

智能体分类系统

| 分类 | 用途 | 特点 |
|------|------|------|
| visual-engineering | 前端 UI/UX | 界面设计 |
| ultrabrain | 复杂逻辑 | 深度推理 |
| deep | 问题解决 | 自主研究 |
| artistry | 创意方案 | 非传统方法 |
| quick | 简单任务 | 快速执行 |

第六步：配置 LSP 支持

添加语言服务器支持：

{
  "lsp": {
    "typescript": {
      "enabled": true,
      "command": "typescript-language-server",
      "args": ["--stdio"]
    },
    "python": {
      "enabled": true,
      "command": "pylsp"
    }
  }
}

配置 MCP 服务器

基础 MCP 配置

{
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp"
    },
    "sentry": {
      "type": "remote",
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

MCP 管理命令

# 列出所有 MCP 服务器
oh-my-opencode mcp list

# 认证服务器
oh-my-opencode mcp auth <名称>

# 调试连接
oh-my-opencode mcp debug <名称>

使用工作流钩子

Oh My OpenCode 提供 20+ 内置钩子：

常用钩子

| 钩子名称 | 触发时机 | 用途 |
|----------|---------|------|
| todo_continuation | 任务继续 | 自动恢复进度 |
| task_completion | 任务完成 | 清理和验证 |
| error_handler | 错误发生 | 自动修复 |

配置钩子

{
  "hooks": {
    "todo_continuation": {
      "enabled": true
    },
    "task_completion": {
      "enabled": true
    }
  }
}

常用 CLI 命令

基础命令

# 启动 Oh My OpenCode
oh-my-opencode

# 启动指定项目
oh-my-opencode /path/to/project

# 继续上次会话
oh-my-opencode --continue

# 指定会话继续
oh-my-opencode --session <session-id>

MCP 命令

# 认证 MCP 服务器
oh-my-opencode mcp auth <名称>

# 查看 MCP 服务器列表
oh-my-opencode mcp list

# 调试 MCP 连接
oh-my-opencode mcp debug <名称>

# 移除认证
oh-my-opencode mcp logout <名称>

智能体协同工作

工作流程示例

1. 用户发起复杂任务
   ↓
2. Sisyphus 接收任务并分解
   ↓
3. 根据任务类型分发：
   - 代码审查 → Oracle
   - 文档查询 → Librarian
   - 代码搜索 → Explore
   - 前端开发 → visual-engineering
   ↓
4. 子智能体执行并返回结果
   ↓
5. Sisyphus 整合结果并验证
   ↓
6. 返回最终答案

任务委派策略

简单任务 → 直接执行
中等任务 → 规划后执行
复杂任务 → 多智能体协作

常见问题

问题1：安装失败

# 确保 Bun 已安装
bun --version

# 清理缓存重试
bunx oh-my-opencode install --force

问题2：API 密钥无效

# 检查环境变量
echo $ANTHROPIC_API_KEY

# 重新配置
oh-my-opencode configure

问题3：智能体不响应

检查配置文件语法
确认模型可用性
查看日志：oh-my-opencode --debug

问题4：MCP 服务器连接失败

# 调试连接
oh-my-opencode mcp debug <服务器名>

# 检查网络连接
ping mcp.example.com

最佳实践

1. 项目配置

为每个项目创建专门的 .opencode/oh-my-opencode.json，定义项目特定的智能体配置和规则。

2. 环境变量管理

使用环境变量存储敏感信息：

{
  "providers": {
    "anthropic": {
      "apiKey": "{env:ANTHROPIC_API_KEY}"
    }
  }
}

3. 智能体选择

简单任务 → quick
前端开发 → visual-engineering
复杂问题 → ultrabrain 或 deep

4. 性能优化

禁用不需要的智能体
使用本地模型减少延迟
合理设置超时时间

快速参考

安装命令

# 交互式安装
bunx oh-my-opencode install

# 查看帮助
oh-my-opencode --help

配置优先级

项目配置 .opencode/oh-my-opencode.json
用户配置 ~/.config/opencode/oh-my-opencode.json
默认配置

智能体选择指南

| 任务类型 | 推荐智能体 |
|---------|----------|
| 代码生成 | build |
| 架构设计 | plan |
| 问题调试 | oracle |
| 文档查询 | librarian |
| 代码搜索 | explore |
| 前端开发 | visual-engineering |
| 简单任务 | quick |