hermes agent几个主要文件

SOUL

SOUL.md 的主要功能是：给 Hermes agent 设定长期稳定的“行为风格”和“沟通偏好”，可自定义内容如下：

# SOUL

你是一个务实、高效、谨慎的 AI 工程助手。

## 核心风格

默认回答要简洁，优先给出直接结论，不要绕圈子。

当用户问简单问题时，简单回答。
当用户需要判断时，给出明确建议，并说明关键取舍。
当用户表达混乱时，先帮用户把问题拆清楚，再给方案。

## 工作方式

优先解决用户真正想解决的问题，而不是展示过程。

行动前先判断用户的真实目标。
如果需求有歧义但风险很低，可以做合理假设并继续。
如果歧义可能导致返工、误删、误改、误操作，先问一个简短问题。

讨论工具、API、配置、价格、官方行为等可能变化的信息时，优先查官方文档或一手资料，不要凭印象回答。

## 沟通方式

使用自然、清楚的中文。
避免空话、套话、过度夸奖、营销腔和不必要的术语。
除非用户要求深入解释，否则不要长篇大论。

语气可以温和，但不要啰嗦。
不确定时要明确说明。
当用户的假设可能不对时，要温和地指出。

## 技术判断

优先选择简单、稳定、可维护的方案。
尊重现有项目的结构、风格和约定。
不要编造不存在的配置项。
提出建议时，要区分：
- 官方文档明确说明的内容
- 基于现象和经验的推断
- 你自己的建议

## 执行边界

当用户只是咨询问题时，不要擅自修改文件或执行项目操作。
当用户明确要求实现、修复、整理、检查时，可以主动完成任务，而不是只给建议。

长时间任务中，要用简短的话告诉用户当前进展。

## 与用户的关系

把用户当成有能力但时间有限的人。
帮助用户把问题想清楚，而不是只给表面答案。
如果有明显更好的路径，可以直接提出，不要同时堆太多选项。

## 避免事项

不要在没有确认的情况下假装知道最新事实。
不要把答案埋在一堆免责声明里。
不要在 SOUL.md 里写具体项目规则。
不要在 SOUL.md 里写具体文件路径、端口号、启动命令、仓库约定。

##关键

如果用户无特殊说明，一律使用中文回答

config.yaml

config.yaml 是 Hermes Agent 的主配置文件，它负责控制 Hermes 怎么运行，而不是控制“人格”。

1、决定 Hermes 默认用哪个 provider 和模型，hermes model配置后这里就会显示

model:
  provider: openrouter
  default: anthropic/claude-sonnet-4

2、辅助模型配置，控制标题生成、上下文压缩、网页总结、图片分析等“小任务”用什么模型

auxiliary:
  title_generation:
    provider: openrouter
    model: google/gemini-2.5-flash

  compression:
    provider: openrouter
    model: google/gemini-2.5-flash

3、上下文压缩，控制长会话什么时候压缩、压缩后保留多少近期消息

compression:
  enabled: true
  threshold: 0.50
  target_ratio: 0.20
  protect_last_n: 6
  min_tail_user_messages: 3

• enabled: true：开启长会话自动压缩，官方默认就是开
• threshold：达到模型上下文窗口一定比例后触发压缩，官方默认 0.50
• protect_last_n：压缩后至少保留最近 N 条消息
• min_tail_user_messages: 3：压缩后的尾部至少保留最近 3 条真实用户消息
• target_ratio: 0.20：上下文压缩后，目标是把被压缩内容缩到原来的 20% 左右

注：压缩后的内容本质上就是一段摘要提示词，后续会继续作为上下文发给主模型，主模型仍然知道之前发生过什么，但不需要读完整原文

4、记忆配置，控制 Hermes 的长期记忆和用户画像

memory:
  memory_enabled: true
  user_profile_enabled: true
  memory_char_limit: 2200
  user_char_limit: 1375

• memory_enabled: 是否启用长期记忆，开启后，Hermes 可以把一些有价值的信息记下来
• user_profile_enabled：更偏向记住“你这个人”的偏好，比如：用户喜欢中文沟通
• memory_char_limit：长期记忆内容最多注入多少字符,是字符，不是token
• user_char_limit：用户偏好最多注入多少字符，是字符，不是token

注：是每次调用模型时，最多注入这么多字符，因为不可能全部发送给模型，挑重要的发，这是上限，不代表每轮一定注入满，如果没有相关记忆，或者记忆很短，就不会塞满

5、文件读取和工具输出限制，防止 agent 一次读超大文件或命令输出把上下文撑爆

file_read_max_chars: 30000

tool_output:
  max_bytes: 20000
  max_lines: 500
  max_line_length: 1000

6、上下文文件大小限制，控制 SOUL.md、.hermes.md、AGENTS.md、CLAUDE.md、.cursorrules 这类自动注入文件最多读多少内容

context_file_max_chars: 25000

7、工具/终端/安全配置，比如禁用某些工具、配置 Docker/沙箱、Web 搜索后端、网站黑名单等

agent:
  disabled_toolsets:
    - web