文章目录
- 📖 介绍 📖
- 🖥️ 演示环境 🖥️
- 📒 四阶段反查：从「不生效」倒推到根因 📒
-
- 🧭 先建立一张地图：四个阶段，四种查法
- 🚪 第一阶段：官方市场不是每次都会自己注册
- 🔌 第二阶段：装上了，但会话还没拿到它
-
- 🪜 三份 settings 文件，谁盖谁
- 🐞 那个真实存在的 bug：装了却不写 enabledPlugins
- 🧩 第三阶段：列表里有它，技能却不出现
-
- 📁 目录放错地方，是最常见的一种
- 🔗 装上之后，指向目录外部的路径全部失效
- 🧹 缓存记录还在，目录没了
- 🚫 默认关闭与依赖没装上
- 🛡️ 第四阶段之前：三个市场别装错，命令别写错
-
- 🗂️ 三个市场，名字和仓库名不一致
- ⌨️ 命令写法纠错表
- 🧲 还有一个内置目录：不带 @ 不一定是报错
- 📮 source 只有五种合法形态
- 🛑 第四阶段：策略拦的，本地改不动
- 🧾 收尾：一条命令链，把四阶段一次跑完
- 📋 实测记录：哪些是跑过的，哪些不是
- ⚓ 相关链接 ⚓
📖 介绍 📖
照着教程敲完 /plugin install commit-commands@claude-plugins-official，回车，看到成功提示，心满意足地敲 / 找新命令——什么都没有。Marketplace 标签里它明明带着勾，Installed 标签里翻三遍也没有它。
更折磨的是重启。重启完还是一样。于是你开始怀疑是不是自己漏了一步，把整条命令重新敲一遍，结果依旧。
这种「装上了但不生效」最耗人的地方，是它不报错。没有红字、没有 traceback、没有任何东西告诉你哪里错了，你只能一遍遍重装。而真实原因往往小得可笑：官方市场压根没在这台机器上注册、或者安装摘要最后一句写的是「需要 reload」而你没注意、或者插件目录里的 skills/ 放错了位置。
官方排错文档其实把每种症状都列全了，但它是按报错字符串组织的——你得先知道自己该搜哪句话。这里反过来：按现象组织，四阶段一路反查到根因，每阶段给能直接抄的命令。四张表读完，这类问题基本都能自己定位。
