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 provider:auto 选错辅助模型?title_generation 走 fallback provider 报 404 排错指南Hermes Agent provider:auto 选错辅助模型?title_generation 走 fallback provider 报 404 排错指南

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 报 HTTP 404?anthropic_messages、base_url 与 /v1 路径改写排错指南Hermes Agent auxiliary 报 HTTP 404?anthropic_messages、base_url 与 /v1 路径改写排错指南

Hermes Agent auxiliary title_generation 报 HTTP 404、Cannot POST /v1/chat/completions?如果你配置的是 api_mode: anthropic_messages 和 /anthropic/ endpoint,可能是 custom auxiliary client 把 URL 改写成 OpenAI /v1 路径。本文解释根因、修复 commit 4e296dcdd 和排查方法。

Hermes Agent 辅助任务报 401?provider:auto、base_url 与空 api_key 排错指南Hermes Agent 辅助任务报 401?provider:auto、base_url 与空 api_key 排错指南

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 description 60 字截断与路由排错指南Hermes Agent 技能不触发?skill description 60 字截断与路由排错指南

Hermes Agent 自定义 Skill 明明存在却不触发?可能是系统提示词里的 available_skills 只展示 description 前 60 字,关键触发词被截断。本文解释 .skills_prompt_snapshot.json、skills_list 1024 字差异和 60 字内 description 写法。

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 角度给出完整排错清单。

Ollama 本地模型记不住上一轮?Hermes Agent num_ctx 与 2048 上下文截断排错指南Ollama 本地模型记不住上一轮?Hermes Agent num_ctx 与 2048 上下文截断排错指南

Hermes Agent 接入 Ollama 后同一会话记不住上一轮?这可能不是 memory tool 坏了,而是 Ollama num_ctx 回落到 2048 导致历史被服务端静默截断。本文解释 context_length、ollama_num_ctx、/api/show 探测失败和 PR #19613 的修复方向。

Gemini 报 missing thought_signature?Hermes Agent 工具调用历史丢签名的排错指南Gemini 报 missing thought_signature?Hermes Agent 工具调用历史丢签名的排错指南

Hermes Agent 使用 Gemini 3 / preview 模型时报 Function call is missing a thought_signature?这通常不是 API Key 或网络问题,而是 tool call 历史消息丢失 extra_content / thought_signature。本文整理升级、复现和源码排查清单。

DeepSeek thinking mode 报 reasoning_content 必须回传?Hermes Agent 工具调用与 fallback 排错指南DeepSeek thinking mode 报 reasoning_content 必须回传?Hermes Agent 工具调用与 fallback 排错指南

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 和排查清单。