上下文文件

Hermes 智能体会自动发现并加载定义其行为方式的上下文文件。有些是项目本地的，会从您的工作目录中发现。SOUL.md 现在是全局的，对于该 Hermes 实例而言，仅从 HERMES_HOME 加载。

支持的上下文文件

文件	用途	发现方式
.hermes.md / HERMES.md	项目指令（最高优先级）	递归查找至 git 根目录
AGENTS.md	项目指令、规范、架构	启动时的工作目录 + 渐进式发现子目录
CLAUDE.md	Claude Code 上下文文件（也会被检测）	启动时的工作目录 + 渐进式发现子目录
SOUL.md	此 Hermes 实例的全局个性与语气定制	仅 `HERMES_HOME/SOUL.md`
.cursorrules	Cursor IDE 编码规范	仅工作目录
*.cursor/rules/.mdc**	Cursor IDE 规则模块	仅工作目录

优先级系统

每个会话只加载一种项目上下文类型（首次匹配生效）：.hermes.md → AGENTS.md → CLAUDE.md → .cursorrules。SOUL.md 始终作为智能体身份（插槽 #1）独立加载。

AGENTS.md

AGENTS.md 是主要的项目上下文文件。它告诉智能体您的项目结构如何、遵循哪些规范以及任何特殊指令。

渐进式子目录发现

会话开始时，Hermes 会加载来自您工作目录的 AGENTS.md 到系统提示词中。当智能体在会话期间通过（read_file、terminal、search_files 等操作）导航到子目录时，它会渐进式发现这些目录中的上下文文件，并在它们变得相关时将它们注入对话中。

my-project/
├── AGENTS.md              ← 启动时加载（系统提示词）
├── frontend/
│   └── AGENTS.md          ← 当智能体读取 frontend/ 文件时发现
├── backend/
│   └── AGENTS.md          ← 当智能体读取 backend/ 文件时发现
└── shared/
    └── AGENTS.md          ← 当智能体读取 shared/ 文件时发现

这种方法相比在启动时加载所有内容有两个优点：

避免系统提示词臃肿 — 子目录提示仅在需要时出现
保持提示词缓存 — 系统提示词在各轮次间保持稳定

每个子目录在每个会话中最多检查一次。发现过程也会向上遍历父目录，因此读取 backend/src/main.py 即使 backend/src/ 没有自己的上下文文件，也会发现 backend/AGENTS.md。

信息

子目录上下文文件会经过与启动时上下文文件相同的安全扫描。恶意文件会被阻止。

示例 AGENTS.md

# 项目上下文

这是一个使用 Python FastAPI 后端的 Next.js 14 Web 应用程序。

## 架构
- 前端：Next.js 14，使用 App Router，位于 `/frontend`
- 后端：FastAPI，位于 `/backend`，使用 SQLAlchemy ORM
- 数据库：PostgreSQL 16
- 部署：在 Hetzner VPS 上使用 Docker Compose

## 规范
- 所有前端代码使用 TypeScript 严格模式
- Python 代码遵循 PEP 8，处处使用类型提示
- 所有 API 端点返回 `{data, error, meta}` 结构的 JSON
- 测试放在 `__tests__/` 目录（前端）或 `tests/`（后端）

## 重要注意事项
- 切勿直接修改迁移文件 — 使用 Alembic 命令
- `.env.local` 文件包含真实 API 密钥，请勿提交
- 前端端口是 3000，后端端口是 8000，数据库端口是 5432

SOUL.md

SOUL.md 控制智能体的个性、语气和沟通风格。完整详情请参阅个性页面。

位置：

~/.hermes/SOUL.md
或者，如果您使用自定义主目录运行 Hermes，则是 $HERMES_HOME/SOUL.md

重要细节：

如果 SOUL.md 尚不存在，Hermes 会自动生成一个默认的
Hermes 仅从 HERMES_HOME 加载 SOUL.md
Hermes 不会在工作目录中探测 SOUL.md
如果文件为空，则 SOUL.md 的内容不会添加到提示词中
如果文件有内容，内容在扫描和截断后会被逐字注入

.cursorrules

Hermes 兼容 Cursor IDE 的 .cursorrules 文件和 .cursor/rules/*.mdc 规则模块。如果这些文件存在于您的项目根目录，并且没有找到更高优先级的上下文文件（.hermes.md、AGENTS.md 或 CLAUDE.md），它们将作为项目上下文加载。

这意味着您现有的 Cursor 规范在使用 Hermes 时会自动适用。