OpenCode + Superpowers 安装配置完全指南：从踩坑到端到端实战

原文链接：https://zhuanlan.zhihu.com/p/2041691047571482560

标准安装方式 vs "Fetch INSTALL.md"：一回事

如果你看过 Superpowers 的官方 README，会看到另一种安装方法：

告诉 OpenCode：Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

和前面手动改 opencode.json 有什么区别？没有。本质是同一件事，只是谁动手的区别：

方式	谁来改配置	适用场景
Fetch INSTALL.md（官方推荐）	AI agent 帮你改	想偷懒、信任 AI
手动加 plugin 字段（上节教的）	你自己改	想完全掌控配置
npm 手动装 + 本地路径（下面 2.5 会讲）	你自己改（指向本地）	Windows 上 Bun 安装失败时的退路

无论哪种，最终结果都一样：opencode.json 中加一行 plugin 配置，重启后 OpenCode 自动拉取源码并加载 skill。不需要你手动 git clone 或 npm install。

那为什么 Windows 用户需要第三种方式？ 因为前两种依赖 OpenCode 内置的 Bun 安装器，而 Bun 在 Windows 上处理 git+https:// 协议时可能遇到兼容性问题。npm 是更稳的退路。

提示： Bun 更新频繁，这些问题可能已被修复。先试方式 B，10 秒能验证（见第 3 节），装不上再切方式 C。

 

Windows 踩坑：插件装了但 skills 没出来

这是 Windows 用户最常见的情况：

• opencode.json 已经加了 plugin
• OpenCode 重启了
• 但 agent 完全不知道有 superpowers，问 "Tell me about your superpowers" 它一脸懵

根本原因： OpenCode 在 Windows 上用 Bun 解析 git+https://... 这种 git-backed 包规范时可能遇到兼容性问题：

1. git+https URL 的缓存路径在 Windows 上构造可能出错
2. Bun 在 Windows 上有时找不到 git.exe（即便它在普通终端里能用）

提示： 如果你的环境直接安装成功（用第 3 节验证），就不需要下面的步骤。

结果：插件根本没被装上，但 OpenCode 也不会很明显地报错。