https://caozuohua.github.io/categories/%E6%8A%80%E6%9C%AF%E5%A4%8D%E7%9B%98/Recent content in 技术复盘 on CAO ZUOHUAHugozh-cnThu, 25 Jun 2026 00:00:00 +0000https://caozuohua.github.io/posts/2026-06-25-hermes-lite-pitfalls-deep-dive/Thu, 25 Jun 2026 00:00:00 +0000https://caozuohua.github.io/posts/2026-06-25-hermes-lite-pitfalls-deep-dive/<p>上一篇文章介绍了 Hermes-lite 的整体裁剪思路。这篇深入每一类实际踩过的坑， 把&quot;为什么会遇到&quot;和&quot;怎么解&quot;都说清楚。</p> <hr> <h2 id="一路径迁移坑">一、路径迁移坑</h2> <p>从 <code>.hermes/</code> 迁到 <code>.hermes-lite/</code> 后，不是只改 <code>HERMES_HOME</code> 就完事。</p> <h3 id="踩到的点">踩到的点</h3> <ul> <li><code>.skills_prompt_snapshot.json</code> 里残留旧 <code>.hermes/</code> 路径</li> <li><code>web_search/SKILL.md</code> 硬编码了旧路径</li> <li>技能、工具、memory、config、sessions、workspace 各自缓存旧路径</li> <li>systemd 环境变量、进程环境、配置文件、技能正文需要一起排查</li> </ul> <h3 id="经验">经验</h3> <ol> <li>迁移后 <code>grep</code> 全目录旧路径：</li> </ol> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>grep -r <span style="color:#e6db74">&#34;\.hermes/&#34;</span> /home/user/.hermes-lite/ --include<span style="color:#f92672">=</span><span style="color:#e6db74">&#34;*.json&#34;</span> --include<span style="color:#f92672">=</span><span style="color:#e6db74">&#34;*.md&#34;</span> --include<span style="color:#f92672">=</span><span style="color:#e6db74">&#34;*.yaml&#34;</span> -l </span></span></code></pre></div><ol start="2"> <li>技能快照要清理重建，不能复用旧缓存</li> <li>systemd 重启不是可选项 — 长进程内缓存会保留旧状态</li> </ol> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>systemctl restart hermes-lite </span></span><span style="display:flex;"><span>systemctl status hermes-lite <span style="color:#75715e"># 确认新 PID</span> </span></span></code></pre></div><hr> <h2 id="二技能裁剪坑">二、技能裁剪坑</h2> <p>一开始容易只看磁盘上有多少 <code>SKILL.md</code>，但真正可用数量要看运行时过滤后的结果。</p> <h3 id="踩到的点-1">踩到的点</h3> <ul> <li>磁盘上 67 个 <code>SKILL.md</code>，实际 gateway/slash 可见 65 个</li> <li><code>kanban-orchestrator/worker</code> 因为 <code>environments: [kanban]</code> 被过滤，这是预期不是坏了</li> <li><code>_find_all_skills(skip_disabled=True)</code> 这个参数名容易误读，实际是返回全部技能，默认才过滤 disabled</li> <li><code>web_search</code> 技能存在，但 Tavily key 缺失，会变成&quot;看得到但用不了&quot;</li> </ul> <h3 id="经验-1">经验</h3> <p>判断技能可用性要看三层：</p>