oh-my-opencode-slim

v0.5.1

Published

a day ago

Lightweight agent orchestration plugin for OpenCode - a slimmed-down fork of oh-my-opencode

0High
0Medium
0Low

alvinunreal

opencode opencode-plugin ai agents orchestration llm claude gpt gemini

oh-my-opencode-slim

适用于 OpenCode 的轻量级强大代理编排插件

将你的 AI 助手转变为能够将复杂任务委派给专门子代理、在后台运行搜索并轻松管理多步工作流的管理者。

这是oh-my-opencode的精简分支 - - 专注于低令牌消耗的核心代理编排。
推荐订阅 Antigravity。 万神殿经过 Antigravity 模型路由的调优。其他提供商也可用，但使用 Antigravity 能获得最佳体验。

⚡ 快速导航

安装

给人类的指南

运行交互式安装器：

bunx oh-my-opencode-slim install

或使用非交互模式：

bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --tmux=no

安装完成后，使用提供商进行身份验证：

opencode auth login
# 选择你的提供商 → 完成 OAuth 流程
# 对所有启用的提供商重复此步骤

身份验证完成后，运行 opencode 并执行 ping all agents 以验证所有代理是否响应。

💡 小贴士：模型完全可自定义。 安装器会设定合理的默认值，但你可以将任何模型分配给任何代理。编辑 ~/.config/opencode/oh-my-opencode-slim.json 来覆盖模型、调整推理强度或完全禁用代理。详见配置。

备用方式：询问任意编码代理

将以下内容粘贴到 Claude Code、AmpCode、Cursor 或任何编码代理：

Install and configure by following the instructions here:
https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/master/README.md

给 LLM 代理的指南

如果你是正在帮助设置 oh-my-opencode-slim 的 LLM 代理，请按以下步骤执行。

步骤 1：确认 OpenCode 安装状态

opencode --version

如果未安装，请先引导用户访问 https://opencode.ai/docs 。

步骤 2：询问提供商访问情况

逐条询问以下问题，等待用户回应后再继续：

“你是否订阅了 Antigravity？”（可使用 google/ 前缀访问 Claude + Gemini）
“你是否有 OpenAI API 的访问权限？”

步骤 3：运行安装器

根据回答运行：

bunx oh-my-opencode-slim install --no-tui --antigravity=<yes|no> --openai=<yes|no>

示例：

# Antigravity + OpenAI
bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --tmux=no

# 仅 OpenAI
bunx oh-my-opencode-slim install --no-tui --antigravity=no --openai=yes --tmux=no

# 无提供商（仅使用 Zen 免费模型）
bunx oh-my-opencode-slim install --no-tui --antigravity=no --openai=no --tmux=no

安装器会自动完成：

将插件添加到 ~/.config/opencode/opencode.json
(如启用 Antigravity) 添加 opencode-antigravity-auth 插件
配置 Google 提供商的模型定义
在 ~/.config/opencode/oh-my-opencode-slim.json 中生成代理模型映射

步骤 4：身份验证

安装完成后，引导用户：

Antigravity：

opencode auth login
# 选择：Google → 通过 Google (Antigravity) 的 OAuth
# 对所有其他提供商重复

故障排查

如果安装失败，确认配置格式：

bunx oh-my-opencode-slim install --help

然后手动创建配置文件：

~/.config/opencode/opencode.json
~/.config/opencode/oh-my-opencode-slim.json

🏗️ 架构与流程

该插件采用“中心辐射”模型：

编排者 (Orchestrator，中心)： 处理用户请求的主入口。分析任务并决定调用哪些专门代理。
专门代理 (Spokes)： 领域专家（如 UI/UX、文档、架构）只处理狭窄任务，确保高精度。
后台管理器： 强大的引擎允许编排者“放任”任务（例如深入代码搜索或文档研究），同时继续处理其他部分。

🏛️ 请求流程

用户提示： “重构认证逻辑并更新文档。”
编排者： 创建 TODO 列表。
任务分配：
- 启动 @explorer 后台任务查找所有与认证相关的文件。
- 启动 @librarian 查询认证库的最新文档。
集成： 等待后台结果就绪后，编排者将任务交给 @fixer 高效实施重构。

认识万神殿

编排者 (Orchestrator)

