https://ok-komputer.github.io/tags/omo/ Recent content in Omo on OK Komputer https://avatars.githubusercontent.com/u/226872255?v=4 https://avatars.githubusercontent.com/u/226872255?v=4 Hugo -- 0.161.1 zh-cn Fri, 29 May 2026 13:50:00 +0800 https://ok-komputer.github.io/posts/omo-agent-not-showing/ Fri, 29 May 2026 13:50:00 +0800 https://ok-komputer.github.io/posts/omo-agent-not-showing/ <h2 id="问题">问题</h2> <p>装了 oh-my-openagent 之后，<code>opencode agent list</code> 和执行 <code>npx oh-my-openagent doctor</code> 都显示正常，但 opencode TUI/Desktop 的 Agent 选择器里<strong>只显示 <code>plan</code> 和 <code>build</code></strong>，没有 Sisyphus、Prometheus、Oracle 等 OMO Agent。</p> <p>这个问题在官方仓库有多人在追踪：</p> <ul> <li><a href="https://github.com/code-yeongyu/oh-my-openagent/issues/3456">#3456</a> — &ldquo;[Question]: installed OMO, reopen opencode can not find Sisyphus in agents&rdquo;</li> <li><a href="https://github.com/code-yeongyu/oh-my-openagent/issues/3835">#3835</a> — &ldquo;[Bug]: oh-my-openagent custom agents not showing in OpenCode Desktop UI after v1.14.x update&rdquo;</li> </ul> <h2 id="原因分析">原因分析</h2> <p>实际导致这个症状的原因有两种，需要对症排查：</p> <h3 id="原因一配置作用域不匹配">原因一：配置作用域不匹配</h3> <p>OpenCode 的配置文件有两个层级：</p> <table> <thead> <tr> <th>作用域</th> <th>路径</th> <th>优先级</th> </tr> </thead> <tbody> <tr> <td>全局</td> <td><code>~/.config/opencode/opencode.json</code></td> <td>低</td> </tr> <tr> <td>项目本地</td> <td><code>.opencode/opencode.json</code>（启动目录下）</td> <td><strong>高</strong></td> </tr> </tbody> </table> <p>通过 <code>npx oh-my-openagent install</code> 安装时，写入的是<strong>全局</strong>配置。但如果启动 opencode 的工作目录下恰好存在 <code>.opencode/opencode.json</code>（哪怕只有简单几行），opencode 就会优先读这个本地配置，而本地配置可能没有注册插件。</p>