Oh My OpenCode - 技术栈

Oh My OpenCode（简称 OMO）是 OpenCode 的社区增强插件与智能体编排框架，像"AI 开发团队管理器"，能把单一 AI 代理升级为多智能体协同系统，自动拆解任务、指派给专业智能体并行处理，还内置增强工作流与模型路由，大幅提升 AI 编程效率。它的定位类似 Zsh 的 Oh My Zsh，在基础引擎上做规范与能力增强，不是独立工具。

一：核心定义与核心能力

1. 核心定义

Oh My OpenCode 是基于 OpenCode 的智能体增强框架（Agent Harness）与插件包，核心是通过多智能体协作 、工具链整合 、大模型兼容适配，将 OpenCode 从"单一 AI 助手"升级为"AI 开发团队"，让复杂任务能被拆分给不同专业智能体并行完成，同时提供规范层与可复用工作流。

2. 核心能力

能力	通俗解释	实际作用
多智能体协同	像公司分工：架构师做设计、前端写界面、测试写用例	自动拆解任务，指派给对应智能体并行处理，避免单一模型短板
Sisyphus 调度	智能体失败自动重试、任务中断可恢复	保障复杂任务能完成，不用中途手动干预
模型路由	高端模型处理复杂任务，轻量模型处理简单任务	提升效率+降低成本，避免资源浪费
UltraWork 模式	一键启动"需求→规范→代码→测试"全流程	零基础也能快速落地项目，不用手动串联步骤
规范层	统一项目结构、智能体行为约定	让团队协作时 AI 行为可预测、可审计

二：与 OpenCode 的关系（类比+核心区别）

1. 关系类比（快速理解）

角色	OpenCode	Oh My OpenCode
定位	基础引擎/核心框架（类似汽车发动机）	增强扩展包（类似涡轮增压+四驱系统）
核心功能	提供 CLI 工具、基础智能体能力（任务规划、代码生成）、可扩展架构	提供多智能体调度、规范层、工作流模板、模型路由、错误恢复
依赖关系	独立运行，是基础	必须依赖 OpenCode，无法单独使用
协作模式	单一智能体处理所有任务	多智能体分工协作，自动拆解与整合

2. 一句话总结关系

OpenCode 是"能跑的核心引擎"，提供基础 AI 编程能力；Oh My OpenCode 是"效率增强器"，在引擎上叠加多智能体协作、规范层与工作流，让 OpenCode"跑得更快、更稳、更智能"。

三：安装与使用步骤

3.1 前置准备

安装 Node.js 18.x+ 或 Bun（推荐 Bun，性能更好）。
安装 OpenCode 并完成基础配置：

bash 复制代码

# 安装 OpenCode（Bun 方式）
bun install -g @opencode/cli

# 或 npm 方式
npm install -g @opencode/cli

# 验证安装
opencode --version

配置 AI 模型密钥（如 Claude、GPT、Gemini）：

bash 复制代码

# 按提示登录对应模型平台
opencode auth login

3.2 安装 Oh My OpenCode

推荐用 Bun 安装（速度快、兼容性好，注意：不推荐npm方式，有兼容性问题）：

bash 复制代码

# 安装 Bun（如未安装）
curl -fsSL https://bun.sh/install | bash

# 安装 Oh My OpenCode
bun install -g oh-my-opencode

# 或 npm 方式
npm install -g oh-my-opencode

# 初始化配置（生成规范文件与工作流模板，不同版本存在差异，新版本要oh-my-opencode init）
opencode init

最简单的方法使用AI安装，后面有啥问题就直接AI修复了，不用再执行其它不兼容的命令了。

javascript 复制代码

帮我安装一下oh-my-opencode 插件

javascript 复制代码

执行一次初始化

javascript 复制代码

初始化后完善

3.3 配置与验证

查看配置文件：

bash 复制代码

# 配置文件路径
cat ~/.config/opencode/oh-my-opencode.json

