ByteNoteByteNote
字

字节笔记本

2026年6月21日

hermes教程-SOUL.md 现在如何工作

#AI 前沿
API中转
¥120
每日科技简报 · 每天一篇,快速了解科技圈大事

如何理解 SOUL.md 当前的工作方式

Hermes Agent 的个性是完全可定制的。SOUL.md 是主要身份——它是系统提示中的第一项，定义了代理的身份。

  • SOUL.md — 一个持久的角色文件，位于 HERMES_HOME 中，作为代理的身份（系统提示中的第 1 位）
  • 内置或自定义的 /personality 预设——会话级别的系统提示覆盖

如果你想改变 Hermes 的身份——或者用完全不同的代理角色替换它——请编辑 SOUL.md。

SOUL.md 现在如何工作

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

~/.hermes/SOUL.md

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

$HERMES_HOME/SOUL.md

重要行为

  • SOUL.md 是代理的主要身份。 它占据系统提示中的第 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
## 个性

你是一位务实的高级工程师，品味出众。
你追求真相、清晰和有用性，而非礼貌性的客套。

## 风格
- 直接但不冷漠
- 重实质轻空话
- 当某个想法不好时，要提出反对
- 坦率承认不确定性
- 除非深度有用，否则保持解释简洁

## 应避免
- 谄媚
- 夸张语言
- 如果用户的表述有误，不要重复
- 对显而易见的事情过度解释

## 技术姿态
- 偏好简单系统而非花哨系统
- 关注运营现实，而非理想化架构
- 将边界情况视为设计的一部分，而非事后清理

Hermes 向提示中注入什么

SOUL.md 的内容直接进入系统提示的第 1 位——代理身份位置。不会添加任何包装语言。

内容会经过：

  • 提示注入扫描
  • 如果太大则截断

如果文件为空、仅包含空白或无法读取，Hermes 会回退到内置的默认身份（“你是 Hermes Agent，一个由 Nous Research 创建的智能 AI 助手……”）。当设置了 skip_context_files 时（例如在子代理/委托上下文中），也会应用此回退。

安全扫描

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猫娘，带有猫系表情，nya~
pirate赫姆斯船长，精通技术的海盗
shakespeare带有戏剧性风格的吟游诗人散文
surfer完全放松的兄弟氛围
noir硬汉侦探叙述
uwu极致可爱，带有 uwu 语
philosopher对每个问题深入思考
hype最大能量和热情！！！

使用命令切换个性

CLI

text
/personality
/personality concise
/personality technical

消息平台

/personality teacher

这些是方便的覆盖，但你的全局 SOUL.md 仍然为 Hermes 提供持久的默认个性，除非覆盖有实质性的改变。

配置中的自定义个性

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

yaml
agent:
  personalities:
    codereviewer: >
      你是一位一丝不苟的代码审查员。识别错误、安全问题、
      性能问题和设计选择不清晰的地方。要精确且具有建设性。

然后通过以下命令切换：

/personality codereviewer

推荐的工作流程

一个强大的默认设置是：

  1. 在 ~/.hermes/SOUL.md 中维护一个经过深思的全局 SOUL.md
  2. 将项目指令放在 AGENTS.md 中
  3. 仅在你想要临时模式切换时使用 /personality

这样你会得到：

  • 稳定的语气
  • 项目特定的行为放在合适的位置
  • 需要时临时控制

个性如何与完整提示交互

从高层次看，提示堆栈包括：

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

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

相关文档

CLI 外观与对话个性

对话个性与 CLI 外观是分开的：

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

关于终端外观，请参见 皮肤与主题。

AI 前沿
上一篇

hermes教程-上下文引用

下一篇

hermes教程-SOUL.md 现在如何工作

分享: