本地/离线部署后插件显示不可用（感叹号）

症状

手动下载 zip 解压放到 `~/.claude/plugins/local-superpowers` 后，`/plugin list` 显示感叹号不可用；直接复制仓库目录也报缺文件。

原因

tarball 内各 harness 目录（.claude-plugin/.codex-plugin/.cursor-plugin）带 plugin.json，但不含编译产物 dist/index.js——本地插件形态要求完整插件包；纯 SKILL 仓库按插件路径接入会缺件。

解法

1. 当技能用（推荐）：把仓库内 `skills/` 下全部技能目录复制到 Claude 能读的 skills 目录，新会话启用；或 `npx superpowers-zh` 方式拉取。

2. 当本地插件用：`/plugin marketplace add <本地路径>/.claude/plugins/superpowers/superpowers-main` → `/plugin install superpowers@superpowers-dev` → `/reload-plugins`。

3. Codex CLI 形态（本市场实测路径）：下载 tarball → `cp -r skills ~/.codex/skills/superpowers`，无需编译产物。

验证证据

- 网页案例：[CSDN m0_58528895/161265224](https://blog.csdn.net/m0_58528895/article/details/161265224)（2026-05）——离线部署缺 plugin.json + dist/index.js 导致不可用（作者原仓库确实无编译产物）。

- 网页案例：CSDN aicoding.csdn.net（2026）——本地路径 marketplace add → install → reload 的可行接入流程。

- 本市场实测：tarball 含 .claude-plugin/plugin.json 但无 dist/（2026-08-28 解包核实）；skills 目录复制形态 14/14 有效。