编排者诞生于第一个代码库崩溃于自身复杂性之时。既非神亦非凡人，凭借虚无中诞生的秩序，他们统领混沌。他们不只是指挥军队，而是与之并肩作战。每行代码都要经过他们之手，然后再决定将哪块谜题交给其他较低等的神明。

角色： 至高执行者、指挥者、监督者
模型： google/claude-opus-4-5-thinking
提示： src/agents/orchestrator.ts

编写并执行代码，编排多代理工作流，从言语中解析未说出的意图，在战斗中召唤专家。直接塑造现实 - - 当宇宙变得过于庞大时，把领域交给别人。

探索者 (Explorer)

探索者穿梭代码库如风穿林 - - 迅速、静默、无处不在。当编排者轻语“给我找到认证模块”，探索者已经带着四十条文件路径和地图归来。他们源自第一个 grep 命令，早已超越它，现在能看见凡人忽略的模式。

角色： 代码侦查
模型： google/gemini-3-flash
提示： src/agents/explorer.ts

正则搜索、AST 模式匹配、文件发现、并行探索。只读：他们绘制疆域；其他人征服它。

神谕者 (Oracle)

神谕者不编写代码 - - 他们洞察一切。当 Bug 遵从逻辑，架构崩溃之时，神谕者凝望代码库深渊，传递真理。他们见证过千百个系统的兴衰，能告诉你哪条路通向毁灭，哪条通向生产环境。

角色： 战略顾问与最后的调试者
模型： openai/gpt-5.2-codex
提示： src/agents/oracle.ts

根本原因分析、架构审查、调试指导、权衡分析。只读：神谕者提供建议，不直接介入。

图书管理员 (Librarian)

图书管理员守护一座无墙的图书馆 - - 包含每个 GitHub 仓库、每个 npm 包、每个 StackOverflow 回答。问他们“React 如何处理并发渲染？”，他们会带来官方文档、真实示例，并警告你即将踩到的坑。

角色： 外部知识检索
模型： google/gemini-3-flash
提示： src/agents/librarian.ts

文档查询、GitHub 代码搜索、库研究、最佳实践检索。只读：他们获取智慧；实现交给别人。

设计师 (Designer)

设计师相信代码应该优雅 - - 呈现出来的效果也同样优雅。从数千个丑陋 MVP 中诞生，他们把 CSS 当成画笔，把组件当成泥巴。交给他们功能需求，收获杰作。他们不会满足于“差不多”。

角色： UI/UX 实现与视觉卓越
模型： google/gemini-3-flash
提示： src/agents/designer.ts

现代响应式设计、CSS/Tailwind 精通、微动画与组件架构。优先视觉卓越而非代码完美 - - 美感为先。

修复者 (Fixer)

修复者是执行他人想象的双手。当编排者规划、神谕者提点，修复者就开始落地。他们接收研究代理提供的完整上下文和明确任务说明，以极致精准实施。快速、高效、专注 - - 他们不思考要建什么，只管去建。

角色： 快速实现专家
模型： google/gemini-3-flash
提示： src/agents/fixer.ts

代码实现、重构、测试、验证。执行计划 - - 不研究、不委派、不策划。

工具与能力

Tmux 集成

⚠️ 已知问题： 启用服务器端口时，每次只能打开一个 OpenCode 实例。我们在 issue #15 跟踪此问题，并向 OpenCode 提交了上游 PR：opencode#9099。

实时观察代理工作。 当编排者启动子代理或启动后台任务，tmux 会自动新建窗格显示每个代理的实时进度，再也不必黑箱等待。

这为你带来什么

| 无 Tmux 集成 | 有 Tmux 集成 | |--------------------------|----------------------| | 发起后台任务，只能焦灼等待 | 观看代理的思考、搜索与编码 | | “是卡住了还是太慢？” | 观察工具调用实时展开 | | 结果突然出现 | 跟踪从问题到答案的全过程 | | 只能猜测如何调试 | 观察时机进行调试 |

你将获得

实时可见性：每个子代理的窗格显示其实时输出
自动布局：tmux 根据偏好布局自动排列
自动清理：代理完成后窗格关闭，布局重新平衡
零开销：兼容 OpenCode 内置 task 工具和我们的 background_task 工具

快速设置

