Hermes CLI 输入 @ 触发文件补全时抛出 NameError: self is not defined？本文解释 _context_completions、@staticmethod、fuzzy file completions 的根因、临时绕过和升级修复路径。
Hermes config set GITHUB_TOKEN 后，Docker terminal 里仍读不到环境变量？这可能是 Docker exec 只转发当前 shell env，却没加载 ~/.hermes/.env。本文解释 GITHUB_TOKEN、docker_forward_env、~/.gitconfig 挂载和容器内 printenv 排查方法。
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 主模型正常，但 title_generation 报 HTTP 404？可能是 auxiliary provider:auto 没跟随主 provider，而是选到 fallback provider（如 minimax），导致 SDK、api_mode 或 endpoint path 不匹配。本文解释 provider:auto、fallback_model、WeChat 错误泄露和显式配置 workaround。
Hermes Agent 主模型能用，但 auxiliary title_generation 报 401 Missing Authentication header？可能是 provider:auto/openrouter 搭配 base_url 和空 api_key 被误判成 custom provider，跳过 OPENROUTER_API_KEY 环境变量读取。本文给出配置排查、workaround 和修复方向。
Hermes Agent 自定义 Skill 明明存在却不触发？可能是系统提示词里的 available_skills 只展示 description 前 60 字，关键触发词被截断。本文解释 .skills_prompt_snapshot.json、skills_list 1024 字差异和 60 字内 description 写法。
Hermes Agent 源码安装后报 ModuleNotFoundError: No module named agent.transports？这通常不是 Anthropic API Key 或模型名问题，而是 setuptools include 缺少 agent.*，导致 pip / Nix 安装产物漏掉 agent/transports 子包。
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 Agent 接入 Ollama 后同一会话记不住上一轮？这可能不是 memory tool 坏了，而是 Ollama num_ctx 回落到 2048 导致历史被服务端静默截断。本文解释 context_length、ollama_num_ctx、/api/show 探测失败和 PR #19613 的修复方向。
Hermes Agent 使用 Gemini 3 / preview 模型时报 Function call is missing a thought_signature？这通常不是 API Key 或网络问题，而是 tool call 历史消息丢失 extra_content / thought_signature。本文整理升级、复现和源码排查清单。
Hermes Agent 接入 DeepSeek thinking 模型时报 reasoning_content 或 content[].thinking must be passed back？这通常不是 API Key 错，而是历史 assistant message 在工具调用、fallback、cron 或 replay 时丢失 thinking 字段。本文整理 DeepSeek provider detection、reasoning_content echo 和排查清单。