上下文文件

Hermes Agent 会自动发现并加载上下文文件，这些文件决定了其行为方式。部分文件为项目本地文件，从当前工作目录中发现。SOUL.md 现在是 Hermes 实例的全局文件，仅从 HERMES_HOME 加载。

支持的上下文文件

文件	用途	发现方式
.hermes.md / HERMES.md	项目指令（优先级最高）	向上遍历至 Git 仓库根目录
AGENTS.md	项目指令、规范与架构说明	启动时从当前工作目录（CWD）开始，逐步检查子目录
CLAUDE.md	Claude 代码上下文文件（也支持检测）	启动时从当前工作目录（CWD）开始，逐步检查子目录
SOUL.md	当前 Hermes 实例的全局个性与语气定制	仅从 `HERMES_HOME/SOUL.md` 加载
.cursorrules	Cursor IDE 编码规范	仅从当前工作目录（CWD）加载
*.cursor/rules/.mdc**	Cursor IDE 规则模块	仅从当前工作目录（CWD）加载

优先级系统

每个会话中，仅加载一种项目上下文类型（首个匹配项胜出）：.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              ← Loaded at startup (system prompt)
├── frontend/
│   └── AGENTS.md          ← Discovered when agent reads frontend/ files
├── backend/
│   └── AGENTS.md          ← Discovered when agent reads backend/ files
└── shared/
    └── AGENTS.md          ← Discovered when agent reads shared/ files

这种做法相较于启动时一次性加载所有内容具有两个优势：

无系统提示膨胀 —— 子目录提示仅在需要时出现
提示缓存保留 —— 系统提示在各轮对话中保持稳定

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

信息

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

AGENTS.md 示例

# Project Context

This is a Next.js 14 web application with a Python FastAPI backend.

## Architecture
- Frontend: Next.js 14 with App Router in `/frontend`
- Backend: FastAPI in `/backend`, uses SQLAlchemy ORM
- Database: PostgreSQL 16
- Deployment: Docker Compose on a Hetzner VPS

## Conventions
- Use TypeScript strict mode for all frontend code
- Python code follows PEP 8, use type hints everywhere
- All API endpoints return JSON with `{data, error, meta}` shape
- Tests go in `__tests__/` directories (frontend) or `tests/` (backend)

## Important Notes
- Never modify migration files directly — use Alembic commands
- The `.env.local` file has real API keys, don't commit it
- Frontend port is 3000, backend is 8000, DB is 5432

SOUL.md

SOUL.md 控制代理的个性、语气和沟通风格。详情请参见个性页面。

位置：

~/.hermes/SOUL.md
或 $HERMES_HOME/SOUL.md（如果你使用自定义主目录运行 Hermes）

重要说明：

如果尚未存在 SOUL.md，Hermes 会自动创建一个默认文件
Hermes 仅从 HERMES_HOME 加载 SOUL.md
Hermes 不会在工作目录中搜索 SOUL.md
如果文件为空，则不会将任何内容添加到提示中
如果文件有内容，内容将在扫描和截断后原样注入

.cursorrules

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

这意味着你在使用 Hermes 时，现有的 Cursor 规范会自动生效。