编辑文档 - OpenCode 桌面端 OMO 消失：哪个版本开始的 + 最新版怎么把它找回来

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

![[062101.png]]

---

桌面端安装了 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`）原文：

```
ERROR 2026-06-03T08:18:53 service=plugin path=oh-my-openagent@latest error=Runtime skill source server requires Bun.serve failed to load plugin
```

这条日志在 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：

```
opencode agent list

# 或者让 opencode 客户端自行检查
opencode agent list
```

输出应该至少包含这些：

```
Sisyphus - ultraworker (primary)
Hephaestus - Deep Agent (primary)
Prometheus - Plan Builder (primary)
Atlas - Plan Executor (primary)
build (subagent)
compaction (primary)
explore (subagent)
general (subagent)
plan (subagent)
summary (primary)
```

![[Pasted image 20260621215426.png]]

如果 CLI 输出齐全、桌面端 picker 看不见 plugin agent——就是典型的 "plugin 装上了但被 UI 过滤"。

![桌面端 agent picker：只剩 Plan/Build，OMO agent 全部被过滤](assets/picker-symptom.png)

如果 CLI 输出也缺东西，看桌面端日志。Linux 路径：

```
~/.local/share/opencode/log/
```

里面找当天的 `.log` 文件，grep `oh-my-openagent` 和 `Bun.serve`：

```
grep "oh-my-openagent" ~/.local/share/opencode/log/*.log | grep "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 同源（用 `~/.local/share/opencode/log/`，不是 `~/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"**。这个开关默认是关的。

修法：

1. 桌面端打开 Settings（菜单或顶栏里）
2. 找到 Advanced 区域（在 通用 下面）
3. 把 "Show the agent picker in the composer" 拨到 on

![[Pasted image 20260621215718.png]]

4. 关掉桌面端，重新打开
5. 验证：新建一个 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`：

```json
{
  "plugin": ["oh-my-openagent"],
  "settings": {
    "general": {
      "showCustomAgents": true
    }
  }
}
```

`plugin` 那一项保留你原来已有的 plugin 数组。`settings` 整块如果不存在就加，存在就合并 `general.showCustomAgents: true`。

改完保存，重启桌面端。

### 情况三：v1.15.x / v1.16.x 的桌面端（不只是 UI 隐藏，plugin 加载报错）

issue 那种 `Bun.serve failed to load plugin` 的报错，UI 开关没用——plugin 进程根本没起来。

修法两步走：

**第一步：清缓存**

```
# Linux / macOS
rm -rf ~/.cache/opencode/packages/oh-my-openagent@latest

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:USERPROFILE\.cache\opencode\packages\oh-my-openagent@latest"
```

**第二步：重装**

OMO 官方安装命令（从 OMO README 直接拷的）：

```
bunx oh-my-openagent install
```

Ultimate 版（OpenCode 用的就是 Ultimate）会走 TUI，问你一堆订阅问题。如果想跳过 TUI：

```
bunx oh-my-openagent install --no-tui --platform=opencode --claude=yes --gemini=no --copilot=no
```

`--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"）。

回退：

```
# macOS / Linux 用 brew
brew install anomalyco/tap/opencode@1.14.30

# 或者直接拉旧版二进制
curl -fsSL https://opencode.ai/install | OPENCODE_VERSION=1.14.30 bash

# Windows 用 scoop
scoop install extras/opencode-desktop@1.14.30
```

回退后清一次 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 全过**

```
bunx oh-my-openagent 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 消失都能找回来。

摘要

标签多个标签用逗号分隔

分类