oh-my-opencode 是一个为开源 AI 编程智能体 OpenCode 量身定制的增强型插件和管理框架。它通过将单一的 AI 助手转变为一个“多智能体协作系统”,显著提升了处理复杂编程任务的能力。
以下是关于它的详细介绍及在 Windows 11 上的安装步骤。
一、 项目详细介绍
核心定位: 它不是一个独立的编辑器,而是 OpenCode 的“外挂”和“大脑增强包”。它让 OpenCode 能够根据任务类型自动切换最合适的模型(如用 Claude 进行架构设计,用 GPT-4 进行深度推理,用 Gemini 处理前端 UI)。
核心组件(角色系统):
Sisyphus(西西弗斯):核心执行者,负责“推石头上山”,即不完成任务决不停止。它能自动拆解 TODO 列表并持续推进。
Orchestrator(协调者):负责全局规划和任务分发。
Explorer/Librarian:并行运行的子智能体,负责在后台检索代码库、查阅文档或进行网络搜索,不占用主对话的上下文。
特色功能:
多模型编排:支持 Claude, OpenAI, Gemini, GitHub Copilot 等多种 provider。
UltraWork (ulw):一种极简指令,输入 ulw 后,智能体将自动完成“代码分析 -> 方案设计 -> 并行搜索 -> 代码实现 -> 自动化测试”的全流程。
Tmux 集成:可以在终端中开启多个窗格,实时观察不同智能体(如前端和后端智能体)并行工作的进度。
—
二、 Windows 11 安装步骤
在 Win11 上安装 oh-my-opencode 前,你需要先配置好底层环境。
1. 前置环境准备
2. 第一步:安装 OpenCode(基础)
oh-my-opencode 必须运行在 OpenCode 之上。 如果你还没有安装 OpenCode:
Bash
npm install -g @opencode/cli
3. 第二步:安装 oh-my-opencode
使用 bunx 或 npx 运行官方安装脚本。建议使用 交互式安装:
Bash
bunx oh-my-opencode install
或者使用 npx:
Bash
npx oh-my-opencode install
4. 第三步:配置订阅和 API
在安装过程中,命令行会询问你拥有的订阅服务。根据你的实际情况输入(Yes/No):
安装程序会自动在 ~/.config/opencode/ 目录下生成配置文件 oh-my-opencode.jsonc。
5. 第四步:身份验证
安装完成后,你需要通过 OpenCode 登录对应的 Provider(如果没有配置全局 API Key):
Bash
opencode auth login claude
opencode auth login openai
6. 第五步:启动与使用
进入你的代码项目目录,启动 OpenCode:
Bash
opencode .
进入会话后,你可以直接尝试以下指令来确认插件是否生效:
注意事项: