发布日期:2026-11-16

截至 2026 年 11 月,DeepSeek 官方开发的开源智能体框架 DeepSeek Harness 仍处于开发者预览阶段,桌面应用、npm 启动器与插件分别更新。遇到升级失败,先确认安装来源,再判断问题发生在下载、安装还是启动阶段。11 月 13 日发布的 v0.2.2-rc.3 已修复 Windows 应用内更新可能失败、无法自动重开的故障,但 npm 的 latest 标签尚未指向它。本文按具体症状梳理重试、安装恢复、版本核对与诊断方法,帮助你在保留配置和会话的前提下定位问题。


在这里插入图片描述

先确认:你更新的是哪一个 Harness?

桌面应用、npm 包和 profile 插件拥有不同的更新入口,升级其中一个,并不代表其他部分同步升级。

用安装包装的桌面版,先在应用菜单的“关于 DeepSeek Harness”查看版本;通过终端启动的用户,运行 dsh --version。还要注意:桌面版也能通过“管理 dsh 命令…”注册终端入口,这个命令的运行时随桌面版更新。

如果电脑上有多个 dsh,macOS、Linux 用 type -a dsh 查看,Windows PowerShell 用 Get-Command dsh -All 查看。先确认命中的路径,再决定更新桌面应用还是 npm 全局包。

dsh plugin --profile web update 更新的是 web profile 的插件依赖;截至本文核验的 rc.3 官方帮助,也没有用于自更新的 dsh update 或 dsh doctor 命令。

在这里插入图片描述

桌面端更新卡住:重试、安装与退出顺序

**Windows 用户遇到应用内更新失败、安装后没有自动打开,先核对版本和安装状态。**DeepSeek 官方在 2026 年 11 月 13 日的 v0.2.2-rc.3 发布说明中明确修复了这两类问题;GitHub 将它标为预发布版本。

下载失败:再次点击重试,先读具体错误

打开应用菜单的“检查更新…”,或左下角的更新入口查看状态。按 rc.3 桌面文档,下载失败后保留重试提示,需要用户再次操作;自动检查不会自动下载安装包。

错误详情如果明确指出空间不足、无法写入或文件占用,就针对所列磁盘、路径处理。若提示“更新配置异常”,从详情定位配置文件,修正报出的 JSON 或字段问题,再选择“重新读取配置”。不要直接删除整个用户目录。

“设置 → 通用设置 → 更新渠道”中的正式版对应 stable,开发版对应 nightly。渠道由发布者独立选择版本,正式版渠道也可能提供 RC;不能只凭版本后缀判断渠道,更不能与 npm 的 latest、next 标签混为一谈。

已下载:确认“安装并重启”,关窗口不会安装

普通退出不会安装更新。等当前任务完成,再从就绪入口确认安装;如果窗口之前隐藏了,重新显示窗口查看确认提示。安装期间按提示等待,避免反复启动。

若提示应用仍在运行,Windows 应从系统托盘选择“退出 DeepSeek Harness”,macOS 从应用菜单退出;同时结束正在使用桌面版运行时的终端命令。关闭主窗口可能只是隐藏,进程依然占用安装文件。

旧版更新器反复失败:改走官方安装包

从 DeepSeek Harness 官方下载入口重新取得与你的系统、架构匹配的安装包,核对目标版本,完全退出旧程序后安装。Windows 使用安装器识别的现有安装位置更新,完成后再从“关于”确认实际版本。

**覆盖更新与主动卸载的数据保留范围不同。**按 rc.3 官方文档,Windows 原地更新保留用户数据,主动卸载会清除 Electron 用户数据等目录;Harness 主目录则另有保留规则。因此,重新安装前先备份实际使用的 Harness 主目录和桌面用户数据,不把“卸载重装”当第一步。

如果安装器明确报告“旧目录恢复失败”,保留报告列出的备份目录,联系官方支持后再重装。这是官方打包文档单独说明的情况。

在这里插入图片描述

npm 更新后版本没变:先看标签和命令路径

**npm 的 latest 是发布标签,不保证指向版本号最高的候选版。**2026 年 11 月 16 日官方注册表显示:latest 为 0.2.2-rc.1,next 为 0.2.2-rc.3。反复安装 latest 仍得到 rc.1,可能是标签选择的结果。

先查当前标签与目标包的 Node 要求:

npm view @deepseek-ai/dsh dist-tags --json
npm view @deepseek-ai/dsh@0.2.2-rc.3 engines --json
node --version

如果你配置了 npm 镜像,可在查询末尾临时加 --registry=https://registry.npmjs.org/ 与官方结果比较,无须修改永久配置。标签会变化,以执行时的返回值为准。

截至本文核验,rc.3 npm 包要求 Node.js >=24.9.0。遇到 EBADENGINE,先核对系统 Node;桌面版自带运行时,不能据此要求所有桌面用户安装系统 Node。

原本通过 npx 使用、明确需要验证这个候选版时,可以固定版本运行;以下操作会下载或复用缓存包:

npx @deepseek-ai/dsh@0.2.2-rc.3 --version
npx @deepseek-ai/dsh@0.2.2-rc.3 web

如果原本就是 npm 全局安装,才使用这一组:

npm install -g @deepseek-ai/dsh@0.2.2-rc.3
dsh --version

安装成功却仍显示旧版,回到前面的命令路径检查,并打开新终端复核。全局安装出现 EACCES 时,按 npm 官方指引使用 Node 版本管理器处理权限;不要把清空 Harness 配置当成 npm 权限修复。

在这里插入图片描述

更新完成却打不开:转入启动诊断

程序已经替换成功,随后插件或 Host 启动失败,需要检查启动诊断,继续下载同一个包未必有效。

桌面版出现原生故障恢复弹窗时,先选择“获取诊断报告”。若错误指向第三方插件,可使用“禁用第三方插件、备份 profile patch 并重启”。这会停用第三方组合包,并备份 profile 的用户 patch;已安装包和此前备份保留,home 级 patch 不变,不能等同于清空所有配置。

CLI 若输出 Full diagnostics:,按其实际路径查看启动报告;必需插件激活失败的报告默认位于 ~/.dsh/logs/,自定义 DSH_HOME 时路径相应变化。提交日志前检查并移除 Key、token 等敏感内容。

源码用户还要确认构建:官方文档明确 pnpm dsh web 不会自动重新构建。已经切到目标版本源码、保留本地修改并停止旧服务后,重新执行 pnpm install、pnpm run build,再启动服务。

依据 DeepSeek 官方发布说明和桌面参考文档,排查更新问题的关键是确认入口、失败阶段和实际运行版本。本文资料截至 2026 年 11 月 16 日;后续版本与标签请重新查询官方记录。

参考资料

  • 桌面故障恢复与诊断:github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.2-rc.3/apps/desktop/docs/diagnostics/README.zh.md
  • 七牛云 AI 大模型广场:qiniu.com/ai/models
Logo

宁波官方开源宣传和活动阵地,欢迎各位和我们共建开源生态体系!

更多推荐