安全过滤器把注释也当命令了：Hermes 终端误杀 setsid / nohup 的坑安全过滤器把注释也当命令了：Hermes 终端误杀 setsid / nohup 的坑
Hermes terminal safety filter 曾用简单正则扫描 nohup/disown/setsid，导致 git commit message、PR body、Python -c 代码和 echo 文本里的关键词也被当作真实后台命令拦截。本文复盘 #20064：为什么安全过滤不能只靠关键词扫描。
分类： Hermes 终端、Docker 与安装
Hermes CLI、Terminal tool、Docker、安装升级、环境变量与本地运行问题。
9000 轮配置，为什么跑着跑着又变成 90？Hermes Gateway 被旧 .env 反杀的配置优先级坑9000 轮配置，为什么跑着跑着又变成 90？Hermes Gateway 被旧 .env 反杀的配置优先级坑
Hermes Gateway 中 agent.max_turns 写成 9000，却在长任务心跳里显示 iteration X/90。本文复盘 #19158：为什么旧 .env 里的 HERMES_MAX_ITERATIONS=90 会通过 dotenv reload 覆盖 config.yaml，以及如何排查配置优先级。
你以为传进 Docker 的变量，其实从没上车：Hermes docker_env 配置为何失效你以为传进 Docker 的变量，其实从没上车：Hermes docker_env 配置为何失效
Hermes 的 terminal.docker_env 写在 config.yaml 里却没有进入 Docker 容器，根因是 env_mappings 缺少 docker_env 到 TERMINAL_DOCKER_ENV 的映射。本文复盘 #20537：为什么配置看似存在，运行时却只拿到默认空 dict。
Matrix/Telegram 突然报 cannot import cfg_get？Hermes Gateway 升级后旧代码未重启排查Matrix/Telegram 突然报 cannot import cfg_get？Hermes Gateway 升级后旧代码未重启排查
Hermes 升级后 Matrix、Telegram、飞书突然报 cannot import name cfg_get？这通常不是平台配置或模型 API 问题，而是 Gateway 仍在运行旧代码/旧 import 状态。本文解释为什么 /reset 无效、gateway restart 有效，以及多 profile/system service 排查方法。
Hermes 更新卡在 python-olm？macOS 上 CMake 4 与 Apple Clang 编译失败排查Hermes 更新卡在 python-olm？macOS 上 CMake 4 与 Apple Clang 编译失败排查
Hermes update 在 macOS 上卡在 python-olm==3.2.16？本文解释 CMake 4 policy、Apple Clang 21、vendored libolm、matrix-nio[e2e] 与可选依赖拆分的排查和绕过方法。
Hermes 输入 @ 就报 NameError: self is not defined？fuzzy file completions 排错指南Hermes 输入 @ 就报 NameError: self is not defined？fuzzy file completions 排错指南
Hermes CLI 输入 @ 触发文件补全时抛出 NameError: self is not defined？本文解释 _context_completions、@staticmethod、fuzzy file completions 的根因、临时绕过和升级修复路径。
Hermes Docker 里读不到 GITHUB_TOKEN？~/.hermes/.env 环境变量转发排错指南Hermes Docker 里读不到 GITHUB_TOKEN？~/.hermes/.env 环境变量转发排错指南
Hermes config set GITHUB_TOKEN 后，Docker terminal 里仍读不到环境变量？这可能是 Docker exec 只转发当前 shell env，却没加载 ~/.hermes/.env。本文解释 GITHUB_TOKEN、docker_forward_env、~/.gitconfig 挂载和容器内 printenv 排查方法。
Hermes Agent 启动报 Invalid key: c-S-c？prompt_toolkit 快捷键崩溃排错指南Hermes Agent 启动报 Invalid key: c-S-c？prompt_toolkit 快捷键崩溃排错指南
Hermes Agent 运行 hermes 或 hermes chat 刚显示 banner 就崩溃，报 Error: Invalid key: c-S-c？这通常不是 API Key 或模型问题，而是 prompt_toolkit 不支持 Ctrl+Shift+C 的 c-S-c keybinding。本文解释原因、判断方法、临时 workaround 和升级建议。
Hermes Agent 报 No module named agent.transports？pip / Nix 源码安装缺包排错指南Hermes Agent 报 No module named agent.transports？pip / Nix 源码安装缺包排错指南
Hermes Agent 源码安装后报 ModuleNotFoundError: No module named agent.transports？这通常不是 Anthropic API Key 或模型名问题，而是 setuptools include 缺少 agent.*，导致 pip / Nix 安装产物漏掉 agent/transports 子包。
Hermes Agent 报 UnicodeEncodeError？ASCII locale、API Key 和 reasoning_content 排错指南Hermes Agent 报 UnicodeEncodeError？ASCII locale、API Key 和 reasoning_content 排错指南
Hermes Agent 报 UnicodeEncodeError: ascii codec can't encode character？本文从 LANG=C、API Key 混入 Unicode 近似字符、OpenAI SDK Authorization header、tool schema、api_messages 和 reasoning_content 角度给出完整排错清单。
Hermes Issue #464：Ghostty / tmux 输入框边框闪烁不是终端坏了，而是 TUI 重绘冲突Hermes Issue #464：Ghostty / tmux 输入框边框闪烁不是终端坏了，而是 TUI 重绘冲突
Hermes Agent 热门已关闭 Issue #464 复盘：Ghostty、tmux、Warp 或 Docker Terminal 中输入框边框闪烁，根因并非模型 API，而是 thinking spinner 通过 raw stdout / \r 与 prompt_toolkit 渲染冲突。附 HERMES_SPINNER_PAUSE=1 hermes 排查方法。
Hermes Agent 跨平台排错：Windows 代理 502、Docker 后端残留和飞书表格源码显示Hermes Agent 跨平台排错：Windows 代理 502、Docker 后端残留和飞书表格源码显示
基于 Hermes GitHub Issues，总结 Windows 系统代理导致 auxiliary client 502、terminal.backend=local 仍跑 Docker、飞书 Markdown 表格显示源码等跨平台问题，帮助区分 DeepAI 模型层和 Hermes 运行环境层。