Oh-My-OpenCode 是一个革命性的 OpenCode 扩展集合，将 OpenCode 从单一的 AI 助手转变为多模型协同的智能开发团队。本指南面向程序员，全面介绍 3.5.6 版本的使用方法、高级特性和最佳实践。
🔥 版本亮点：3.5.6 版本带来了增强的任务协调器、改进的并行处理能力，以及对最新 LLM 模型的全面支持。
# 方法一：使用 bun（推荐）
bunx oh-my-opencode install
# 方法二：使用 npm
npm install -g oh-my-opencode
# 方法三：通过 OpenCode 安装
# 在 OpenCode 中输入：
"Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md"
安装完成后，编辑 OpenCode 配置文件（通常位于 ~/.config/opencode/opencode.json）
确保插件路径配置正确：
{
"plugin": [
"file:///path/to/oh-my-opencode/dist/index.js"
]
}
配置你的 API 密钥：
opencode auth
重启 OpenCode 开始使用
Oh-My-OpenCode 的核心是多智能体协作系统，每个智能体都有专门的角色和能力：
| 智能体 | 角色定位 | 推荐模型 | 主要职责 |
|---|---|---|---|
| Sisyphus | 主编排者 | Claude 3.5 Sonnet | 任务规划、分配、协调 |
| Oracle | 架构顾问 | GPT-4/GPT-4 Turbo | 架构设计、复杂问题解答 |
| Librarian | 文档专家 | Gemini 1.5 Flash/Gemini Pro | 文档查询、代码库研究 |
| Frontend-UI-UX-Engineer | 前端工程师 | Claude 3 Sonnet/Gemini 3 Pro | UI/UX 开发、界面设计 |
| Explore | 代码探索者 | Grok/Gemini Flash | 快速代码分析、模式发现 |
Oh-My-OpenCode 不是简单的模型轮换，而是真正的协同工作：
# 读取文件内容
opencode run "读取 src/components/Button.tsx 的内容"
# 使用 @ 符号直接引用文件
"分析 @src/utils/validation.js 中的验证逻辑"
# 精确替换文本
opencode run "将 src/config.js 中的 'localhost' 替换为 '0.0.0.0'"
# 更新整个文件
opencode run "重写 README.md，添加安装说明和使用示例"
# 创建新组件
opencode run "创建一个新的 React 组件 UserProfile.tsx，包含用户信息展示功能"
# 使用正则表达式搜索
opencode run "搜索项目中所有包含 'TODO:' 的注释"
# 按文件模式搜索
opencode run "查找所有 .test.js 文件"
# 结构化代码搜索
opencode run "找到所有使用 useEffect 但没有依赖数组的 React 组件"
# 代码重构
opencode run "将所有 var 声明重构为 const 或 let"
# 查找函数定义
opencode run "找到 calculateTotal 函数的定义位置"
# 查找所有引用
opencode run "找到所有使用 utils.ts 中 formatDate 的地方"
# 检查代码问题
opencode run "检查当前项目中的 TypeScript 错误"
# 分析代码质量
opencode run "分析 src/api/ 目录的代码质量问题"
# 自动拆分复杂任务
opencode run "实现一个完整的用户认证系统，包括注册、登录和密码重置"
这会自动创建一个详细的任务列表，可以逐步执行。
# 查看任务进度
"查看当前任务进度"
# 标记任务完成
"标记用户注册功能开发任务为完成"
Oh-My-OpenCode 提供了多个专业化智能体：
# 自动委派任务
opencode run "创建一个响应式的电商产品详情页，包括图片轮播和购买表单"
# Sisyphus 会自动：
# 1. 分析需求
# 2. 创建任务列表
# 3. 委派 Frontend-UI-UX-Engineer 构建界面
# 4. 请求 Oracle 审查架构
# 5. 协调所有子任务完成
# 直接使用特定智能体
opencode run "请使用 Librarian 智能体研究 Redux Toolkit 的最佳实践"
Ultrawork 是 Oh-My-OpenCode 的核心魔法功能，开启"火力全开"模式，调动所有可用代理并行协作。
# 简单触发 ultrawork
ulw 实现一个完整的用户认证系统
# 或使用完整关键词
ultrawork 将项目从 JavaScript 迁移到 TypeScript
# 1. 指定优先级和角色分配
ulw UI部分交给视觉/交互专家，优先级最高；后端逻辑交给backend代理；整体架构先让oracle评审。实现实时仪表盘，支持WebSocket更新、ECharts图表。
# 2. 强制深度代码库探索
ulw 先全面分析整个代码库的现有模式和痛点，再重构所有API路由为RESTful标准，消除重复代码。
# 3. 批量清理与优化
ulw 移除所有console.log、dead code、未使用import；统一代码风格；性能优化所有慢查询。
# 4. 结合工具链
ulw 先运行npm test收集失败用例，分析原因并修复，然后执行完整重构。
Ralph Loop 是 Oh-My-OpenCode 的自我迭代机制，让智能体持续工作直到任务完成。
# 通过 slash 命令触发
/ralph-loop 或 /stop-ralph
# 或通过任务管理器
"启动ralph-loop，持续优化代码直到性能测试通过"
在项目根目录创建 AGENTS.md：
# DatabaseExpert
你是数据库设计和优化专家，擅长：
- SQL 查询优化
- 数据库架构设计
- 索引策略
- 迁移脚本编写
当遇到数据库相关问题时，会自动调用你来提供专业建议。
创建 SKILLS.md 定义智能体的专业技能：
# 数据库分析技能
- 审查和优化慢查询
- 设计高效的数据库模式
- 建议适当的索引
- 生成数据迁移脚本
Oh-My-OpenCode 内置了多个 MCP 服务器：
自动获取最新的库和框架文档：
# 自动获取相关文档
opencode run "使用 Context7 获取 React 18 的最新官方文档并实现一个组件"
搜索 GitHub 上的代码示例：
# 搜索实际代码示例
opencode run "使用 grep.app 查找知名项目中的 JWT 认证实现"
在配置文件中添加：
{
"mcpServers": {
"my-custom-mcp": {
"command": "node",
"args": ["path/to/my-mcp-server.js"],
"env": {
"API_KEY": "your-api-key"
}
}
}
}
Oh-My-OpenCode 提供了 20+ 个内置 Hook，可全面自动化工作流程。
preemptive-compaction
ralph-loop
todo-enforcer
ulw-loop
start-work
refactor
在配置文件中精细化配置：
{
"hooks": {
"enabled": [
"preemptive-compaction",
"ralph-loop",
"todo-enforcer",
"ulw-loop"
],
"preemptiveCompaction": {
"threshold": 0.8,
"priority": ["AGENTS.md", "README.md"]
},
"ralphLoop": {
"maxIterations": 10,
"autoStopOnSuccess": true
},
"todoEnforcer": {
"maxFailures": 5,
"cooldownTime": 3000,
"escalationThreshold": 3
},
"ulwLoop": {
"maxDuration": 3600000,
"resourceLimits": {
"maxTokens": 500000,
"maxApiCalls": 100
}
}
}
}
控制并发任务数量以优化成本和性能：
{
"agents": {
"sisyphus": {
"maxConcurrentTasks": 5,
"parallelBackgroundTasks": true,
"taskTimeout": 300000,
"resourceQuota": {
"maxTokensPerTask": 50000,
"maxApiCallsPerHour": 200
}
}
}
}
优化 token 使用：
{
"context": {
"maxTokens": 100000,
"compressionThreshold": 80000,
"injectionPriority": [
"AGENTS.md",
"README.md",
"package.json",
"tsconfig.json"
],
"autoCompression": {
"enabled": true,
"strategy": "preserve-recent",
"keepPercentage": 0.3
}
}
}
根据任务复杂度选择合适的模型以优化成本：
{
"agentModels": {
"sisyphus": "claude-3.5-sonnet",
"oracle": "gpt-4-turbo",
"librarian": "gemini-1.5-flash",
"frontend": "claude-3-sonnet",
"explore": "gemini-1.5-flash"
},
"fallbackStrategy": {
"quotaExhausted": "use-cheaper-model",
"highComplexity": "escalate-to-premium"
}
}
对于 Oh-My-OpenCode 项目，推荐以下结构：
project/
├── AGENTS.md # 智能体定义
├── SKILLS.md # 技能定义
├── README.md # 项目说明
├── .gitignore
├── package.json
├── opencode.json # OpenCode 配置
└── src/
需求分析阶段：
开发阶段：
代码审查阶段：
问题解决阶段：
# 使用 Ultrawork 进行大规模重构
ulw 将整个项目从 JavaScript 迁移到 TypeScript，保持所有功能不变，添加完整的类型定义
# 多步骤复杂功能
"实现一个完整的SaaS应用：用户认证、多租户架构、订阅支付、管理面板、API文档。使用Oracle进行架构设计，委派不同专业智能体实现各个模块。"
# 系统性问题排查
ulw 深度分析应用性能问题，找出瓶颈，提供优化方案并实施。使用探索智能体分析代码库，使用Oracle提供架构建议。
智能体响应过慢
上下文丢失
任务卡住
/stop-continuation 停止所有继续机制# 查看当前会话状态
/session-info
# 查看任务列表
/todowrite
# 停止所有后台任务
/background-cancel all
# 查看最近的错误
/diagnostics
新增功能：
改进优化：
修复问题：
新增功能：
重大更新：
Oh-My-OpenCode 3.5.6 提供了强大的会话管理系统：
# 查看所有会话
/session-list
# 继续特定会话
/session-continue ses_abc123
# 会话间搜索
/session-search "数据库设计"
# 启动后台任务
"后台运行代码分析，完成后通知我"
# 查看后台任务输出
/background-output task_id
# 取消后台任务
/background-cancel task_id
创建智能体工作流：
# 串联工作流
"先使用 Explorer 分析代码库，然后使用 Librarian 研究最佳实践，最后使用 Oracle 设计架构，最后由 Frontend 工程师实现"
扩展智能体的工具能力：
{
"customTools": [
{
"name": "database",
"command": "mysql",
"args": ["-u", "root", "-e"],
"description": "执行数据库查询"
},
{
"name": "deploy",
"command": "docker",
"args": ["compose", "up"],
"description": "部署应用"
}
]
}
加入官方 Discord 获取最新动态和技术支持：
Oh-My-OpenCode 积极维护，定期更新：
🆕 新增功能：
✨ 改进优化：
📊 更精确的资源监控和配额管理
🔍 上下文压缩算法优化，节省 25% token 消耗
🛡️ 增强的错误恢复和容错机制
🎯 智能体选择策略更智能化
🔧 修复特定情景下的任务卡死问题
🐛 解决 Hook 系统的内存泄露
💾 修正上下文注入的优先级bug
🦄 完善与最新 LLM API 的兼容性
🆕 新增功能：
🎉 重大更新：
🎉 恭喜：现在你已经掌握了 Oh-My-OpenCode 3.5.6 的核心用法！记住，你不再是一个提示词工程师，而是一个 AI 团队的管理者。让这些智能体为你工作，专注于创造性和战略性的任务！
💡 终极建议：当你不确定如何实现某个功能时，试试
ulw [你的需求]，让 Oh-My-OpenCode 的智能协作系统为你找到最佳解决方案！
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。