Plugin not found

你会遇到什么

/plugin install superpowers@... 报 plugin not found / 找不到插件。你以为名字写错了，其实是市场源没加：superpowers 不在当前已配置的市场源里（上游市场与社区市场源名字不同）。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

插件市场是"先加源、后安装"的机制：插件不在已配置的市场源里，就找不到。上游市场与社区市场源名字不同，教程里写哪个渠道的版本，就要加对应的源。

插件安装是“先加源、后安装”的两级寻址：第一步把市场源注册进客户端（/plugin marketplace add），客户端拉取该源的插件目录；第二步 install 才在已注册的源里按名字查找。plugin not found 出现在第二步，说明第一步没生效——要么源没加，要么名字和源里的不对应。

源名是“仓库名 + 渠道标识”（obra/superpowers-marketplace），不同渠道的同一插件是不同条目，教程用哪个渠道就得加哪个源。

验证也走两级：/plugin marketplace list 看源有没有注册进去（配置层），再开新会话 /find-skills 看技能是否可见（运行时层）——只验证第二层，第一层出错时会反复踩同一个坑。

一步步来

1. 先加市场源 — 必做

/plugin marketplace add obra/superpowers-marketplace

（或 claude-plugins-official，取决于你要哪个渠道的版本。）

2. 再装 — 必做

/plugin install superpowers@superpowers-marketplace

3. 确认与更新 — 必做

/plugin marketplace list

检查源已生效；必要时 /plugin marketplace update 后重试。

怎么确认修好了

新会话里验证技能可见（掘金教程标准验证路径）：

/plugin marketplace list
→ 源列表中含 superpowers 对应源
新会话执行 /find-skills → 技能出现

其它环境的表现

症状

/plugin install superpowers@... 报 plugin not found / 找不到插件。

原因

市场源未添加或名字写错：superpowers 不在当前已配置的市场源里（上游市场与社区市场源名字不同）。

解法

1. 先加市场源：/plugin marketplace add obra/superpowers-marketplace（或 claude-plugins-official，取决于你要哪个渠道的版本）。
2. 再装：/plugin install superpowers@superpowers-marketplace。
3. 确认：/plugin marketplace list 检查源已生效；必要时 /plugin marketplace update 后重试。