oh-my-opencode-slim

环境要求

• 已安装 OpenCode（插件运行宿主，需能用 opencode 命令）
• 至少一个模型提供商账号（如 OpenAI）并完成登录认证
• 安装方式二选一：Bun（bunx）或 Node/npx，从源码运行需 Bun
• 能读写 ~/.config/opencode/ 目录下的配置文件
• 建议配置终端多路复用器（Tmux/Zellij/Herdr/cmux/kitty）以便观察后台智能体

安装与启动步骤

1. 1安装插件

   官方推荐的快捷安装方式，运行交互式安装器，自动写入插件配置。项目是 Node 兼容包，无 Bun 时可用 npx。

   bunx oh-my-opencode-slim@latest install

   复制

2. 2从源码运行

   想用最新代码、便于修 bug 或参与开发时使用。安装器会把本地仓库路径加到插件数组，后续更新只需重新拉取和构建。

   git clone https://github.com/alvinunreal/oh-my-opencode-slim.git ~/repos/oh-my-opencode-slim
   cd ~/repos/oh-my-opencode-slim
   bun install
   bun run build
   bun dist/cli/index.js install

   复制

3. 3切换默认预设

   安装器会同时生成 OpenAI 和 OpenCode Go 两套预设，默认启用 OpenAI。安装时加参数即可改为 OpenCode Go。

   bunx oh-my-opencode-slim@latest install --preset=opencode-go

   复制

4. 4登录模型提供商

   为你要使用的厂商完成认证，没登录过的提供商模型无法被调用。

   opencode auth login

   复制

5. 5刷新模型列表

   让 OpenCode 重新拉取并列出它当前能看到的全部模型，便于在配置里挑选。

   opencode models --refresh

   复制

6. 6编辑插件配置

   打开插件配置文件，按需修改编排器及各子智能体（oracle、librarian、explorer、designer、fixer）使用的模型与变体。

7. 7验证智能体

   启动 OpenCode 后输入 ping all agents，确认所有已配置的智能体都在线并能够响应。

   opencode

   复制

关键配置

如何确认成功

先运行 opencode 进入会话，再输入 ping all agents；若所有配置的智能体都返回在线即为成功。某个智能体无响应时，检查提供商认证与配置文件。

常见问题

注意事项

• 安装器会把本地仓库路径写入 ~/.config/opencode/opencode.json 的 plugin 数组，OpenCode 从该目录加载插件。
• 插件配置文件位于 ~/.config/opencode/oh-my-opencode-slim.json，建议改配置前先备份。
• 后台智能体已是默认工作流，官方强烈建议启用 Multiplexer 集成，让每个智能体在独立窗格中实时展示。
• 想理解自动分派逻辑，可阅读编排器提示词中的调度规则、专家路由与后台委派阈值。