分类: Hermes Agent 教程

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

Hermes Issue #1083:OpenRouter / Nvidia / MiniMax 报 400 BadRequest,别只怪 API KeyHermes Issue #1083:OpenRouter / Nvidia / MiniMax 报 400 BadRequest,别只怪 API Key

Hermes Agent 热门已关闭 Issue #1083 复盘:OpenRouter、Nvidia、MiniMax 报 400 BadRequest,根因可能是 Hermes 把 reasoning extra_body 发给不支持的模型,也可能是 .env 中 API key 损坏。附 request dump 排查方法与 DeepAI/OpenAI-compatible 分层诊断思路。

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 热门 Issue #7237:Response truncated due to output length limit 怎么排查?Hermes 热门 Issue #7237:Response truncated due to output length limit 怎么排查?

Hermes 热门已关闭 Issue #7237 复盘:Response truncated due to output length limit、finish_reason=length、Truncated tool call 到底是 Hermes bug、模型输出限制,还是上下文太满?

Hermes 热门 Issue #6475:Claude 订阅登录为什么还会提示 out of extra usage?Hermes 热门 Issue #6475:Claude 订阅登录为什么还会提示 out of extra usage?

Hermes 热门已关闭 issue #6475 复盘:Claude Desktop 能用,但 Hermes 通过 Anthropic subscription auth 报 HTTP 400 out of extra usage。为什么重启、重登、切换模型无效?如何改用更稳定的 API / OpenAI-compatible 路径?

Hermes 多模态排错:image_url 发给非视觉模型为什么会 400?Hermes 多模态排错:image_url 发给非视觉模型为什么会 400?

Hermes 接入 OpenAI-compatible API 时,图片消息会变成 image_url content part。如果当前模型不是 vision model,就可能返回 HTTP 400。本文基于 Hermes PR #23750 讲清 non-vision model、多模态和 DeepAI 接入排错。

Hermes Auxiliary 任务排错:主聊天正常,为什么标题生成、压缩和后台 review 会失败?Hermes Auxiliary 任务排错:主聊天正常,为什么标题生成、压缩和后台 review 会失败?

Hermes 主聊天正常,不代表 title generation、context compression、session search、background review 都正常。本文基于 GitHub Issues 解析 auxiliary client 502、aux provider routing、compression context length 和后台 review 输出泄漏。

Hermes Provider 兼容性排错:reasoning_content、custom headers、上下文长度和 api_mode 继承Hermes Provider 兼容性排错:reasoning_content、custom headers、上下文长度和 api_mode 继承

OpenAI-compatible 不等于 provider 细节完全一致。本文基于 Hermes Issues 解析 reasoning_content 400、Custom Provider headers 403、上下文长度误判、delegate api_mode 继承等兼容性问题,并说明 DeepAI 接 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 运行环境层。

Hermes Agent Issue 观察:Discord 重复回复、Cloudflare 403 和长任务心跳为什么容易误判Hermes Agent Issue 观察:Discord 重复回复、Cloudflare 403 和长任务心跳为什么容易误判

从 Hermes Agent GitHub Issues 看三类高频误判:Discord 重复回复、Custom Provider Cloudflare 403、长任务 heartbeat 异常。本文按链路分层排错,帮助判断问题在平台、Gateway、Agent 还是上游模型。

Hermes 的 Custom Endpoint 和 API Server 不是一回事:接 DeepAI 前先别搞反Hermes 的 Custom Endpoint 和 API Server 不是一回事:接 DeepAI 前先别搞反

Hermes 里有两个 OpenAI-compatible:Custom Endpoint 用来接 DeepAI 这样的上游模型,API Server 用来让 Open WebUI、LobeChat 等前端连接 Hermes。本文讲清 Base URL、API Key 和链路区别。

Hermes Agent 常见问题排查:从 GitHub Issues 看 403、502、Docker 后端和自定义接口坑Hermes Agent 常见问题排查:从 GitHub Issues 看 403、502、Docker 后端和自定义接口坑

翻看 Hermes Agent GitHub Issues 后整理的排错复盘:Custom Endpoint 403、后台 review agent、Windows localhost 502、terminal.backend 残留 Docker 配置、Feishu 表格渲染等问题。