DSH 怎么更新?npx 与 git pull 更新本体,插件用 dsh plugin update

更新与升级发布于 2026-08-19作者: DSH-Plugin 插件中心
DSHDeepSeek HarnessDSH plugin更新升级
DSH 处于开发者预览阶段,迭代很快。npx 方式每次运行都会拉取最新版,源码构建用 git pull 更新,DSH plugin 则通过 dsh plugin --profile web update 升级。本文覆盖 DSH 本体和插件的完整更新流程。

更新 DSH 分两件事:本体用 npx 或 git pull,DSH plugin 用 dsh plugin --profile web update,两条路都不复杂。

先看你怎么装的 DSH

更新方式取决于安装方式。 DSH 是开发者预览阶段(当前 0.1.0-rc.6),迭代快,版本发得勤(来源)。两种安装方式的更新方法不一样,插件的更新和本体又是两回事。

方式一:npx 一键运行 DSH

npx 装的不需要手动更新,重跑就是最新版。 npx @deepseek-ai/dsh web 每次都会从 npm 拉取最新版本(来源)。所以「更新」就一句话:下次启动时重新执行 npx 命令。npx 只是临时拉包,不会在系统里留下全局安装,也就没有「升级安装包」这回事——你不需要先卸载旧版本,npx 每次拉的都是同一个最新包,旧的临时文件由 npm 自动处理。web--profile web 的别名,这条命令启动的正是 Web UI 用的那个 profile。

方式二:源码构建 DSH

源码克隆的进仓库拉代码、装依赖、重新构建。deepseek-harness 仓库目录里依次执行:

bash
git pull
pnpm install
pnpm run build
pnpm dsh web

最后一行和 npx 启动的是同一个 Web UI,只是跑在你本地构建的版本上。官方说明里强调生产运行需要先有构建产物,前端静态文件也在其中,所以 pnpm run build 这步不能省(来源)。第一次构建要联网拉依赖,比 npx 慢不少,属于正常现象,后面增量构建会快很多。

DSH plugin 怎么更新

插件升级用 dsh plugin --profile web update 这个命令会把参数转发给 profile 目录里的 pnpm,更新全部依赖:

bash
dsh plugin --profile web update

只想更新某一个插件,就加上包名:

bash
dsh plugin --profile web update <插件包名>

想确认某个插件为什么被装、被谁依赖,用 dsh plugin --profile web why <包名>来源)。因为 dsh web--profile web 的别名,这里更新的正是 Web UI 加载插件用的那个 profile;如果你还跑着 headless profile,它的插件要单独更新:dsh plugin --profile headless update。如果 update 命令报错,先确认 DSH 本体是最新版,预览版之间插件的依赖声明可能不兼容。

更新 DSH 前后的注意点

更新前备份会话数据,更新后核对插件兼容性。 具体来说:

  1. 会话数据在 ~/.dsh/sessions 下,更新前复制一份最稳妥。备份只是复制目录,不影响正在运行的 DSH,随时可以执行。
  2. DSH 是预览版,可能有破坏性变更,升级插件前先看插件详情页标注的兼容版本。
  3. 更新后跑一遍主要功能,插件不加载再回头看《DSH 常见问题排查》。

更新不是高频操作,建议跟上官方的发布节奏,别囤太多版本再一次性升级。

来源:官方 Quickstartdsh CLI READMEdeepseek-ai/deepseek-harness

常见问题

DSH 怎么更新?

看安装方式:npx 装的重跑 npx @deepseek-ai/dsh web 就是最新版;源码构建的进仓库执行 git pull && pnpm install && pnpm run build。

DSH plugin 怎么更新?

执行 dsh plugin --profile web update 升级当前 profile 的所有插件;加上包名只更新指定插件,命令会转发给 pnpm。

更新 DSH 之后插件会坏掉吗?

有可能。DSH 是开发者预览,升级可能带破坏性变更,更新前先看插件详情页的兼容版本,更新后跑一遍主要功能。

更新前需要备份 DSH 数据吗?

建议备份。会话数据在 ~/.dsh/sessions 目录,复制一份最稳妥,升级出问题也能恢复。

怎么确认 DSH 是不是最新版?

npx 每次启动都拉最新版,不用额外确认;源码构建的看 git pull 输出即可。当前发布版是 0.1.0-rc.6。

来源