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，以及如何排查配置优先级。
Hermes 的 terminal.docker_env 写在 config.yaml 里却没有进入 Docker 容器，根因是 env_mappings 缺少 docker_env 到 TERMINAL_DOCKER_ENV 的映射。本文复盘 #20537：为什么配置看似存在，运行时却只拿到默认空 dict。
Hermes delegate_task 在工具 schema 中把 claude 和 Claude Code 写成显眼示例，可能诱导 Agent 在未安装 Claude 的环境里尝试 Claude ACP。本文复盘 #22013：为什么工具说明本身也是 prompt surface，以及如何用环境检测和 schema gating 降低误调用。
Hermes Honcho memory tools 在单工具调用时返回 Unknown tool，但多工具并发路径有时正常。本文复盘 #15118：schema 已注入不代表执行层会路由成功，sequential dispatch 漏掉 MemoryManager.has_tool() 才是真正根因。