前言¶
在 DeepSeek Harness（DSH）中管理多个供应商模型时，确认特定模型的连通性、延迟和输入能力有时是困难的。现有的日志可能不够直接，或者很难提取具体的诊断信息。dsh-provider-probe 插件旨在解决这个问题，通过提供一个手动、低成本的机制来测试供应商路由和适配器配置。
插件介绍¶
这是一个名为 dsh-provider-probe 的社区插件，由 Wanbinyu 维护，采用 MIT 许可证。它不与 DeepSeek 官方有隶属或背书关系。
插件通过 DSH 已注册的适配器发送一个极小的真实模型请求，仅展示首个 token 延迟、总耗时、结束原因、token 用量或脱敏错误。它不创建会话、不写入 session log、不保存或展示模型回复。
核心功能¶
- 路由与目录查看：自动列出当前活动的供应商路由和适配器模型目录。
- 输入能力展示：显示活动模型路由声明的文本、图片或未知输入能力。
- 手动检测：支持手动输入未出现在目录中的模型 ID。
- 按需触发：只在用户点击“开始检测”后发送请求，不做后台轮询。
- 参数限制：默认限制为 8 个输出 token，20 秒强制超时。
- 结果统计：展示首个 token 延迟、总耗时、结束原因和实际 token 用量。
- 错误处理：保留错误码、HTTP 状态和 Request ID，并尝试移除密钥、令牌与用户目录。
- 错误分类与建议：根据明确的状态码和错误特征区分凭据、权限、模型/地址、限流/额度、超时、网络、流兼容与供应商 5xx，并显示下一步建议。
- 报告导出：一键复制适合粘贴到 Issue/Discussion 的脱敏诊断报告。
- 并发控制：同一时间只允许一个检测，可随时取消，避免重复计费和限流。
安装与配置¶
安装前请确认环境满足要求：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.6/dsh-provider-probe-0.3.6.tgz
安装或更新后重启 DSH Web：
dsh web
插件支持通过 YAML 配置调整参数：
- insert:
- id: provider-probe
name: dsh-provider-probe
config:
timeoutMs: 20000
maxTokens: 8
maxMessageLength: 1200
配置项说明：
* timeoutMs：单次检测强制超时，默认 20000 毫秒，范围 1000-120000。
* maxTokens：单次检测最大输出 token，默认 8，范围 1-32。
* maxMessageLength：脱敏错误的最大字符数，默认 1200，范围 256-8000。
使用方法¶
- 打开 DSH Web 的“设置 -> 供应商检测”。
- 在列表中选择供应商和模型，或手动输入模型 ID。
- 点击“开始检测”。
- 查看结果面板，获取首个 token 延迟、总耗时、错误分类及诊断报告。
费用与隐私¶
检测请求会经过 DSH 的正常适配器和用户已经保存的供应商配置，因此可能产生少量模型费用。插件不会读取或返回 API Key；凭据仍由适配器按正常路径解析。模型输出会被丢弃，只保留时延、用量和终止状态。
输入能力来自 DSH 当前模型路由的声明，不会额外发送图片进行验证，因此不增加附件、网络请求或费用。复制的诊断报告只使用页面已经显示的路由、能力、时延、用量和脱敏错误；发布前仍应人工检查。
错误脱敏属于纵深防御，无法保证覆盖每个供应商自定义的敏感格式。公开错误信息前仍应人工检查。
适用场景¶
此插件适合在以下场景使用：排查供应商连通性问题、验证特定模型 ID 是否可用、测试网络延迟、分析错误码以及准备技术讨论所需的诊断报告。
总结¶
dsh-provider-probe 提供了一个轻量级、手动触发的方式来验证 DeepSeek Harness 的供应商配置和模型状态。通过清晰的错误分类和脱敏报告功能，它能够有效辅助开发者定位问题。
