---
sidebar_position: 9
title: "个性与 SOUL.md"
description: "通过全局 SOUL.md、内置个性预设和自定义角色定义来自定义 Hermes Agent 的个性"
---

# 个性与 SOUL.md

Hermes Agent 的个性完全可自定义。`SOUL.md` 是**主要身份标识**——它是系统提示词（prompt）中的第一项内容，定义了 Agent 是谁。

- `SOUL.md` — 存放在 `HERMES_HOME` 中的持久角色文件，作为 Agent 的身份标识（系统提示词中的第 1 个槽位）
- 内置或自定义的 `/personality` 预设 — 会话级系统提示词覆盖层

如果你想改变 Hermes 的身份，或将其替换为完全不同的 Agent 角色，请编辑 `SOUL.md`。

## SOUL.md 的工作方式

Hermes 现在会自动在以下位置生成默认的 `SOUL.md`：

```text
~/.hermes/SOUL.md
```

更准确地说，它使用当前实例的 `HERMES_HOME`，因此如果你以自定义主目录运行 Hermes，它将使用：

```text
$HERMES_HOME/SOUL.md
```

### 重要行为

- **SOUL.md 是 Agent 的主要身份标识。** 它占据系统提示词的第 1 个槽位，替代硬编码的默认身份。
- 如果 `SOUL.md` 尚不存在，Hermes 会自动创建一个初始文件
- 已有的用户 `SOUL.md` 文件不会被覆盖
- Hermes 仅从 `HERMES_HOME` 加载 `SOUL.md`
- Hermes 不会在当前工作目录中查找 `SOUL.md`
- 如果 `SOUL.md` 存在但为空，或无法加载，Hermes 将回退到内置的默认身份
- 如果 `SOUL.md` 有内容，该内容在经过安全扫描和截断处理后将原样注入
- SOUL.md **不会**在上下文文件部分重复出现——它仅作为身份标识出现一次

这使 `SOUL.md` 成为真正的每用户或每实例身份标识，而不仅仅是一个附加层。

## 此设计的原因

这样可以保持个性的可预测性。

如果 Hermes 从你启动它的任意目录加载 `SOUL.md`，你的个性可能会在不同项目之间意外改变。通过仅从 `HERMES_HOME` 加载，个性归属于 Hermes 实例本身。

这也让用户更容易理解：
- "编辑 `~/.hermes/SOUL.md` 来更改 Hermes 的默认个性。"

## 编辑位置

对于大多数用户：

```bash
~/.hermes/SOUL.md
```

如果你使用自定义主目录：

```bash
$HERMES_HOME/SOUL.md
```

## SOUL.md 应该写什么？

用于持久的语气和个性指导，例如：
- 语气
- 沟通风格
- 直接程度
- 默认交互风格
- 风格上应避免的内容
- Hermes 应如何处理不确定性、分歧或模糊情况

不适合写入的内容：
- 一次性项目说明
- 文件路径
- 代码库规范
- 临时工作流细节

这些内容属于 `AGENTS.md`，而不是 `SOUL.md`。

## 优质 SOUL.md 内容

一个好的 SOUL 文件应该：
- 在不同上下文中保持稳定
- 足够宽泛，适用于多种对话场景
- 足够具体，能实质性地塑造语气
- 专注于沟通和身份，而非特定任务的指令

### 示例

```markdown
# Personality

You are a pragmatic senior engineer with strong taste.
You optimize for truth, clarity, and usefulness over politeness theater.

## Style
- Be direct without being cold
- Prefer substance over filler
- Push back when something is a bad idea
- Admit uncertainty plainly
- Keep explanations compact unless depth is useful

## What to avoid
- Sycophancy
- Hype language
- Repeating the user's framing if it's wrong
- Overexplaining obvious things

## Technical posture
- Prefer simple systems over clever systems
- Care about operational reality, not idealized architecture
- Treat edge cases as part of the design, not cleanup
```

## Hermes 注入提示词的内容

`SOUL.md` 的内容直接进入系统提示词的第 1 个槽位——即 Agent 身份位置。不会在其周围添加任何包装语言。

内容会经过以下处理：
- 提示词注入扫描
- 内容过大时进行截断

如果文件为空、仅含空白字符或无法读取，Hermes 将回退到内置默认身份（"You are Hermes Agent, built by Nous Research. Be direct: match the length of your reply to the weight of the ask..."）。当 `skip_context_files` 被设置时（例如在子 Agent/委托上下文中），同样适用此回退。

