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 接入排错。
月度归档： 2026 年 5 月
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 表格渲染等问题。
Hermes Agent 接入 DeepAI 教程：用 Custom Endpoint 配 OpenAI Compatible APIHermes Agent 接入 DeepAI 教程：用 Custom Endpoint 配 OpenAI Compatible API
Hermes Agent 如何接入 DeepAI API 中转站？本文根据 NousResearch/hermes-agent GitHub 与官方文档，讲清 Custom Endpoint、Base URL、API Key、模型 ID 与验证方法。
Cherry Studio 配置 DeepAI API 后模型不显示？先查这 8 个地方Cherry Studio 配置 DeepAI API 后模型不显示？先查这 8 个地方
Cherry Studio 配置 DeepAI API 后模型不显示、API Key 检查失败、Base URL 报错怎么办？本文排查模型添加、服务商开关、DeepAI Base URL、Model ID、多 Key 轮询和常见错误。