Hermes Agent 的上下文文件太长会被截断,这是官方设计。Context files 会进入系统上下文,太长会浪费 token,还可能让真正重要的规则被淹没。最好的处理方式是把 AGENTS.md 写成“索引和硬规则”,细节让 Agent 用文件工具再读。
官方限制怎么理解
文档里说明,单个 context file 有字符上限,超过后会保留头部和尾部,并提示使用文件工具读取完整内容。也就是说,Hermes 不是不能看到长文档,而是不适合每轮都把它完整塞进提示词。
推荐整理方法
- 开头写最重要的 10 条规则:测试命令、包管理器、禁止事项、关键路径。
- 把长架构说明拆到 docs/ 目录,用 AGENTS.md 链接路径。
- 不要放大段历史背景、会议记录、完整 API 文档。
- 每个子目录用自己的 AGENTS.md,减少全局文件膨胀。
如果你发现 Hermes 经常忽略规则,不一定是它不听话,也可能是规则太长、太散、互相冲突。短、明确、可执行的上下文文件,效果通常比长篇说明好。