首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >给 DeepSeek Harness 加一个供应商诊断页:dsh-provider-probe

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

原创
作者头像
用户12697857
发布2026-08-19 21:33:34
发布2026-08-19 21:33:34
1080
举报
dsh-provider-probe 供应商检测界面
dsh-provider-probe 供应商检测界面

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

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

它能做什么

  • 自动读取当前活动的供应商路由和模型目录;
  • 显示模型路由声明的文本、图片或未知输入能力;
  • 支持手动输入没有出现在目录中的模型 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 或更高版本。

代码语言:bash
复制
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

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

卸载命令:

代码语言:bash
复制
dsh plugin --profile web remove dsh-provider-probe

费用与隐私边界

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

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

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

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

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 它能做什么
  • 它是怎么工作的
  • 安装
  • 费用与隐私边界
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档