Windows 上的 V2 与插件启动排查
核验日期：2026-11-12。适用 OpenCode V2。 本页依据公开文档整理，未执行第三方安装、登录或模型调用。
# 先辨认项目与版本#
原 code-yeongyu/oh-my-opencode 仓库现重定向到 oh-my-openagent↗。当前 README 的 OmO 5.x 使用 senpi（Pi 分支）独立运行时；其中 omo 安装、配置和命令不能直接视为 OpenCode V2 插件用法。
这不等于所有历史版本都不能工作，但必须以具体版本的宿主声明为依据。本站没有完成历史 OpenCode 插件版对 V2 的运行验证，不提供“换成 plugins 就兼容”的保证。
# 先检查原生程序#
记录 opencode --version，在 PowerShell 用 Get-Command opencode 确认运行的二进制路径，避免旧 V1 抢占 PATH。按官方安装入口↗选择对应架构；当前官方文档注明 Windows 包管理器不受支持，并提供独立 CLI 二进制。
# 再隔离插件#
备份配置后，用原生 V2 对照定位问题。原生可用而加插件失败时，收集插件版本、加载报错及本地目录路径。V2 配置中的本地插件条目应指向插件目录，不要沿用单个 JS 文件路径。
Bun、Node、Git 或权限问题必须根据具体错误判断；不要把安装另一个包管理器、管理员运行或全量重装列为通用修复。Windows 与 WSL 是不同环境，在一侧安装不意味着另一侧可用。