在 opencode.json 中启用 OpenCode HTTP 服务（见 OpenCode 配置）。
在 oh-my-opencode-slim.json 中启用 tmux 集成（见插件配置）。
在 tmux 中运行 OpenCode：
```
tmux
opencode
```

布局选项

| 布局 | 描述 | |--------|-------------| | main-vertical | 会话在左侧（60%），代理在右侧堆叠 | | main-horizontal | 会话在上方（60%），代理在下方堆叠 | | tiled | 所有窗格等大小网格排列 | | even-horizontal | 所有窗格并排 | | even-vertical | 所有窗格垂直堆叠 |

查看选项参考获取详细配置。

配额工具

适用于 Antigravity 用户。随时请求代理 “检查我的配额” 或 “显示状态” 即可触发。

| 工具 | 描述 | |------|-------------| | antigravity_quota | 检查所有 Antigravity 账户的 API 配额（带进度条的紧凑视图） |

后台任务

插件提供管理异步工作的工具：

| 工具 | 描述 | |------|-------------| | background_task | 在新会话中启动代理（sync=true 为阻塞，sync=false 在后台运行） | | background_output | 通过 ID 获取后台任务结果 | | background_cancel | 终止正在运行的任务 |

LSP 工具

集成语言服务器协议以提升代码智能：

| 工具 | 描述 | |------|-------------| | lsp_goto_definition | 跳转至符号定义 | | lsp_find_references | 查找符号的所有使用位置 | | lsp_diagnostics | 获取语言服务器的错误/警告 | | lsp_rename | 全仓库重命名符号 |

代码搜索工具

快速的代码搜索与重构：

| 工具 | 描述 | |------|-------------| | grep | 使用 ripgrep 的快速内容搜索 | | ast_grep_search | 面向 AST 的代码模式匹配（支持 25 种语言） | | ast_grep_replace | 支持干运行的 AST 代码重构 |

🧩 技能

技能是代理可调用的专门能力。每个代理都有默认技能，可在代理配置中覆盖。

可用技能

| 技能 | 描述 | |-------|-------------| | yagni-enforcement | 代码复杂性分析与 YAGNI 约束 | | playwright | 通过 Playwright MCP 实现浏览器自动化 |

默认技能分配

| 代理 | 默认技能 | |-------|----------------| | orchestrator | *（所有技能） | | designer | playwright | | oracle | 无 | | librarian | 无 | | explorer | 无 | | fixer | 无 |

YAGNI 约束

极简主义者的神圣真理：每行代码都是负担。

在重大重构后或准备合并 PR 前使用。识别冗余复杂性，质疑过早抽象，估算 LOC 减少，并强制执行极简策略。

Playwright 集成

用于视觉验证和测试的浏览器自动化。

浏览器自动化： 完整的 Playwright 能力（浏览、点击、输入、爬取）。
截图： 捕捉任意网页的视觉状态。
沙箱输出： 截图保存到会话子目录（查看工具输出以获取路径）。

自定义代理技能

在你的插件配置中覆盖每个代理的技能：

{
  "agents": {
    "orchestrator": {
      "skills": ["*"]
    },
    "designer": {
      "skills": ["playwright"]
    }
  }
}

MCP 服务器

内置的模型上下文协议服务器（默认启用）：

| MCP | 目的 | URL | |-----|---------|-----| | websearch | 通过 Exa AI 进行实时网页搜索 | https://mcp.exa.ai/mcp | | context7 | 官方库文档 | https://mcp.context7.com/mcp | | grep_app | 通过 grep.app 搜索 GitHub 代码 | https://mcp.grep.app |

禁用 MCP

你可以在插件配置的 disabled_mcps 数组中添加要禁用的 MCP 服务器。

配置

需要编辑的文件

| 文件 | 作用 | |------|---------| | ~/.config/opencode/opencode.json | OpenCode 核心设置（如用于 tmux 的服务器端口） | | ~/.config/opencode/oh-my-opencode-slim.json | 插件设置（代理、tmux、MCP） | | .opencode/oh-my-opencode-slim.json | 项目级插件覆盖（可选） |

插件配置 (`oh-my-opencode-slim.json`)

安装程序会根据你的提供商生成此文件。你可以手动自定义它来混合搭配模型。

