前言¶
在使用 DeepSeek Harness 或开发智能体时，经常需要切换服务商或接入中转站。拿到一个陌生的 API 地址和 Key，往往不知道它到底能不能用、网络是否通畅、响应速度如何。简单的 curl 或日志检查难以定位是网络问题、Key 权限问题还是模型本身的问题。
插件介绍¶
lfy-bot/dsh-api-probe 是一个专为 DeepSeek Harness 打造的插件，在配置前验证 API Key 和模型可用性。它提供保姆级的中文报错诊断，帮助用户在接入前确认服务状态。
核心功能¶
该插件主要包含以下能力：
- 验证 API Key 和模型可用性：确认 Key 是否有效，模型是否可调用。
- 网络诊断：检测 DNS 解析、TCP 端口连通以及 TLS 握手情况。
- 测速：测量首字延迟、输出速度和成功率。
- 37 个服务商预设：覆盖 OpenAI 兼容、Anthropic 原生和 Gemini 原生等多种接口类型。
- 动态获取模型列表：不硬编码模型名，而是从接口自身的
/models获取。 - 本地运行，Key 不写盘：请求在本地执行，Key 仅在本次请求中使用，不会写入磁盘或发送给第三方。
安装与启用¶
安装前请确保 DeepSeek Harness 版本 >= 0.2.0-rc.2。
- 将
dsh-api-probe代码放置在本地绝对路径下。 - 在终端执行安装命令：
dsh plugin --profile desktop add link:"/绝对路径/dsh-api-probe"
- 安装完成后，完全关闭并重新打开 DeepSeek Harness，左侧栏会出现「API 体检」选项。
典型用法¶
- 在 Harness 左侧栏点击「API 体检」。
- 填写服务商地址和 API Key，点击开始检测。
- 如需走代理，展开「高级设置」，在「代理地址」填入
http://127.0.0.1:7890。 - 测速结束后，查看首字延迟、输出速度和成功率三个指标。
适用场景与注意¶
适用场景：
* 接入新的 API 服务商或中转站前的健康检查。
* 排查网络不通、连接超时或 Key 无效等问题。
* 对比不同服务商的响应速度和稳定性。
注意事项：
* 安全：插件运行在本地，Key 不会被写入文件，仅用于本次测试。
* 诊断文案：诊断报告使用中文，界面其余部分为中英双语。
* 流式限制：不支持 SSE 中途断流后的续传，也不支持流式中途改参数。
* HTTP 版本：当前走 HTTP/1.1，不支持 HTTP/2，对测速结果无影响。
* 预设可靠性：预设里的 base URL 是起点，厂商可能会随时更换域名，建议结合 check_providers.mjs 定期核验。
结尾¶
dsh-api-probe 提供了从网络层到应用层的全链路诊断能力，让 API 接入更加透明可控。通过它，可以快速识别服务商的可用性与性能指标，避免因盲目配置导致的故障。
项目地址：https://github.com/LFY-bot/dsh-api-probe
