Hermes

厂商： Hermes 安装名称： hermes 状态： 预览版 原生配置： ~/.hermes/config.yaml

安装Copy Anchor Link

apothem install --harness hermes

适配器将共享配置档案转换为 Hermes Agent 的用户全局配置文件，并在工具根目录下安装 Apothem 支持集合。

写入的文件： ~/.hermes/config.yaml、配置档案文档 ~/.hermes/apothem/rules/00-apothem-profile.md，以及 ~/.hermes/.apothem/support/ 下的支持文件

配置档案文档以一个 Apothem 支持文件小节结尾，该小节写明每种仓库风格的引用（rules/<name>.md、templates/...、hooks/...）所解析到的、位于 ~/.hermes/.apothem/support/ 下的绝对目录。

配置档案到原生配置的映射Copy Anchor Link

该适配器读取 Apothem 的共享配置档案，并渲染原生 YAML 配置，其中包括配置档案的 MCP 清单。MCP 服务器来自配置档案的 mcp_servers 部分，每次安装与更新时都渲染到 config.yaml 中，而非复制为文件。适配器还会将 ~/.hermes/.apothem/support/skills 添加到 skills.external_dirs，即 Hermes 读取的额外技能目录列表，Hermes 正是通过它找到已安装的技能。该条目排在你已列出的所有条目之后，你的其他键保持原样。配置档案的身份、偏好与规则写入配置档案文档本身。共享的命令、技能、辅助器定义、规则、模板与钩子提示词，则作为支持材料落在 ~/.hermes/.apothem/support/ 下。

兼容性说明Copy Anchor Link

预览版适配器。Hermes 通过 skills.external_dirs 加载 Apothem 技能，但不会自行加载支持树的其余部分或配置档案文档：config.yaml 中没有其他任何内容指向那里，Hermes 读取的上下文文件也没有任何一个指向那里，因此安装之后，Hermes 运行时不带有 Apothem 的规则或钩子。

名称冲突。 Hermes 为技能记载了以下优先顺序：项目的技能（<project>/.hermes/skills/ 和 <project>/.agents/skills/），然后是 ~/.hermes/skills/，然后是 skills.create_dir，然后是 skills.external_dirs 下列出的文件夹。Apothem 目录是一个 external_dirs 条目，因此它排在最后。所查阅的 Hermes 文档没有说明当两个位置存放着同名技能时 Hermes 会加载哪一份副本；Apothem 将该顺序理解为更早的位置胜出，因此可以预期你保存在更早位置中的同名技能会优先于 Apothem 副本。Apothem 只写入 config.yaml 以及 ~/.hermes/.apothem/support/ 之下，绝不写入那些更早的位置，因此安装、更新和卸载都不会替换你保存在那里的技能。

apothem update 会保留你添加到 config.yaml 中的键，包括 skills.config 以及你自己的 skills.external_dirs 条目。适配器将配置档案的 MCP 清单写在顶层 mcp_servers 键下，Hermes 从该处读取 MCP 服务器。较早的 Apothem 发布将其写在 auxiliary.mcp 下，而 Hermes 会将该处读取为用于 MCP 工具分派的辅助模型；当该区块仍与此类发布会根据你当前的共享配置档案写入的内容相符时，apothem update 和 apothem uninstall 都会将其移除（该区块在何种情况下会保留，参见卸载）。（Hermes 的行为依据其用户指南中关于技能（于 2026-10-24 查阅）和 MCP（于 2026-10-02 查阅）的页面。）

config.yaml 中的注释。 Apothem 使用一个会丢弃注释的 YAML 库重写该文件。当该文件带有你的注释且缺少该条目时，Apothem 会保持该文件不变，安装会停止，并显示一条写明该键的消息。请自行添加该条目，然后再次运行安装：

skills:
  external_dirs:
    - ~/.hermes/.apothem/support/skills

你自己添加的条目算作你的：如果你已经列出了该目录，Apothem 会原样保留你的条目，卸载也会将其保留在原处。

验证Copy Anchor Link

apothem verify --harness hermes

verify 命令确认：

1. 原生配置存在于预期路径。
2. 每个受管目标都存在；受管文件非空，并且 JSON 或 YAML 配置可以解析。添加 --profile PATH 还可以确认已安装的文件与该配置档案相符。
3. 原生配置中的 skills.external_dirs 列出了 ~/.hermes/.apothem/support/skills。没有该条目时，Hermes 不会加载已安装的技能；apothem update 会将其重新添加。
4. 适配器专属的验证例程报告成功。

更新Copy Anchor Link

apothem update --harness hermes

根据共享配置档案的当前状态重新派生原生配置；无论你更新多少次，skills.external_dirs 中的 Apothem 条目都只列出一次。 在编辑 ~/.config/apothem/profile.yaml 或升级已安装的 Apothem 包之后运行。

卸载Copy Anchor Link

apothem uninstall --harness hermes

移除适配器添加的内容：其安装时在 config.yaml 中记录的 mcp_servers 条目和 skills.external_dirs 条目（你自己的键会保留，包括你自己的 external_dirs 条目和 skills.config，且只有当该文件由 Apothem 创建、并且其中不再留有任何属于你的内容时，才会删除该文件）、配置档案文档以及支持树。共享配置档案 YAML 和 Apothem 引擎不受影响。

对于由较早发布完成的安装（它将配置档案的服务器写在 auxiliary.mcp 下），当该区块仍与那次发布会根据位于 ~/.config/apothem/profile.yaml 的当前共享配置档案写入的内容相符时，该区块也会被移除。这与 apothem update 所应用的规则相同，因此不先更新就直接卸载，只要配置档案的 MCP 服务器没有变化，就不会留下过时的区块。你编辑过的区块、不再与你当前配置档案的 MCP 服务器相符的区块，或者没有可读取的共享配置档案可供比对的区块，会保留原位，而你的其余 auxiliary 设置始终会保留。

合规闸门Copy Anchor Link

python -m apothem.conformity.gate --all .

故障排查Copy Anchor Link

配置开关Copy Anchor Link

另请参阅Copy Anchor Link

• 所有工具——受支持工具的完整目录
• 安装指南——将 Apothem 安装到此工具中
• apothem harnesses 参考——从 CLI 列出并检查适配器