DeepSeek Harness 升级指南：npm 更新 dsh 本体、验证与回滚
真实 Windows 录屏逐帧拆解：查在跑的版本、查 registry 最新版、一条命令升级、读懂回执、重启验证——再加一条装回指定版本的回滚命令。
最近更新: 2026-10-02
dsh 迭代很快：release candidate 几乎每周一支，0.2.0 还停在带破坏性变更的预发布线上。本页把本体升级拆成一个安静的循环——查在跑什么、查最新是什么、升级、读回执、验证、重启——全部画面来自 coder_Mars 的 Windows 真实录屏。片中的版本号与包数（0.1.5-rc.1 升到 0.1.5-rc.2、changed 520 packages）是那支录屏的示例，不是指标。
动手前先分清两层：本页升级的是 dsh 本体，也就是 npm 全局包；给 profile 里装好的插件做更新是另一层、另一套命令，两份教程互相链接。那套流程在 插件更新指南
TL;DR
- ▸两层各管各的：dsh 本体用 npm update -g @deepseek-ai/dsh 升级；插件走 Web UI 插件市场或 dsh plugin update，别混。
- ▸完整循环：先 dsh --version 和 npm view @deepseek-ai/dsh version，再升级，然后 dsh --version 复查、dsh web 启动验证。
- ▸警告不等于失败：录屏里 deprecated、EPERM 清理警告刷了一屏，最后照样打出 changed 520 packages。升级成败看回执那一行。
- ▸回滚只要一条命令：npm install -g @deepseek-ai/dsh@<版本号>；捣乱的插件用 dsh plugin --profile web remove 请出去。
从查版本到一次有证据的回滚
第一部分 · 升级前
- 1
查本机版本，查最新版本
两条只读命令开场。dsh --version 打出你机器实际在跑的版本——录屏里是 0.1.5-rc.1；npm view @deepseek-ai/dsh version 向 npm registry 询问最新发布版，录制当时是 0.1.5-rc.2。两个数字不一样，说明有更新等着；一样，说明已是最新，可以收工。
$dsh --version$npm view @deepseek-ai/dsh version
本机 0.1.5-rc.1，registry 0.1.5-rc.2：一眼两版在 1:50 观看 - 2
记下基线：会话、插件和定时任务
升级替换的是程序，不是数据——配置、会话、已装插件都在你的用户目录里（回执帧能看到 DSH_HOME 解析到 C:\Users\Admin\.dsh）。稳妥起见还是记录现状：dsh plugin --profile web list 列出已装插件，web UI 里能看到会话。如果打算跨进 0.2.0 预发布线，把定时任务也抄一份——0.2.0 迁移幻灯明确说 0.1.x 的自动化任务不会自动迁移。跨大版本前备份一次配置，是最便宜的保险。
$dsh plugin --profile web list
升级前基线：会话与插件都在正常干活在 0:40 观看
第二部分 · 升级、警告与验证
- 3
一条命令升级本体
整个升级就是 npm update -g @deepseek-ai/dsh，和本页其他操作用同一个终端。录屏里作者跑了两次——一次在 PowerShell，一次在全新 CMD 窗口（此前已经升过一轮）。重复跑没有副作用：npm 比对版本，有差异才动手。
$npm update -g @deepseek-ai/dsh
整个升级就一条 npm 命令在 2:50 观看 - 4
看懂警告墙，别慌
升级途中终端刷黄：一条 npm warn deprecated（传递依赖被弃用），接着一串 npm warn cleanup EPERM——Windows 拒绝删除临时目录里旧的 sharp-win32-x64 DLL。这些都没拦住安装，这一轮最后照样打出 changed 520 packages（用时 17s）。结论：判断升级成败看最后一行回执，别看上方滚动的警告。
警告刷了满屏，安装照常完成在 2:00 观看 - 5
核对回执，重启 dsh web
回执帧一屏讲完整个契约：changed 520 packages in 1m；随后 dsh --version 仍是 0.1.5-rc.2——与升级前相同，在这里的含义是「已是最新」，没有更新的版本可装。作者最后用 dsh web 启动收尾：DSH_HOME 解析成功、key pools 加载、rotation proxy 监听 127.0.0.1:8787。你的端口和插件名会不一样，但「版本证据 + 启动日志」这个形状应当一致。
$dsh --version$dsh webchanged 520 packages in 1m，版本未变 = 已最新在 3:16 观看
第三部分 · 升级后：市场巡检、排错与回滚
- 6
升级后巡检：插件市场是另一层
本体升完，web UI 的插件市场显示市场自身 v1.40.0、已安装 10 个、全部更新 (5) 按钮——插件有自己的版本线和更新队列，刚才的本体升级没碰它们。随时在这个界面或用终端更新插件；那套流程归插件更新指南管。
市场 v1.40.0：已装 10 个，5 个更新在排队在 3:24 观看 - 7
出问题第一步：先确认版本
排错录屏的开场和升级录屏一模一样：一个新提示符，dsh --version。动插件、动配置之前，先弄清实际在跑的是哪个版本——排错片的场景是一台升到 0.2.0-rc.1 后出问题的机器，它的第一步仍然是这条只读命令。终端里的版本号才是事实，记忆和二手教程都不是。
$dsh --version
排错第一律：先读版本号在 2:05 观看 - 8
回滚：装回指定版本，请走问题插件
两条出路，各一行命令。要把某个版本装回去，就按精确版本号安装：npm install -g @deepseek-ai/dsh@<版本号>——排错片讲义写作「重新下载指定版本」（历史 tag 在项目的 GitHub Releases 页可查）。如果肇事的是插件而不是本体，dsh plugin --profile web remove 把它从 web profile 移除；同一支片子还提到：也可以在 Web UI 插件列表直接点卸载，插件糟糕到让 DSH 起不来时，可以手动清理配置文件和依赖。把 <版本号> 换成真实 tag，比如你升级前所在的 0.1.5-rc.2。
$npm install -g @deepseek-ai/dsh@<version>$dsh plugin --profile web remove
装回旧版本，或把坏插件请出去在 3:35 观看
0.2.0 线：开发者预览，不是归宿
截至 2026-10-02，deepseek-ai/deepseek-harness 的最新 release 是 dsh-v0.2.0-rc.2，2026-09-29 发布，带 prerelease 标记。0.2.0 线目前整条都是含破坏性变更的 developer preview；本页录屏所在的 0.1.x 线才是求稳的选择。
文档里最咬人的破坏性变更：自动化任务改成了可选插件包，0.1.x 里配好的定时任务升级后不会自动迁移。迁移幻灯给的三步：升级前抄下现有定时任务设置；升级后到插件管理里安装自动化任务插件包；逐个重建任务并在第一次运行时验证。
讨论区里翻得到真实的升级事故：启动崩溃、旧版本装不回去。这不是永远不升级的理由，而是把本页两个习惯养成的理由——跨版本前备份配置，兜里揣着那条固定版本安装命令。版本真翻车时，排错手册和常见报错页已经把典型故障写好了。
FAQ
在让 npm 碰一个能用的安装之前，读者想问的事。
升级会丢配置、会话或插件吗？
npm 包和你的数据不在一个地方：更新替换的是全局程序，配置、会话、已装插件都在用户目录——录屏启动日志里 DSH_HOME 解析到 C:\Users\Admin\.dsh，升级后插件市场仍显示已安装 10 个。例外是跨进 0.2.0：自动化任务变成插件包，0.1.x 的定时任务不会自己迁移。跨大版本前先备份配置。
怎么回滚到旧版本？
按精确版本重装：npm install -g @deepseek-ai/dsh@<版本号>，把 <版本号> 换成真实 tag（比如 0.1.5-rc.2）。历史版本和 tag 都在 GitHub Releases 页。如果是插件闯的祸，先用 dsh plugin --profile web remove 把它卸掉——带着坏插件升本体，多半把同样的毛病再升一遍。
0.2.0 稳定了吗？现在该升吗？
还没有。截至 2026-10-02，最新 release 是 dsh-v0.2.0-rc.2，prerelease 标记，2026-09-29 发布——0.2.0 整条线都是含破坏性变更的 developer preview，比如自动化任务移进插件包且不自动迁移。靠它干活的机器留在 0.1.x 线；想尝鲜就先备份，按三步迁移走，重建的任务逐个在第一次运行时验证。
升级后插件不见了或报错怎么办？
先分层：本体升级不会删插件——录屏结尾市场里还显示已安装 10 个。若是插件在新本体上报错，只卸出问题的那个（dsh plugin --profile web remove），重启后再装回新版。想把插件整体更新到最新，走插件更新那套流程；DSH 完全起不来时，排错手册里有含插件导致启动失败的完整排查。
终端刷了一屏 npm 警告，升级失败了吗？
大概率没有。录屏里 deprecated、EPERM 清理警告一路滚进了 changed 520 packages 回执。npm 警告是旁白，回执行和随后的 dsh --version 才是判决。版本真没动，就把 npm update -g @deepseek-ai/dsh 再跑一次——视频里的作者正是这么做的。
相关攻略
围着本体升级的每一层。
来源与署名
全部截图均为 coder_Mars B站录屏的帧，每张深链到各自秒数。0.2.0 事实来自官方 GitHub Releases（2026-10-02 查询）与下列两支纯幻灯视频——幻灯只作事实源，不取帧。