给 DeepSeek Harness 加一个供应商诊断页：dsh-provider-probe

CuSn
0 阅读3分钟

在 DeepSeek Harness 里接入多个模型供应商后，最常见的问题通常不是“模型效果怎么样”，而是更基础的几件事：API Key 到底有没有生效、模型 ID 是否写对、接口地址能不能访问、当前账号有没有权限，以及流式返回是否兼容。

这些问题如果只靠聊天窗口排查，错误信息容易和会话、工具调用混在一起。为此我做了一个非官方社区插件：dsh-provider-probe。它在 DeepSeek Harness Web 的设置中增加一个独立的“供应商检测”页面，用一个很小的真实请求完成连通性检查，并把结果整理成可以直接处理的诊断信息。

dsh-provider-probe 供应商检测页面

它能做什么

  • 自动读取当前活动的供应商路由和模型目录；
  • 显示模型路由声明的文本、图片或未知输入能力；
  • 支持手动输入没有出现在目录中的模型 ID；
  • 展示首个 token 延迟、总耗时、结束原因和实际 token 用量；
  • 保留错误代码、HTTP 状态与 Request ID，并脱敏常见密钥、令牌和用户目录；
  • 区分凭据、权限、模型或接口地址、限流或额度、超时、网络、流式/SSE 兼容以及供应商 5xx；
  • 在失败结果下面直接给出中文或英文的下一步排查建议；
  • 一键复制适合提交到 Issue 或 Discussion 的脱敏诊断报告。

例如，DeepSeek 官方适配器在没有配置密钥时会返回 MISSING_CREDENTIAL。插件会把它识别为“凭据”问题，并提示先检查 API Key，而不是只留下一段难以判断的错误文本。

它是怎么工作的

插件直接使用 DSH 已注册的模型适配器发起流式请求，因此检查的是用户实际配置的那条调用链，不需要另外维护一套供应商 SDK。

为了控制费用和副作用，探测请求默认最多只允许 8 个输出 token，20 秒强制超时。只有用户点击“开始检测”后才会发送请求，不做后台轮询，也不会自动重试。同一时间只能运行一个检测，并且可以随时取消。

模型的回复内容会被丢弃。插件不会创建会话，不写入 session log，也不会读取或返回 API Key；凭据仍然由 DSH 的适配器和凭据服务按原有路径处理。

安装

要求 Node.js 22.19 或更高版本，以及 DeepSeek Harness 0.1.0-rc.6 或更高版本。

dsh plugin --profile web add https://github.com/Wanbinyu/dsh-provider-probe/releases/download/v0.3.0/dsh-provider-probe-0.3.0.tgz
dsh web

启动后打开“设置 -> 供应商检测”，选择供应商和模型，再点击“开始检测”。

卸载命令：

dsh plugin --profile web remove dsh-provider-probe

费用与隐私边界

每次检测都会经过供应商的真实接口，因此可能产生很少量的模型费用。输入能力只读取 DSH 当前模型路由的声明，不会额外上传图片或发送图片请求。

错误脱敏是一层防护，但不同供应商可能返回自定义格式。将诊断报告公开到 Issue、Discussion 或文章之前，仍建议人工检查一次。

dsh-provider-probe 是非官方社区项目，与 DeepSeek 官方无隶属或背书关系。项目采用 MIT 许可证，代码、中英文文档和安装包都已公开：

如果你正在给 DeepSeek Harness 配置新的供应商，或者遇到“明明填了配置但请求仍然失败”的情况，这个插件可以先把问题缩小到更具体的一层，再决定是改密钥、权限、模型 ID、接口地址，还是检查网络与适配器兼容性。

avatar
文章
阅读
粉丝