@akshay_pachaar: ~/.hermes 文件夹的结构解析。一个文件夹控制着你的 Hermes 智能体所知、所记和所能做的一切。了解…
摘要
详细拆解 ~/.hermes 文件夹结构,解释配置、身份、记忆、技能、自动化和可观测性如何组织,以定制 Hermes AI 智能体。
查看缓存全文
缓存时间: 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.log、gateway.log 和 errors.log 用于调试。
你不会手动编辑这些文件中的大部分。但了解这个布局意味着你确切知道身份、记忆、技能、自动化和状态存放在哪里,以及它们如何连接。
我写了一篇完整的深度文章,涵盖 Hermes 智能体的架构、记忆系统、自进化技能、GEPA 优化以及设置多个专用智能体。
该文章引用于下方。
相似文章
@gregisenberg:一步步配置 Hermes agent,内置记忆、40+ 工具、手机可用,以及 Hermes 与 OpenClaw 的对比
Hermes 是一款运行在终端的个人 AI agent,内置记忆与 40+ 工具,支持手机端,并与 OpenClaw 进行对比。
@akshay_pachaar: Hermes 智能体的三层记忆。AI 智能体会在会话结束后忘记一切,但 Hermes 不会。它拥有三…
Hermes 智能体的三层记忆系统结合了始终存在的小型 Markdown 文件、基于 SQLite+FTS5 的全文会话搜索以及可插拔的外部提供程序,为 AI 智能体提供持久且经过精心筛选的记忆,每次交互都会进行组合。
@Saboo_Shubham_: Hermes Agent 可视化解析(AI工作的操作系统)。
Shubham Saboo 分享的 Hermes Agent(AI工作的操作系统)可视化解析。
@akshay_pachaar:Hermes 代理中的自我进化技能。我发现这是 Hermes 中最强大的功能。代理不仅仅是……
Hermes 代理具有自我进化技能,可将成功的故障排除流程保存为可重用的技能文件,并由后台 Curator 自动管理,合并或归档技能,且不会丢失数据。
@akshay_pachaar: https://x.com/akshay_pachaar/status/2054564519280804028
Nous Research 推出的 Hermes Agent 综合指南,重点介绍其技能自进化、三层记忆架构以及用于构建持久化 AI 智能体的 GEPA 优化能力。