最近维护 DeepSeek Harness 社区工具时，我遇到一个直接影响使用的问题：从 GitHub 下载后启动，网页没有正常进入，而是出现了 `@deepseek-ai/dsh-client-runtime/client` 模块加载失败。

这次我把启动器和六个插件一起检查、修复并发布了新版。Windows 启动器现在是 **dsh-launcher v0.5.2**，修复版插件也已经可以下载。

先说明身份：这些是我维护的独立社区项目，不是 DeepSeek 官方发布的软件。

## 为什么“源码更新了”，下载包却仍然打不开

这次问题与 Harness 客户端 API 的变化有关。新版宿主拆分、移除了旧的 client runtime；旧版 Companion 的浏览器构建仍然请求其中的模块，其他几个 Web 插件也保留着旧依赖声明。

这里有两个容易混淆的版本：仓库默认分支中的源码，以及 GitHub Release 中已经上传的安装包。

只把修复提交到 GitHub，不会改变之前上传的 EXE 或插件压缩包。用户继续点击旧下载链接，拿到的仍然是旧构建。因此，这一轮除了修源码，我也发布了新包，并同步更新了启动器目录和工具箱入口。

## 这次改了哪些地方

**Companion 不再请求已退役的 runtime 模块。** 它改用独立的官方 Store 引擎，继续通过官方 Slot 接口展示状态；同时适配新版等待交互接口，让“等待审批”等状态能够被识别。

**计费插件兼容新旧用量事件。** 新版最终用量事件和旧版流式用量仍有差异，相关投影与回归检查已一并更新。

**安装推荐会先核对宿主版本。** Launcher 的插件向导现在区分“发布包已验证的宿主版本”和“源码中正在进行的适配”。无法识别宿主版本，或者当前版本不在该插件的已验证列表内时，不允许直接勾选安装。

这不是对所有未来版本作兼容承诺。当前这批插件包验证的宿主版本是 **Harness 0.1.1-rc.2 和 0.1.5-rc.2**。例如 `0.1.5-rc.1` 与 `0.1.5-rc.2` 不是同一个版本，不能仅凭前面的数字相似就当作已验证。

## 启动器和插件各自做什么

dsh-launcher 是 Windows 上的启动与托盘入口：双击启动 Harness Web，在后台管理进程，并提供状态、重启和诊断入口。它不会替代官方 Harness。

插件可以按需要选择：

| 插件 | 本次版本 | 用途 |
| --- | --- | --- |
| Companion | 0.1.12 | 在界面上显示任务状态、等待和完成反馈 |
| Billing | 0.6.6 | 展示 Token 用量与费用估算 |
| Error Lens | 0.1.7 | 提供经过脱敏的错误诊断与排查建议 |
| Concurrency Meter | 0.1.6 | 查看活动请求和峰值并发 |
| Provider Probe | 0.3.6 | 手动检查供应商连通性和延迟 |
| Git Inspect | 0.3.6 | 为 Agent 提供只读 Git 检查工具 |

Provider Probe 的主动检测会发送真实模型请求，可能产生少量费用；它不是一个完全离线的检测器。Billing 展示的是费用估算，也不能替代供应商账单。

## 我做了哪些验证

六个插件共 145 项测试通过，并完成了新旧两组依赖回归。Git Inspect 还通过了 Windows、macOS、Linux 检查。

在隔离的 Harness Web 环境中，我安装了最终插件包，检查了 Companion 的桌面与 390 × 844 窄屏显示。此前的实际加载检查还覆盖了供应商检测和并发监控面板。

Launcher 的编译、单元测试、启动冒烟和安装包检查均已通过。上传后也核对了发布资产的 SHA-256。

这些结果证明的是测试覆盖范围内的行为和页面加载情况；这次隔离验证没有使用真实 API Key，也没有发送真实模型对话，不能当作所有供应商和任务都已实测。

## 已经安装过旧版，怎么更新

1. 下载并安装 **Launcher v0.5.2**，也可以选择便携版。
2. 运行 `dsh --version`，核对 Harness 的具体版本。
3. 更新需要使用的插件。**升级 Launcher 不会自动替换已经安装的旧插件。**
4. 插件更新后，从托盘重启 Harness，再检查页面是否正常加载。

以 Companion 为例，已验证宿主上的安装命令是：

```powershell
dsh plugin --profile web add https://github.com/Wanbinyu/dsh-companion/releases/download/v0.1.12/dsh-companion-0.1.12.tgz
```

如果旧插件已经让网页无法进入，可以从终端执行安装命令，不必先进入插件向导。

## 下载与反馈

- 工具箱与全部下载入口：https://wanbinyu.github.io/wanbinyu-harness-toolbox/
- Launcher v0.5.2：https://github.com/Wanbinyu/dsh-launcher/releases/tag/v0.5.2
- Companion v0.1.12：https://github.com/Wanbinyu/dsh-companion/releases/tag/v0.1.12
- 启动器问题反馈：https://github.com/Wanbinyu/dsh-launcher/issues

如果你也在 Windows 上使用 Harness，欢迎试用后反馈具体问题。报错时附上 Harness 版本、插件版本、操作步骤和脱敏后的错误信息，会更容易复现；不要贴 API Key 或完整会话内容。

我也想听听实际使用中的优先级：你最需要的是更顺畅的启动入口、费用与错误提示，还是任务状态反馈？

最近维护 DeepSeek Harness 社区工具时，我遇到一个直接影响使用的问题：从 GitHub 下载后启动，网页没有正常进入，而是出现了 @deepseek-ai/dsh-client-runtime/client 模块加载失败。

DeepSeek Harness 插件加载失败排查：启动器 v0.5.2 与兼容性修复

新版 Harness 的客户端模块变化导致旧插件无法加载。这次发布 dsh-launcher v0.5.2 与六个插件修复包，介绍问题原因、宿主版本检查、新旧依赖回归及旧用户升级步骤，并提供下载入口。

开发工具

客户端

后端

DeepSeekHarness社区工具修复新版发布：解决启动器加载失败问题，更新dsh-launcher v0.5.2及六个插件，兼容Harness 0.1.1-rc.2和0.1.5-rc.2。修复Companion运行时依赖、计费插件事件兼容，增强安装向导版本验证。提供下载链接和更新指南，帮助用户解决网页无法正常进入的故障。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

DeepSeekHarness社区工具修复新版发布：解决启动器加载失败问题，更新dsh-launcher v0.5.2及六个插件，兼容Harness 0.1.1-rc.2和0.1.5-rc.2。修复Companion运行时依赖、计费插件事件兼容，增强安装向导版本验证。提供下载链接和更新指南，帮助用户解决网页无法正常进入...

DeepSeek Harness 插件加载失败排查：启动器 v0.5.2 与兼容性修复-腾讯云开发者社区-腾讯云

DeepSeek Harness 插件加载失败排查：启动器 v0.5.2 与兼容性修复

DeepSeek Harness 插件加载失败排查：启动器 v0.5.2 与兼容性修复

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