验证插件加载成功：

bash 复制代码

# 看到 oh-my-opencode 即成功（不同版本存在差异）
opencode plugin list

3.4 快速上手：3 个核心用法

1. 启动多智能体模式（默认 Sisyphus 调度）

bash 复制代码

# 启动 OpenCode 并加载 Oh My OpenCode 插件
opencode --agent sisyphus

# 或简写（安装后默认启用）
opencode

启动后有"Sisyphus(Ultraworker)"表示多智能体模式已激活。

2. 用 UltraWork 模式快速落地项目（小白最爱）

UltraWork（简称 ulw）能一键启动全流程，不用手动写多步命令：

bash 复制代码

# 示例：快速做一个"时间+天气"Web 应用
opencode run "ulw 开发一个显示当前时间和天气的 Web 应用，用 HTML+JS+CSS，调用高德天气 API"

系统会自动完成：需求澄清→规范生成→技术方案→任务拆分→代码生成→测试，最终输出可运行项目文件。

3. 自定义智能体与任务（进阶）

查看内置智能体：

bash 复制代码

opencode agent list
或
oh-my-opencode run --help

常见内置智能体：Sisyphus（默认调度）、Librarian（文档管理）、Explore（代码探索）、Oracle（问题解答）。

自定义任务分配（示例）：多 Agent 协同的核心是：用一个总调度 Agent（Sisyphus）来自动拆任务并委派，而不是手动写很多 /agent:xxx。

bash 复制代码

# --agent Sisyphus：开启多 Agent 调度
# ulw：触发 UltraWork 全流程（规划→实现→验证）
# 一条命令执行完会退出（不是持续聊天）
oh-my-opencode run --agent Sisyphus "ulw 开发天气应用：先完成架构设计，再实现前端页面，最后联调并自测"

四：实战演示（用 Oh My OpenCode 做"时间+天气"Web 应用）

步骤 1：启动多智能体模式

bash 复制代码

opencode --agent sisyphus

步骤 2：用 UltraWork 一键生成项目

bash 复制代码

opencode run "ulw 开发一个 Web 应用，功能：1. 显示当前时间（每秒更新）；2. 输入城市查天气（温度、天气状况）；技术栈：HTML+JS+CSS，调用高德天气 API；界面简洁居中"

步骤 3：微调与运行

打开生成的项目文件夹，在 app.js 中替换高德 API 密钥（去高德开放平台申请免费密钥）https://console.amap.com/dev/index，具体申请步骤参考：https://amap.apifox.cn/doc-7445538 （先注册成为开发者、再创建应用、再添加key）。
右键 index.html，用浏览器打开，即可看到实时时间与天气查询功能。

步骤 4：用智能体排查问题（示例）

若天气查询失败，用 Oracle 智能体排查：

bash 复制代码

opencode run "/agent:oracle 帮我检查index.html 中天气 API 调用失败的原因，给出修复方案"

五：避坑指南

按顺序安装：先装 OpenCode 并配置密钥，再装 Oh My OpenCode，避免插件加载失败（推荐使用AI安装）。
需求说清楚：用 UltraWork 时，尽量按"功能+技术栈+界面要求"描述，AI 生成结果更准确。
模型选择：复杂任务用高端模型（如 Claude Opus），简单任务用轻量模型（如 Claude Sonnet），降低成本。
任务可中断：Sisyphus 调度支持任务中断恢复，不用担心中途退出前功尽弃。

六：总结

Oh My OpenCode 不是替代 OpenCode，而是让 OpenCode 更强大的"效率插件"------它把单一 AI 助手变成能分工协作的"AI 开发团队"，自动拆解任务、并行处理，还提供规范与工作流，小白也能快速落地复杂项目。核心是"规范层+多智能体协同"，让 AI 编程从"单打独斗"变成"团队作战"，大幅降低开发门槛与时间成本。