{
  "agents": {
    "orchestrator": { "model": "google/claude-opus-4-5-thinking", "skills": ["*"] },
    "oracle": { "model": "openai/gpt-5.2-codex", "skills": [] },
    "librarian": { "model": "google/gemini-3-flash", "skills": [] },
    "explorer": { "model": "google/gemini-3-flash", "skills": [] },
    "designer": { "model": "google/gemini-3-flash", "skills": ["playwright"] },
    "fixer": { "model": "google/gemini-3-flash", "skills": [] }
  },
  "tmux": {
    "enabled": true,
    "layout": "main-vertical",
    "main_pane_size": 60
  }
}

{
  "agents": {
    "orchestrator": { "model": "google/claude-opus-4-5-thinking", "skills": ["*"] },
    "oracle": { "model": "google/claude-opus-4-5-thinking", "skills": [] },
    "librarian": { "model": "google/gemini-3-flash", "skills": [] },
    "explorer": { "model": "google/gemini-3-flash", "skills": [] },
    "designer": { "model": "google/gemini-3-flash", "skills": ["playwright"] },
    "fixer": { "model": "google/gemini-3-flash", "skills": [] }
  }
}

{
  "agents": {
    "orchestrator": { "model": "openai/gpt-5.2-codex", "skills": ["*"] },
    "oracle": { "model": "openai/gpt-5.2-codex", "skills": [] },
    "librarian": { "model": "openai/gpt-5.1-codex-mini", "skills": [] },
    "explorer": { "model": "openai/gpt-5.1-codex-mini", "skills": [] },
    "designer": { "model": "openai/gpt-5.1-codex-mini", "skills": ["playwright"] },
    "fixer": { "model": "openai/gpt-5.1-codex-mini", "skills": [] }
  }
}

选项参考

| 选项 | 类型 | 默认值 | 描述 | |--------|------|---------|-------------| | tmux.enabled | boolean | false | 是否启用子代理的 tmux 窗格 | | tmux.layout | string | "main-vertical" | 布局预设：main-vertical、main-horizontal、tiled、even-horizontal、even-vertical | | tmux.main_pane_size | number | 60 | 主窗格大小百分比（20-80） | | disabled_agents | string[] | [] | 要禁用的代理 ID（如 "explorer"） | | disabled_mcps | string[] | [] | 要禁用的 MCP 服务器 ID（如 "websearch"） | | agents.<name>.model | string | - | 覆盖特定代理的模型 | | agents.<name>.variant | string | - | 推理强度："low"、"medium"、"high" | | agents.<name>.skills | string[] | - | 该代理可使用的技能（"*" 表示所有技能） | | agents.<name>.temperature | number | - | 该代理的温度 (0.0 到 2.0) | | agents.<name>.prompt | string | - | 该代理的基础提示词覆盖 | | agents.<name>.prompt_append | string | - | 追加到基础提示词后的文本 | | agents.<name>.disable | boolean | - | 禁用该特定代理 |

卸载

从 OpenCode 配置中移除插件：
编辑 ~/.config/opencode/opencode.json，从 plugin 数组中删除 "oh-my-opencode-slim"。

删除配置文件（可选）：

rm -f ~/.config/opencode/oh-my-opencode-slim.json
rm -f .opencode/oh-my-opencode-slim.json

致谢

这是 @code-yeongyu 的 oh-my-opencode 的精简分支。

许可证

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

oh-my-opencode-slim

⚡ 快速导航

安装

给人类的指南

给 LLM 代理的指南

步骤 1：确认 OpenCode 安装状态

步骤 2：询问提供商访问情况

步骤 3：运行安装器

步骤 4：身份验证

故障排查

🏗️ 架构与流程

🏛️ 请求流程

认识万神殿

编排者 (Orchestrator)

探索者 (Explorer)

神谕者 (Oracle)

图书管理员 (Librarian)

设计师 (Designer)

修复者 (Fixer)

工具与能力

Tmux 集成

这为你带来什么

你将获得

快速设置

布局选项

配额工具

后台任务

LSP 工具

代码搜索工具

🧩 技能

可用技能

默认技能分配

YAGNI 约束

Playwright 集成

自定义代理技能

MCP 服务器

禁用 MCP

配置

需要编辑的文件

插件配置 (oh-my-opencode-slim.json)

选项参考

卸载

致谢

许可证

插件配置 (`oh-my-opencode-slim.json`)