分类: Hermes Agent 教程

Hermes Agent 接入 DeepAI、OpenAI Compatible API、自定义模型端点、部署和排错教程。

delegate_task 为什么会偏向 Claude?从工具 schema priming 看 Hermes 子代理路由误导delegate_task 为什么会偏向 Claude?从工具 schema priming 看 Hermes 子代理路由误导

Hermes Agent 在未安装 Claude Code / Claude Desktop 的环境里,为什么偶发尝试走 Claude ACP?本文客观复盘 #22013:delegate_task 的 acp_command / acp_args 工具 schema 如何通过 claude、Claude Code、--acp --stdio 示例影响模型决策,以及为什么禁用 skill 不等于移除 core tool schema priming。

DeepSeek Anthropic-compatible API 第二轮 HTTP 400:为什么 thinking blocks 不能被一刀切剥掉?DeepSeek Anthropic-compatible API 第二轮 HTTP 400:为什么 thinking blocks 不能被一刀切剥掉?

Hermes 使用 DeepSeek Anthropic-compatible Messages API 且启用 reasoning_effort 时,多轮会话第二轮可能报 HTTP 400:content[].thinking must be passed back。本文客观复盘 #22313:convert_messages_to_anthropic 如何剥掉 thinking blocks,为什么 DeepSeek/Kimi 需要保留 unsigned thinking,以及 provider-aware adapter 的修复方向。

/reload-mcp 一按就卡死:Hermes CLI 为什么会在确认框里等不到回车?/reload-mcp 一按就卡死:Hermes CLI 为什么会在确认框里等不到回车?

Hermes CLI 执行 /reload-mcp 后确认框显示出来,却无法输入 1/2/3,SSH 会话像被冻住。本文客观复盘 #23853:prompt_toolkit raw mode、daemon thread 中的 input() fallback、 / 行结束符错位、TUI slash worker pipe 死锁,以及 prompt_toolkit-native modal 的修复方向。

Kimi-k2.6 明明是 256K,Hermes 为什么按 32K 拒绝启动?Kimi-k2.6 明明是 256K,Hermes 为什么按 32K 拒绝启动?

Hermes Agent 接入 Ollama Cloud 的 kimi-k2.6 时,API 已报告 262,144 tokens,但启动校验仍按 32,768 tokens 拒绝模型,提示低于 64K 最低上下文。本文客观复盘 #23949:context length resolution chain、远程 Ollama provider 检测、models.dev 命名格式和 model.context_length override。

Hermes terminal 误拦截 setsid:安全过滤为什么不能只靠全文正则Hermes terminal 误拦截 setsid:安全过滤为什么不能只靠全文正则

Hermes terminal tool 为了拦截 nohup、disown、setsid 这类 shell-level background wrapper 使用了全文关键词正则,结果连引号、commit message、PR body、echo 和 Python 字符串里的 setsid 也被误拦。本文客观复盘 #20064:安全过滤应识别 shell 命令位置,而不是只匹配任意文本。

Hermes 安装卡在 [sudo] password:非 sudo 用户遇到 Playwright –with-deps 的半安装问题Hermes 安装卡在 [sudo] password:非 sudo 用户遇到 Playwright –with-deps 的半安装问题

在 Debian 上用非 sudo 服务用户安装 Hermes 时,安装器可能卡在 Playwright Chromium 的 `npx playwright install --with-deps chromium` sudo 密码提示,且发生在 setup_path 之前,导致没有 hermes 命令和 hermes doctor。本文客观复盘 #25816 的触发条件、安装顺序和降级处理。

Gemini 刚开始 thinking,Hermes streaming 就炸了:.content 字段缺席引发的 AttributeErrorGemini 刚开始 thinking,Hermes streaming 就炸了:.content 字段缺席引发的 AttributeError

Hermes 接 Gemini Code Assist streaming 时,reasoning-only delta 还没有正文 content,下游却访问 delta.content,导致 SimpleNamespace 抛 AttributeError。本文复盘 #24974:streaming adapter 应该始终保持 OpenAI-style delta schema 稳定,content 可以是 None,但字段不能缺席。

Hermes 只剩 MCP 工具,terminal 全没了:一次 disabled_toolsets 连环误伤Hermes 只剩 MCP 工具,terminal 全没了:一次 disabled_toolsets 连环误伤

Hermes v0.13.0 里 terminal、write_file、memory 等 native tools 全部消失,只剩 MCP tools?本文复盘 #22573:`hermes-yuanbao` 被写进 agent.disabled_toolsets 后,平台 composite toolset 展开为 _HERMES_CORE_TOOLS,并把所有 native tools 从 session schemas 里扣掉。

日志里写着 systemd,机器却是 macOS:Hermes shutdown forensics 被 launchd 带偏的细节日志里写着 systemd,机器却是 macOS:Hermes shutdown forensics 被 launchd 带偏的细节

macOS 上 Hermes Gateway 由 launchd 管理,但 shutdown forensics 却记录 under_systemd=yes?本文复盘 #25510:ppid==1 不能跨平台等同于 systemd,排障日志也要尊重 launchd、systemd、Scheduled Task 的平台语义。

Gateway 明明活着,Hermes 却说 stopped:Windows Scheduled Task 状态误判的排查Gateway 明明活着,Hermes 却说 stopped:Windows Scheduled Task 状态误判的排查

Windows 上 Hermes Gateway 通过 Scheduled Task 正在运行,Telegram 也在线,但 hermes gateway status 却显示 stopped 或 manual process?本文复盘 #25513:runtime snapshot 缺少 Windows 分支,PID 扫描又把真实 gateway run 进程漏掉。

Discord /btw 带图却像没看见:Hermes background agent 为什么拿不到图片附件Discord /btw 带图却像没看见:Hermes background agent 为什么拿不到图片附件

Hermes Discord 里 /btw 或 /background 带图片时,adapter 已经缓存附件,后台 Agent 却只收到文字 prompt?本文复盘 #25614:background command 路径没有转发 event.media_urls / media_types,导致图片上下文在进入 Agent 前丢失。

Agent 排障时一条 pkill 把自己杀了:Hermes Gateway 自终止为什么需要危险命令拦截Agent 排障时一条 pkill 把自己杀了:Hermes Gateway 自终止为什么需要危险命令拦截

Hermes Gateway Agent 误判自己没运行后执行 pkill -f "cli.py --gateway",结果把承载自己的 Gateway 进程杀掉。本文复盘 #3397:为什么 kill/pkill/killall 命中 hermes/gateway/cli.py 必须进入审批流。