月度归档: 2026 年 5 月

Open WebUI 接入 DeepAI API 中转站教程:Connections、Base URL 和模型列表完整配置Open WebUI 接入 DeepAI API 中转站教程:Connections、Base URL 和模型列表完整配置

Open WebUI 如何接入 DeepAI API 中转站?本文讲清 Connections、Base URL、API Key、模型 ID、Model IDs Filter,以及 401、404、模型不显示、流式输出失败的排查方法。

Hermes doctor 不提示 OpenRouter 缺 Key?API 中转站 Provider 凭证排查Hermes doctor 不提示 OpenRouter 缺 Key?API 中转站 Provider 凭证排查

Hermes Agent 已关闭 issue #26428 复盘:active provider 设置为 OpenRouter 但缺少 API Key 时,runtime 报 No LLM provider configured,而 hermes doctor summary 不够明确。本文面向 DeepAI API 中转站用户讲清 Provider、Base URL、API Key 和 Model

Claude Code 自定义 ANTHROPIC_BASE_URL 崩溃?API 中转站兼容性排查Claude Code 自定义 ANTHROPIC_BASE_URL 崩溃?API 中转站兼容性排查

Claude Code 已关闭 issue #43663 复盘:自定义 ANTHROPIC_BASE_URL 指向兼容服务时,畸形 tool call 可能触发 Cannot read properties of undefined (reading command)。本文面向 DeepAI API 中转站用户讲清 Anthropic schema、tool call 和模型兼容性。

Hermes 接 Langfuse 为什么没日志?已解决的 placeholder key silent failure 排查Hermes 接 Langfuse 为什么没日志?已解决的 placeholder key silent failure 排查

Hermes Agent 已解决 Langfuse placeholder key 静默失败、trace 缺少 input/output、post_tool_call 不触发等观测问题。本文面向 DeepAI API 中转站用户,讲清可观测性、日志完整性和 hook 排查顺序。

Hermes Agent 接 DeepAI API 中转站后联网工具不稳定?从已解决 issue 看排查方法Hermes Agent 接 DeepAI API 中转站后联网工具不稳定?从已解决 issue 看排查方法

面向 DeepAI API 中转站用户的 Hermes Agent 排查教程:从已关闭 GitHub issue 看 web_tools 批量网页提取为什么会因单个任务失败丢掉整批结果,并区分模型、API 中转站和 Agent 工具层问题。

OpenAI-compatible API 报 unsupported_parameter:max_tokens 和 max_completion_tokens 为什么不能只看 Base URL?OpenAI-compatible API 报 unsupported_parameter:max_tokens 和 max_completion_tokens 为什么不能只看 Base URL?

自定义 OpenAI-compatible Base URL 调用 gpt-4o、gpt-4.1、gpt-5 或 o-series 模型时,为什么会报 Unsupported parameter: max_tokens?本文复盘 Hermes Agent #13901,解释 max_tokens / max_completion_tokens 不能只按 host 判断,而应按模型族和后端能力适配,并自然引导到 DeepAI API 中转站的统一接入场景。

Hermes zsh 补全报 _arguments: invalid argument:短选项和长选项不能这样写Hermes zsh 补全报 _arguments: invalid argument:短选项和长选项不能这样写

Hermes 的 hermes completion zsh 曾生成不合法的 Zsh _arguments 语法,例如 (-h --help){-h,--help},导致 _arguments:comparguments: invalid argument。本文客观复盘 #22686:为什么 exclusion group 不能混入长选项、如何改成 (-){-h,--help},以及如何用 zsh -n 做回归验证。

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。