dsh-llm-error-classify
在终端中运行以下命令:
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 调用失败的后端或平台运维
- 对误报认证失败敏感、希望减少换错密钥的用户