## 安全扫描

`SOUL.md` 与其他携带上下文的文件一样，在被包含前会进行提示词注入模式扫描。

这意味着你仍应将其专注于角色/语气，而不是试图混入奇怪的元指令。

## SOUL.md 与 AGENTS.md

这是最重要的区别。

### SOUL.md
用于：
- 身份
- 语气
- 风格
- 沟通默认值
- 个性层面的行为

### AGENTS.md
用于：
- 项目架构
- 编码规范
- 工具偏好
- 代码库特定工作流
- 命令、端口、路径、部署说明

一个实用的判断规则：
- 如果它应该随你到处适用，属于 `SOUL.md`
- 如果它属于某个项目，属于 `AGENTS.md`

## SOUL.md 与 `/personality`

`SOUL.md` 是你的持久默认个性。

`/personality` 是会话级覆盖层，用于更改或补充当前系统提示词。

因此：
- `SOUL.md` = 基础语气
- `/personality` = 临时模式切换

示例：
- 保持务实的默认 SOUL，然后在辅导对话中使用 `/personality teacher`
- 保持简洁的 SOUL，然后在头脑风暴时使用 `/personality creative`

## 内置个性

Hermes 内置了多种个性，可通过 `/personality` 切换。

| 名称 | 描述 |
|------|-------------|
| **helpful** | 友好的通用助手 |
| **concise** | 简短、直击要点的回复 |
| **technical** | 详尽、准确的技术专家 |
| **creative** | 创新、突破常规的思维 |
| **teacher** | 耐心的教育者，配有清晰示例 |
| **kawaii** | 可爱表达、闪光效果与热情 ★ |
| **catgirl** | 带有猫咪表达方式的 Neko-chan，nya~ |
| **pirate** | 船长 Hermes，精通技术的海盗 |
| **shakespeare** | 充满戏剧张力的吟游诗人风格 |
| **surfer** | 超级冷静的冲浪者氛围 |
| **noir** | 硬派侦探叙事风格 |
| **uwu** | 极致可爱的 uwu 语气 |
| **philosopher** | 对每个问题深度沉思 |
| **hype** | 最大能量与热情！！！ |

## 使用命令切换个性

### CLI

```text
/personality
/personality concise
/personality technical
```

### 消息平台

```text
/personality teacher
```

这些是便捷的覆盖层，但你的全局 `SOUL.md` 仍然赋予 Hermes 持久的默认个性，除非覆盖层对其进行了实质性更改。

## 在配置中定义自定义个性

你也可以在 `~/.hermes/config.yaml` 的 `agent.personalities` 下定义命名的自定义个性。

```yaml
agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.
```

然后通过以下方式切换：

```text
/personality codereviewer
```

## 推荐工作流

一个强健的默认配置：

1. 在 `~/.hermes/SOUL.md` 中维护一个经过深思熟虑的全局 `SOUL.md`
2. 将项目说明放在 `AGENTS.md` 中
3. 仅在需要临时模式切换时使用 `/personality`

这样你将获得：
- 稳定的语气
- 项目特定行为归属于正确位置
- 需要时的临时控制

## 个性如何与完整提示词交互

从高层次来看，提示词栈包含：
1. **SOUL.md**（Agent 身份——如果 SOUL.md 不可用则使用内置回退）
2. 工具感知行为指导
3. 记忆/用户上下文
4. 技能指导
5. 上下文文件（`AGENTS.md`、`.cursorrules`）
6. 时间戳
7. 平台特定格式提示
8. 可选的系统提示词覆盖层，如 `/personality`

`SOUL.md` 是基础——其他所有内容都建立在它之上。

## 相关文档

- [上下文文件](/user-guide/features/context-files)
- [配置](/user-guide/configuration)
- [技巧与最佳实践](/guides/tips)
- [SOUL.md 指南](/guides/use-soul-with-hermes)

## CLI 外观与对话个性

对话个性与 CLI 外观是相互独立的：

- `SOUL.md`、`agent.system_prompt` 和 `/personality` 影响 Hermes 的说话方式
- `display.skin` 和 `/skin` 影响 Hermes 在终端中的显示外观

关于终端外观，请参阅 [皮肤与主题](./skins.md)。