DSH Plugins
返回列表
🧩

dsh-llm-error-classify

admin-security 更新于 2026.10.05

在终端中运行以下命令:

dsh plugin install lxl8182/dsh-llm-error-classify

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install lxl8182/dsh-llm-error-classify 安装本插件(源码:https://github.com/lxl8182/dsh-llm-error-classify),安装后重启 dsh web。

插件介绍

在 DeepSeek Harness 里,不少网关或渠道返回的 401/403 往往带着很具体的说明:分组下没有可用渠道、余额耗尽、令牌无权使用某模型、IP 未在白名单,乃至真正的密钥错误。但 pi-ai 适配器会优先把这类失败打成 AUTH,而 UI 对 AUTH 有专门处理,会清空正文并统一换成固定的 API 密钥无效文案。结果是你对着一条固定提示改密钥,问题却可能根本与密钥无关。

dsh-llm-error-classify 挂在 llm/stream 流水线上,在终态失败落盘与渲染之前介入:凡被标成 AUTH 的失败,改写为 PROVIDER_ERROR,并保留经清洗后的原始报错文本。PROVIDER_ERROR 不在 UI 的特判集合里,界面会直接显示 message 或 error 原文;它也不在默认可重试集合里,行为与原先的 AUTH 一致,不会凭空多出重试。因为不再依赖配额词表,各类网关措辞都能如实呈现。

放行原文前,插件会按形状抹掉可能泄漏的凭证片段,例如常见厂商前缀密钥、消息里的 Bearer 等,在可读性与安全之间做折中。清洗是形状匹配,无厂商前缀的裸密钥无法识别;若你的网关会回显此类内容,仍需谨慎。

适合经常对接多网关、多渠道的 DSH 管理员与自建部署者:当你已经确认密钥没问题,却总在 UI 里看到 API 密钥无效,或需要一眼看清提供方到底拒绝了什么时,这个插件能少踩误判、少换错密钥。它只做 AUTH 到 PROVIDER_ERROR 这一件事,不改其它错误码,也不改重试策略;宿主上游修好分类与展示逻辑后,可以卸载本插件。

使用场景

  • 网关报无可用渠道或配额问题,界面却统一显示 API 密钥无效
  • 需要直接看到提供方返回的 401/403 原文以便判断根因
  • 对接多家网关或渠道,错误文案各异且不想维护配额词表

适合人员

  • 自建 DSH 并配置多网关的管理员
  • 经常排查 LLM 调用失败的后端或平台运维
  • 对误报认证失败敏感、希望减少换错密钥的用户