上下文文件

Hermes Agent 会自动发现并加载影响其行为的上下文文件。有些是项目本地的，它们会从您的工作目录中发现。SOUL.md 现在是 Hermes 实例的全局文件，并且只从 HERMES_HOME 加载。

支持的上下文文件

文件	用途	发现方式
.hermes.md / HERMES.md	项目指令（最高优先级）	遍历 git 根目录
AGENTS.md	项目指令、约定、架构	启动时的当前工作目录 + 渐进式子目录
CLAUDE.md	Claude 代码上下文文件（也检测）	启动时的当前工作目录 + 渐进式子目录
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/ 没有自己的上下文文件，读取 backend/src/main.py 也会发现 backend/AGENTS.md。

信息

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

AGENTS.md 示例

# 项目上下文

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

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

## 约定
- 前端代码必须使用 TypeScript 严格模式
- Python 代码遵循 PEP 8，所有地方使用类型提示
- 所有 API 端点返回 JSON，形状为 `{data, error, meta}`
- 测试文件放在 `__tests__/` 目录（前端）或 `tests/`（后端）

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

SOUL.md

SOUL.md 控制着代理的个性、语气和沟通风格。有关完整详情，请参阅 Personality 页面。

位置：

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

重要细节：

如果不存在，Hermes 会自动生成一个默认的 SOUL.md
Hermes 只从 HERMES_HOME 加载 SOUL.md
Hermes 不会探测工作目录以查找 SOUL.md
如果文件为空，则不会向提示中添加任何 SOUL.md 的内容
如果文件有内容，内容将在扫描和截断后原样注入

.cursorrules

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

这意味着当使用 Hermes 时，您现有的 Cursor 约定会自动应用。