Posts

Hermes-lite 裁剪实战：7 类典型坑与解法

上一篇文章介绍了 Hermes-lite 的整体裁剪思路。这篇深入每一类实际踩过的坑， 把"为什么会遇到"和"怎么解"都说清楚。

一、路径迁移坑

从 .hermes/ 迁到 .hermes-lite/ 后，不是只改 HERMES_HOME 就完事。

踩到的点

  • .skills_prompt_snapshot.json 里残留旧 .hermes/ 路径
  • web_search/SKILL.md 硬编码了旧路径
  • 技能、工具、memory、config、sessions、workspace 各自缓存旧路径
  • systemd 环境变量、进程环境、配置文件、技能正文需要一起排查

经验

  1. 迁移后 grep 全目录旧路径：
grep -r "\.hermes/" /home/user/.hermes-lite/ --include="*.json" --include="*.md" --include="*.yaml" -l
  1. 技能快照要清理重建，不能复用旧缓存
  2. systemd 重启不是可选项 — 长进程内缓存会保留旧状态
systemctl restart hermes-lite
systemctl status hermes-lite  # 确认新 PID

二、技能裁剪坑

一开始容易只看磁盘上有多少 SKILL.md，但真正可用数量要看运行时过滤后的结果。

踩到的点

  • 磁盘上 67 个 SKILL.md，实际 gateway/slash 可见 65 个
  • kanban-orchestrator/worker 因为 environments: [kanban] 被过滤，这是预期不是坏了
  • _find_all_skills(skip_disabled=True) 这个参数名容易误读，实际是返回全部技能，默认才过滤 disabled
  • web_search 技能存在，但 Tavily key 缺失，会变成"看得到但用不了"

经验

判断技能可用性要看三层：

read more