@akshay_pachaar: ~/.hermes 文件夹的结构解析。一个文件夹控制着你的 Hermes 智能体所知、所记和所能做的一切。了解…

X AI KOLs Following 工具

摘要

详细拆解 ~/.hermes 文件夹结构,解释配置、身份、记忆、技能、自动化和可观测性如何组织,以定制 Hermes AI 智能体。

~/.hermes 文件夹的结构解析。 一个文件夹控制着你的 Hermes 智能体所知、所记和所能做的一切。理解其布局,是将 Hermes 视为黑箱与实际定制它的分水岭。 以下是其内部结构以及每部分的重要性。 **配置** **config.yaml** 是所有非秘密信息的真相源:模型选择、终端后端、工具启用、MCP 服务器。**env** 存放你的 API 密钥和机器人令牌。**auth.json** 存储 OAuth 凭据。 然后是 **SOUL.md**。它占据系统提示中的第 1 号位置,在任何其他内容加载之前。它定义了智能体是谁:个性、语气、沟通风格、硬性限制。智能体所写、所创、所忆的一切都经过这一身份层。 **知识** **memories/** 包含两个小文件。**MEMORY.md**(2,200 字符)存放项目约定、工具特性、经验教训。**USER.md**(1,375 字符)存放你的个人资料。 两者都会在会话开始时以冻结快照的形式注入系统提示。当它们填满时,智能体会进行合并:合并条目、去除冗余,只保留密集有用的内容。 **能力** **skills/** 是学习循环的所在地。每个技能都是一个自包含的能力:一个 **SKILL.md**(过程)、一个 **references/** 文件夹(智能体读取的文档)以及 **scripts/**(可执行辅助脚本)。 技能来自三个来源:随 Hermes 预装、通过 **hub/** 从中心下载,或由智能体在你的会话中自行创建。Hermes 自带 687 项技能,涵盖 18 个类别,你可以将任何 GitHub 仓库添加为自定义源。 **运行时状态** **sessions/** 存储每个平台的会话元数据。**state.db** 是一个 SQLite 数据库,带有 FTS5 索引,支持第二层记忆。正是这个数据库使得“三周前我们讨论了什么?”能够在 CLI 和消息界面中真正有效。 **自动化** **cron/** 包含 **jobs.json** 中的定时任务及其输出在 **output/** 中。网关守护进程每 60 秒触发一次,并在隔离会话中运行到期的任务。你用纯英语描述调度计划,Hermes 会将其转换。 **扩展 + 可观测性** **plugins/**、**hooks/** 和 **skins/** 是用户定制的界面。**logs/** 为你提供 **agent.log**、**gateway.log** 和 **errors.log** 用于调试。 你不会手动编辑这些文件中的大多数。但了解这个布局意味着你确切知道身份、记忆、技能、自动化和状态存放在哪里,以及它们如何连接。 我写了一篇深度文章,涵盖 Hermes 智能体的架构、记忆系统、自我进化技能、GEPA 优化以及设置多个专用智能体。 以下是该文章的引用。
查看原文
查看缓存全文

缓存时间: 2026/05/16 13:20

~/.hermes 文件夹的解剖结构

这一个文件夹掌控着你 Hermes 智能体所了解、记住以及能做的一切。理解它的布局,是将 Hermes 当作黑箱使用与真正定制它的分水岭。

以下是它内部的内容,以及每个部分为什么重要。

配置

config.yaml 是所有非机密信息的真相来源:模型选择、终端后端、工具启用、MCP 服务器。env 存放你的 API 密钥和机器人令牌。auth.json 存储 OAuth 凭据。

然后是 SOUL.md。它在系统提示中占据第一槽位,在任何其他内容加载之前生效。它定义了智能体是谁:个性、语气、沟通风格、硬性限制。智能体编写、创建和记住的所有内容都经过这个身份层。

知识

memories/ 包含两个小文件。MEMORY.md(2200 字符)保存项目约定、工具怪癖和经验教训。USER.md(1375 字符)保存你的个人资料。

两者都在会话开始时作为冻结快照注入系统提示。当它们填满时,智能体会进行整合:合并条目、删除冗余、只保留紧凑且有用的内容。

能力

skills/ 是学习循环所在。每个技能都是一个独立的能力:一个 SKILL.md(过程)、一个 references/ 文件夹(智能体阅读的文档)和 scripts/(可执行辅助工具)。

技能来自三个来源:Hermes 自带、通过 hub/ 从 Hub 下载,或者智能体在你会话期间自行创建。Hermes 附带了 18 个类别共 687 个技能,你可以将任何 GitHub 仓库添加为自定义源。

运行时状态

sessions/ 存储每个平台对应的会话元数据。state.db 是支持二级记忆的 SQLite 数据库(带有 FTS5 索引)。这正是让“我们三周前讨论过什么?”这个功能在 CLI 和消息平台上都能生效的关键。

自动化

cron/jobs.json 中保存计划任务,并在 output/ 中保存其输出。网关守护进程每 60 秒触发一次,并在隔离的会话中运行到期的任务。你用自然语言描述计划,Hermes 会将其转换。

扩展与可观测性

plugins/hooks/skins/ 是用户自定义的表面区域。logs/ 提供 agent.loggateway.logerrors.log 用于调试。

你不会手动编辑这些文件中的大部分。但了解这个布局意味着你确切知道身份、记忆、技能、自动化和状态存放在哪里,以及它们如何连接。

我写了一篇完整的深度文章,涵盖 Hermes 智能体的架构、记忆系统、自进化技能、GEPA 优化以及设置多个专用智能体。

该文章引用于下方。

相似文章