DeepSeek Harness 打不开或请求失败？用启动器和插件分三步排查

使用 DeepSeek Harness 时，“打不开”可能是三件不同的事：本机服务没有起来、网页里的插件加载失败，或者网页正常但模型请求报错。把它们分开，才知道下一步该查哪里。

我维护的 dsh-launcher Windows 启动器和配套插件，就是希望让启动、状态检查和错误反馈更容易找到。这篇按实际排查顺序介绍用法。它们是独立社区工具，并非 DeepSeek 官方产品。

第一步：浏览器连不上，先看启动器状态

如果网页显示无法连接本机地址，先从系统托盘查看 Harness 状态，而不是直接修改模型配置。

启动器在后台启动 Harness，等待服务就绪后打开网页；首次安装需要检查 Node.js、npm 和 Harness，缺失依赖时按向导确认安装，需要联网。

安装 dsh-launcher 并重新打开终端后，也可以使用它的管理命令：

dsh status
dsh doctor

Doctor 会检查 CLI、Node.js、包管理器、Web profile、bundle 清单、端口和日志目录等信息。优先处理报告里的阻塞项；需要重新启动服务时，用托盘的重启入口。

如果要反馈启动问题，可以使用：

dsh doctor --copy

这会复制经过脱敏的诊断报告。分享前再检查一次，不要附上 API Key、登录凭据或完整会话。诊断报告提供的是排查线索，不能保证自动修复所有故障。

第二步：网页报模块错误，核对插件和宿主版本

网页可以连接，但出现客户端模块加载错误时，应查看报错涉及哪个插件，并核对其版本。

此前旧插件曾请求已经退役的 @deepseek-ai/dsh-client-runtime/client 模块。本轮插件修复包已经处理相关兼容问题；只更新仓库源码或者只升级启动器，都不会自动替换本机已安装的旧插件。

可以用官方插件管理入口查看 Web profile：

dsh --version
dsh plugin --profile web list --depth 0 --json

当前这批插件包已验证的 Harness 版本是 0.1.1-rc.2 和 0.1.5-rc.2。其他版本请核对对应 Release 的说明，不能把版本号相近理解为已经验证。

旧用户需要分别更新启动器和正在使用的插件，再重启 Harness。插件向导会先核对宿主版本；生成安装请求后，需要在 Harness 中检查、发送，才会执行安装。

Error Lens 本身也是插件。如果页面因插件加载错误而进不去，应先从终端解决加载问题，再使用网页里的诊断面板。

第三步：网页正常但请求失败，再用 Error Lens

当 Harness Web 能打开、任务却在调用模型时失败，Error Lens 用来查看经过脱敏的供应商错误诊断与排查建议。

此时重点是记录具体错误，而不是反复点击重启。请求失败可能涉及配置、鉴权、限流或供应商状态，应结合实际错误逐项核对；这些只是排查方向，不代表本次已经诊断出原因。

需要进一步主动检查供应商连通性和延迟时，可以按需使用 Provider Probe。它会发送真实模型请求，可能产生费用，不是离线检测。

跑通以后，用 Billing 看用量

启动器负责启动和进程管理，Error Lens 帮助理解失败，Billing 则用来观察 Token 用量与费用估算。

我的推荐顺序是：先把 Harness 跑通，再按需安装 Error Lens 和 Billing。计费显示只能作为估算，最终费用以供应商账单为准；安装这些工具也不会免除模型调用费用。

配套插件按用途选择即可：

插件	当前修复版	主要用途
Error Lens	0.1.7	脱敏错误诊断与排查建议
Billing	0.6.6	Token 用量与费用估算
Companion	0.1.12	任务运行、等待和完成状态
Concurrency Meter	0.1.6	活动请求与峰值并发
Provider Probe	0.3.6	手动连通性与延迟检测
Git Inspect	0.3.6	提供只读 Git 检查工具

从哪里下载

启动器当前版本为 v0.5.2。Windows 安装版选 dsh-launcher-setup.exe，便携版选 dsh-launcher.exe。Release 页的 Source code 是源码，不是安装器。

• 启动器下载：https://github.com/Wanbinyu/dsh-launcher/releases/tag/v0.5.2
• 启动器与插件组统一入口：https://wanbinyu.github.io/wanbinyu-harness-toolbox/
• 启动器反馈：https://github.com/Wanbinyu/dsh-launcher/issues
• Error Lens 反馈：https://github.com/Wanbinyu/dsh-error-lens/issues

如果你遇到了问题，欢迎反馈 卡在以上哪一步、Harness 和插件的版本、具体操作与脱敏错误信息。清楚的复现信息，能帮助这套启动器和插件更快改进。