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
Posts

Hermes-lite 裁剪指南：在 1GB VPS 上跑轻量 AI Agent

为什么要裁剪

完整版 Hermes Agent（Nous Research）功能丰富：多平台网关、浏览器自动化、语音 TTS/STT、多 Agent 协作、Kanban 看板等。但这些功能对资源要求不低——在我的测试里，完整配置更适合至少 2GB 内存的机器。

我有一台 GCP e2-micro（2 vCPU / 954MB RAM），想用它跑一个 24/7 在线的 AI Agent 接入飞书。完整版装不下，于是有了这个裁剪实践。

三阶段渐进式裁剪

裁剪不是一步完成的，而是三阶段递进：

第一阶段：本地 Codex 完成初期核心裁剪

在本地电脑上，利用 Codex（OpenAI） 作为辅助分析工具，对完整版 Hermes 进行全面"解剖"：

  • 逐一扫描 ~/.hermes/ 目录结构，识别每个模块的职责
  • 分析 67 个技能的依赖关系，标记哪些是核心链路的、哪些是边缘功能
  • 梳理 config.yaml 中每个配置项的实际作用，搞清楚"关掉会怎样"
  • 输出一份裁剪清单：哪些 toolset 可以禁、哪些 skill 可以删、哪些配置可以收紧

这一阶段的核心价值：把"能不能关"这个判断做对。Codex 帮助理解了代码间的依赖关系，避免直接关某个功能导致连锁崩溃。

第二阶段：大 VPS 上跑完整版 + 压测验证

在一台大内存 VPS 上安装完整版 Hermes，作为"对照基准"：

  • 记录完整版的实际内存占用（idle / 高负载两种状态）
  • 逐个关闭非核心功能，观察内存变化和稳定性
  • 跑压测：模拟长时间运行、多轮对话、工具调用密集场景
  • 确认裁剪后系统在资源充足环境下依然稳定

这一阶段的目的：建立性能基线 + 验证裁剪组合的安全性。在大 VPS 上翻车无所谓，在小 VPS 上翻车就是服务宕机。

read more