AI不止语 441d024cd6 fix(installer): Hermes 支持一直是坏的 —— 改为全局安装并给出可粘贴配置（#45） ...

## 我们装错了目录，一直没生效

#45 报告人说「项目级 .hermes/skills/ 里的 20 个 skill 全部返回 404，必须手动
复制到 ~/.hermes/skills/ 才被识别」。查官方文档核实，他是对的：

hermes-agent.nousresearch.com/docs/user-guide/features/skills 明确
Hermes 只自动加载 ~/.hermes/skills/（原文 "the primary directory and source
of truth"），项目级目录不被自动发现；外部目录必须写进 ~/.hermes/config.yaml
的 skills.external_dirs。

而我们从支持 Hermes 起就只装项目级 .hermes/skills/ —— 那个目录 Hermes 根本
不读。这不是「不好用」，是「装了完全不生效」，比不支持更糟。

## 改法

- TARGETS 给 Hermes 加 global（~/.hermes/skills），全局成为推荐装法
- 项目级仍保留（skills 可随仓库分发），但装完打印**可直接粘贴**的配置片段：
      skills:
        external_dirs:
          - <项目绝对路径>/.hermes/skills
  不替用户改 config.yaml —— 那是他们的文件。文档里也写明「配置里不存在的
  路径会被静默跳过」，所以写错不会报错、只会没生效。
- 全局模式**不写 bootstrap**：Hermes 的用户级指令文件约定没有公开文档，
  往 $HOME 根目录写 HERMES.md 是猜路径 + 污染主目录。实测确认全局装完
  $HOME 根目录 0 个文件、卸载 0 残留。

## 文档与清单

- docs/README.hermes.md 开头重写，把「必须全局」放在最前面，并注明
  v1.7.8 及更早只支持项目级 = 装了不生效，是我们的实现错误
- 简繁 README：全局支持清单加 Hermes Agent，工具表的安装命令改为 --global
- verify-release.sh 的 GLOBAL_OK 加 hermes、GLOBAL_NO 移除

## 验证

- 全局：装 20 skills 到 ~/.hermes/skills、$HOME 根目录 0 文件、卸载 0 残留
- 项目级：正确打印 A/B 两种方案与绝对路径的 config.yaml 片段
- audit.sh 166 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail

注：#45 的后半部分（7 个 skill 文件里 24 处硬编码 Claude 工具名）本次未动。
那属于行为塑造内容，且 references/hermes-tools.md 已有完整映射表，
应走「强化映射表引用」而非把正文改成某个 harness 专属工具名。

2026-08-08 14:55:21 +08:00

..

superpowers-zh.js

fix(installer): Hermes 支持一直是坏的 —— 改为全局安装并给出可粘贴配置（#45）

2026-08-08 14:55:21 +08:00