Hermes 完全看不到这些 Skill（HERMES_HOME 未被识别）- CC Switch

Quick fix

CC Switch 把 Symlink 写到了 ~/.hermes/skills/，手动复制到 $HERMES_HOME/skills/ 后 Hermes 即可识别；CN 版会话读取问题暂无用户侧解法。

Symptom

报错原文复制

Hermes Skill 同步路径未检测 HERMES_HOME 环境变量，导致 Symlink 写入错误目录

Cause

CC Switch 在同步 Hermes Skills 时硬编码使用 ~/.hermes/skills/ 作为目标路径，而 Hermes 实际从 $HERMES_HOME/skills/ 加载 Skills。Windows 上官方 Desktop 安装会把 HERMES_HOME 设为 C:\Users\<user>\AppData\Local\hermes，于是 Symlink 落在错误目录，Hermes 完全看不到这些 Skill。本问题还有第二个变体（#4648）：Hermes Agent CN 版的数据目录与官方版完全不同，其 state.db 位于 %APPDATA%\cn.org.hermesagent.desktop\runtime\hermes-home\state.db，且该机器的 HERMES_HOME 指向安装目录（D:\CodeSoftWare\Hermes）而非数据目录，导致 Session Manager 会话列表为空。该 issue 的另一位用户反馈，即使把路径改成 AppData\Local\hermes「还是有 bug」，并指出 CLI 与 Desktop 的配置不一致，因此环境变量修正并非对所有安装方式都彻底有效。

Fix

1. 1

   先确认 Hermes 实际的数据目录：运行 hermes config path 或 echo $HERMES_HOME，找到 Hermes 真正读取 skills 与 state.db 的位置。

2. 2

   针对 Skill 不生效（#3811，已验证有效）：把 CC Switch 在 ~/.hermes/skills/ 下创建的 Symlink 手动复制到 $HERMES_HOME/skills/（例如 C:\Users\<user>\AppData\Local\hermes\skills\），复制后 Hermes 立即识别到这些 Skill。

3. 3

   注意：有用户反馈将路径改为 C:\Users\xxx\AppData\Local\hermes 后仍有 bug（CLI 与 Desktop 版配置行为不同），若手动复制无效，请核对自己是 npm 安装的 CLI 还是官方 Desktop 安装。

4. 4

   针对 Session Manager 读取 CN 版会话为空（#4648，仍 open）：目前 CC Switch 设置中没有可自定义 hermesConfigDir 的 UI 入口，用户侧无法手动指向 %APPDATA%\cn.org.hermesagent.desktop\runtime\hermes-home，只能等待官方增加 CN 版固定路径探测或暴露自定义数据目录入口。

Affected Versions

ToolHermes（含 Hermes Agent CN 版，runtime 0.17.0-cn.1 / kernel 0.17.0）

Version未知

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #3811Hermes Skill 同步路径未检测 HERMES_HOME 环境变量，导致 Symlink 写入错误目录
• #4648[bug] Session Manager 无法读取 Hermes Agent CN 版本的会话（state.db 路径不匹配）

FAQ

我已经把 HERMES_HOME 改成 C:\Users\xxx\AppData\Local\hermes 了，为什么还是有 bug？

有用户反馈 CLI 和 Desktop 版的配置行为不一样，CC Switch 目前更适合 npm 安装的 CLI 场景；改成该路径后仍有问题的情况在 issue 中已有同样报告，尚未有确认的通用解法。

可以在 CC Switch 设置里手动指定 Hermes 的数据目录（hermesConfigDir）吗？

不能。#4648 的报告者确认设置中未找到可自定义 hermesConfigDir 的 UI 入口，因此 CN 版用户暂时无法手动指向 …\runtime\hermes-home 目录。

怎么确认 Hermes 实际使用的路径？

可通过 hermes config path 查看实际路径；Hermes 的路径逻辑是 HERMES_HOME 环境变量优先，未设置时默认 ~/.hermes/。

相关问题

供应商 API Key 被覆盖：Codex 重启或切换后升级到 cc-switch v4.0.0 或更高版本；该版本重写了切换逻辑，避免供应商密钥互相覆盖并恢复官方登录态。6 issues mergedCodex Desktop 项目列表消失或推理档位减少 - CC Switch 配置问题多数相关 issue 仍未解决；升级 CC Switch 或切换供应商后，Codex 的 model_provider 字段变化导致项目历史消失；升级至 v3.19.1+ 统一为 custom 可解决。若推理档位减少，需在 Codex 设置中手动启用完整档位。4 issues mergedError from provider (Console Go)检查模型映射是否被正确应用，若映射目标模型已下线或请求体含上游不支持的 tool_choice/图片格式，需调整配置或等待 cc-switch 修复翻译层。5 issues merged