Hermes 安装器在非 sudo 服务用户下运行 Playwright Chromium --with-deps 时会卡在 sudo 密码提示，且发生在 setup_path 之前，导致 hermes 命令和 hermes doctor 都没创建。本文复盘 #25816：为什么可选浏览器步骤不应阻断核心安装。
Hermes terminal safety filter 曾用简单正则扫描 nohup/disown/setsid，导致 git commit message、PR body、Python -c 代码和 echo 文本里的关键词也被当作真实后台命令拦截。本文复盘 #20064：为什么安全过滤不能只靠关键词扫描。
Gemini Code Assist streaming 中 reasoning-only delta 先于正文到达，Hermes 旧版 _make_stream_chunk 没有补 content=None，导致 downstream 访问 delta.content 时报 AttributeError。本文复盘 #24974：为什么流式 chunk schema 必须稳定。
Hermes 在自定义 OpenAI-compatible endpoint 上只按 URL host 判断 max_tokens / max_completion_tokens，导致 gpt-4o、gpt-4.1、gpt-5、o-series 模型返回 unsupported_parameter 400。本文复盘 #13901，并说明 DeepAI API 中转站场景该如何排查。
Hermes Copilot /model 选择器只查 COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN，没 fallback 到 auth.json 里的 OAuth access_token，导致 claude-opus-4.7、gpt-5.5 等模型能直接输入使用，却不出现在菜单里。本文复盘 #16708。
Hermes 把 API key 放在 ~/.hermes/.env 里却仍报 No API key found？本文复盘 #15932：credential_pool._seed_from_env 只看 os.environ，auth 解析也没有 fallback 到 credential pool，导致 OpenAI-compatible provider 的认证链路断掉。
Hermes Gateway 中 agent.max_turns 写成 9000，却在长任务心跳里显示 iteration X/90。本文复盘 #19158：为什么旧 .env 里的 HERMES_MAX_ITERATIONS=90 会通过 dotenv reload 覆盖 config.yaml，以及如何排查配置优先级。