桌面端安装了 oh-my-openagent（OMO），Composer 输入框左边的 agent 下拉里却只剩 Plan / Build。CLI 里 opencode agent list 输出好好的——Sisyphus、Hephaestus、Prometheus、Atlas 全都在——就桌面端看不见。
这篇根据官方 issue 和 OMO 安装文档，把"从哪个版本开始断的"和"最新版怎么修"两件事说清楚。
这个问题从哪个版本开始出现的
OMO 在桌面端消失不是一次性事件，是 3 轮叠加。
第一轮：v1.14.34 — 架构切换
OpenCode v1.14.34 把桌面端的架构从 Tauri 切到 Electron。这是 issue 里用户 AkutaZehy 明确提到的分水岭：
"I know there's a architecture change in v1.14.34, from Tauri to Electron, where the issue happens once for me on v1.14.39."
切完之后，desktop 的 sidecar 进程（用来跑 plugin 的那个 Node 子进程）依赖链变了。之前的 plugin loader 是 Bun 直跑的；Electron 之后要走 Node ESM loader，路径不一样。
用户 AkutaZehy 在 v1.14.39 中招过一次，靠"深清缓存 + 重装 plugin"修好。问题里#25840、#28287 都是这一轮的同源 issue。
第二轮：v1.15.13 — Bun.serve 报错成主线问题
v1.15.13 还在 Electron 链上。issue 里用户 deantee 报的不是"找不到 plugin"，而是 plugin 加载直接报错。桌面端日志（~/.local/share/opencode/log/*.log）原文：
这条日志在 1 秒内重复 4 次——desktop sidecar 重试 4 次，每次都是同一个错误。OMO 自带的 skill source server 依赖 Bun.serve，Electron 走的是 Node，不是 Bun，所以 Bun.serve 直接不存在，plugin 进程整个挂掉。
第三轮：v1.16.0 — 桌面端默认隐藏 plugin agent
v1.15.13 用户还在走弯路——~/.cache/opencode/packages/oh-my-openagent@latest/ 这个目录清干净重装就回来。到了 v1.16.0，桌面端的 agent picker UI 重做了一版，plugin 注册的 agent 默认不再显示。
issue 的报告里："After updating desktop version from v1.15.13 to v1.16.0, plugin-registered agents disappears, the plugin is successfully registered but there are only Plan/Build in agent list."
注意用户明确说："IT IS NOT THE PROBLEM LIKE THE v1.14.34 ISSUE"。v1.16.0 不是上一轮的复发，是新加的一层：plugin 装上了、CLI 能看见，但桌面端 UI 故意不展示。
一句话总结
- CLI/TTY 路径：OMO 一直能用，v1.14.x → v1.17.x 都没断过
- 桌面端路径：v1.14.34（Electron 切换）开始不稳 → v1.15.13（Bun.serve 报错成主线）→ v1.16.0（picker UI 默认隐藏）
OMO 消失是这 3 轮叠加出来的。哪一轮是你遇到的，要看具体环境。
验证你现在是不是遇到这个问题
跑这一行 CLI：
输出应该至少包含这些：
如果 CLI 输出齐全、桌面端 picker 看不见 plugin agent——就是典型的 "plugin 装上了但被 UI 过滤"。
如果 CLI 输出也缺东西，看桌面端日志。Linux 路径：
里面找当天的 .log 文件，grep oh-my-openagent 和 Bun.serve：
如果出来一行 Runtime skill source server requires Bun.serve failed to load plugin，是 v1.15.13 那一轮的问题，跟 UI 无关，要走缓存清理那条路。
Windows 日志在 %USERPROFILE%\.local\share\opencode\log\，macOS 跟 Linux 同源（用 <span>/.local/share/opencode/log/，不是 </span>/Library/Logs/）。
最新版怎么把 OMO 找回来
最新版 v1.17.9（2026-06-21 发布）。分情况修。
情况一：v1.17.5 之后的桌面端（v1.17.5 - v1.17.9）
v1.17.5 在桌面端 Settings 加了一个开关："Show custom agents in the composer"。这个开关默认是关的。
修法：
- 桌面端打开 Settings（菜单或顶栏里）
- 找到 Advanced 区域（在 通用 下面）
- 把 "Show the agent picker in the composer" 拨到 on
- 关掉桌面端，重新打开
- 验证：新建一个 session，看 Composer 旁边的 agent picker 里有没有 Sisyphus / Hephaestus 之类的 OMO agent
如果你没看到那个 Advanced 区域的选项——说明你的桌面端还没升到 v1.17.5（这个开关是 v1.17.5 才加的，v1.17.0 - v1.17.4 没有 UI 入口，要走情况二）。
情况二：v1.17.0 - v1.17.4 的桌面端（开关 UI 还没加）
这个区间版本的桌面端 settings.general.showCustomAgents 默认是 false，但没有 UI 让你改。要直接编辑配置文件。
~/.config/opencode/opencode.json（Windows 在 %APPDATA%\opencode\），加 settings.general.showCustomAgents：
plugin 那一项保留你原来已有的 plugin 数组。settings 整块如果不存在就加，存在就合并 general.showCustomAgents: true。
改完保存，重启桌面端。
情况三：v1.15.x / v1.16.x 的桌面端（不只是 UI 隐藏，plugin 加载报错）
issue 那种 Bun.serve failed to load plugin 的报错，UI 开关没用——plugin 进程根本没起来。
修法两步走：
第一步：清缓存
第二步：重装
OMO 官方安装命令（从 OMO README 直接拷的）：
Ultimate 版（OpenCode 用的就是 Ultimate）会走 TUI，问你一堆订阅问题。如果想跳过 TUI：
--claude / --gemini / --copilot 这几个 flag 按你实际订阅挑。OMO 文档里有完整 flag 列表（--openai、--opencode-zen、--zai-coding-plan、--opencode-go、--kimi-for-coding 等）。
重装完跑 bunx oh-my-openagent doctor，6 类检查（System / Config / TUI Plugin / Tools / Models / Team Mode）走一遍：exit code 0 是全过，1 是有 error，2 是只有 warning。
注意：不要用 npm install -g 或 bun add -g。OMO 是 plugin，必须从 OpenCode 加载 plugin 的位置解析，全局安装官方不支持。
情况四：终极退路——回退版本
如果上面都试过还不行（一般是有 mix-up 的中间态：plugin 升级到一半、桌面端版本老、缓存损坏），回退到 v1.14.29 或 v1.14.30——这是 OMO 在桌面端完全正常的最后一个稳定段（issue 的用户报告 v1.14.35 web 版本"works well with the plugin"）。
回退：
回退后清一次 OMO 缓存再装 OMO（命令同情况三第二步）。
重装完怎么确认真的回来了
四件事全做才算完整。
1. CLI 列出所有 agent
10 个 agent 应该全在。
2. 桌面端 picker 看得到
新建 session，打开 Composer 旁边那个 agent 下拉。v1.17.5+ 还要 Advanced → Show custom agents 是 on。
3. trigger word 触发
在 Composer 里输入 ultrawork 或者缩写 ulw。回车后，agent 行为应该明显不同（Sisyphus 接管、走团队模式、todo 自动追踪）。
4. doctor 全过
6 类检查都 0 警告，exit code 0。
第 1 + 2 + 3 是用户视角的验证，第 4 是配置层面的验证。4 个都对，OMO 算彻底回来了。
关键 issue / PR / 版本号清单
下面是引用过的所有可验证来源，方便你交叉核对：
- Issue #29300 — v1.15.13 桌面端 Bun.serve 错误，含 CLI 输出 + sidecar 日志原文
- Issue #29496 / #29515 — v1.15.13 → v1.16.0 桌面端 picker 默认隐藏 plugin agent
- Issue #25840 / #28287 / #29300 — v1.14.34 之后 Tauri→Electron 切架构的同源问题
- PR #32491 — fix(app): show build/plan agent picker in v2 layout，关联到 #29496
- OMO 仓库的 installation.md（958 行安装文档）
- OpenCode 仓库，当前 latest release v1.17.9（2026-06-21）
- v1.14.34 架构切换：Tauri → Electron
- v1.16.0 picker UI 重做，showCustomAgents 默认 false
- v1.17.5 在 Settings → Advanced 加 "Show custom agents in the composer" UI 开关
OMO 在桌面端能不能用，跟 OpenCode 版本、缓存状态、UI 开关都有关。changelog 上看不到 sidecar 加载失败的原因，得 CLI、日志、设置一起查。上面 4 个情况按顺序试，多数桌面端 OMO 消失都能找回来。
