DeepSeek Harness 更新标准步骤：先查当前版本与安装方式、备份用户数据，再按 npx / npm 全局 / 源码三种方式之一升级，最后验证版本号、Web UI 与插件。附插件更新入口与失败回滚指引。
本文转自 DSH Plugin Hub 插件市场
DeepSeek Harness 更新按「查版本 → 备份 → 按安装方式升级 → 验证」四步走：先确认当前版本和当初的安装方式，备份用户数据，再用对应命令升级，最后验证版本号、Web UI 与插件都正常。 DeepSeek Harness 处于开发者预览阶段、迭代很快，知道一套标准的更新流程，能省掉大部分踩坑时间。
概览
「dsh 更新」的本质是换程序文件：升级动作只碰 DSH 本体，配置、会话与插件数据都在独立的数据目录里，所以更新本身不危险——危险的是不看版本、不备份、装错方式就升级。 本文是一份「第一次照着做的标准步骤 + 验证清单」：更新前先回答三个问题，再执行升级，最后逐项验证。卡住、失败、想回滚、想锁版本的深挖见文末的对应旧文。
更新 DeepSeek Harness 前准备：查当前版本、确认安装方式、备份
更新前先花两分钟做三件事，决定你后面用哪条命令、要不要担心数据。 逐项做：
- 查当前版本与安装方式：终端执行
dsh --version有输出 → 你是 npm 全局或源码构建方式；没有该命令 → 你是 npx 免安装方式（每次启动即最新）；回想当初是git clone构建的 → 源码方式； - 决定要不要更新：到 GitHub Releases 或 npm 包页 看最新版与发布说明，确认新版值得追（尝鲜跟 rc、求稳跟 latest，版本号规则见《dsh 版本号怎么看》）；
- 备份用户数据：正常更新不丢数据（密钥、profile、会话都在默认
~/.dsh的用户数据目录，与程序分离），但开发者预览阶段偶有大版本存储迁移，稳妥起见把~/.dsh下的关键目录拷一份——备份哪些目录、为什么不会丢，见《更新会丢配置吗》。
按当初安装方式更新 DeepSeek Harness：npx、npm 全局与源码三选一
升级命令取决于你当初怎么装的——装法决定升级法，别跨方式硬套。 三种方式对应如下（当初安装方式的完整说明见《DeepSeek Harness 第一次安装教程》）：
- npx 免安装方式（最省心）：再次执行启动命令即可，运行时会解析官方最新版：
npx @deepseek-ai/dsh web
想强制最新版，用 npx @deepseek-ai/dsh@latest web；感觉仍是旧版，多半是本机 npx 缓存，npm cache clean --force 清理后重跑。
- npm 全局安装方式：升级全局包并验证版本：
npm install -g @deepseek-ai/dsh@latest
dsh --version
- 源码构建方式：拉取最新代码并重新构建（
pnpm run build生成新产物，之后照常用pnpm dsh web直接跑产物）：
git pull
pnpm install
pnpm run build
若 git pull 因本地改动冲突，先处理本地改动再更新，排查见《更新失败怎么办》。
更新 DeepSeek Harness 后验证：版本号、Web UI、数据与插件四连查
更新完不着急用，按下面清单逐项验证，确认无误再开工。 四项验证：
- 版本号：全局/源码方式执行
dsh --version，应显示新版本号；npx 方式以启动时界面显示的版本为准； - Web UI 能启动：运行启动命令，浏览器打开
http://127.0.0.1:3080，界面正常出现即通过； - 数据还在：登录后确认会话列表、配置、模型提供方设置都还在——正常更新它们不会被清掉（数据在用户目录，独立于程序）；
- 插件还能用：重启后进入 DSH Plugin Hub 的「已安装」列表，确认已装插件都在且能正常加载。
顺带一提：DSH 插件的更新也走同一条路
本体验证通过后，顺手把插件也更新到兼容新版的状态——在 DSH Plugin Hub 的已安装列表点「可更新」即可，比命令行更直观。 插件检测到新版本时，已安装列表会给出可更新入口，点开后确认即原位覆盖升级到最新版：
插件更新的完整命令与批量策略见《dsh plugin 批量更新》；更新后插件与新版不兼容的排查与回滚见《更新后插件不兼容》；想整体管理版本、降级回旧版，见《dsh 怎么升级到最新版》。
一句话收尾：查版本、备份、按装法升级、四项验证——把 DeepSeek Harness 的更新做成流程，预览期的频繁迭代就不吓人了。
常见问题
怎么知道 DeepSeek Harness 出新版本了：查 dsh --version 还是看官方发布说明？
判断 DeepSeek Harness 有没有新版本，先看本机再看官方：npm 全局或源码方式执行 dsh --version 看当前版本，npx 免安装方式没有全局命令，以启动界面显示的版本为准。官方最新发布以 npm 包页的 npm view @deepseek-ai/dsh version 与 GitHub 的 deepseek-ai/deepseek-harness Releases 发布说明为准，两边一对就知道该不该更新。
用 npx 启动的 DeepSeek Harness 怎么更新？
用 npx 免安装方式更新 DeepSeek Harness 很简单：再次执行 npx @deepseek-ai/dsh web 即可，每次运行会按当前网络解析官方最新版；想强制最新就执行 npx @deepseek-ai/dsh@latest web。若跑完仍像旧版，多半是本机 npx 缓存，用 npm cache clean --force 清理后重跑一次。
更新 DeepSeek Harness 会丢插件、会话或配置吗？
更新 DeepSeek Harness 只替换程序文件，不碰你的数据：密钥、profile 与会话都存在用户数据目录（默认 ~/.dsh 下），独立于程序安装位置，所以正常更新不丢插件与会话。开发者预览阶段的个别大版本可能带存储迁移，更新前按本文先备份最稳妥，细节见《更新会不会丢配置》。
更新 DeepSeek Harness 后插件不兼容，或想整体回退 dsh 到旧版本怎么办？
插件问题和 dsh 本体回退要分开处理：插件加载报错多半是插件与新版不兼容，到 DSH Plugin Hub 已安装列表卸载后改装兼容版本即可。想整体回到旧版 dsh，npm 全局安装时执行 npm install -g @deepseek-ai/dsh@旧版本号 指定版本，源码方式用 git checkout 旧 tag 重新构建。
本文转自 DSH Plugin Hub 插件市场，版权归属 DSH Plugin Hub 插件市场。
分类：更新与升级
原文地址：https://dsh-plugin.org/zh/tutorials/update-dsh-steps
来源：deepseek-ai/deepseek-harness、deepseek-ai/deepseek-harness Releases、@deepseek-ai/dsh on npm
