更新 DeepSeek Harness 时，执行 npm update -g @deepseek-ai/dsh 后版本号没变，这通常不是操作失误，而是 @deepseek-ai/dsh 这个 npm 包的版本发布策略造成的。
npm 上的版本和 GitHub 上的版本，是两条线
DeepSeek Harness 的 npm next 渠道与 GitHub Releases 是独立发布的。GitHub Latest 当前指向 dsh-v0.1.0-rc.12，但 npm 上 @deepseek-ai/dsh 这个包的最新可安装版本停留在 0.1.0-rc.7。
也就是说，你在 GitHub Releases 页面看到 rc.12 是最新的，不等于 npm 上能装到 rc.12。这两个渠道的版本号可以不同步，而且通常就是不同步的。
npm update -g 为什么没效果？ 因为 npm update 只会在已安装版本所在的版本范围内查找更新。如果你已经装了 0.1.0-rc.7，而 npm 源里没有比 0.1.0-rc.7 更高的版本，npm update 就不会做任何事。你看到的“added 21 packages, removed 100 packages”这类输出，是 npm 在更新其他依赖包，@deepseek-ai/dsh 本身的版本没变。
那怎么才能用到新版本？
分三种情况：
1. 只想用 npm 渠道的最新版
如果你不执着于 GitHub 上的 rc.12，只想确保用的是 npm 上最新的可用版本：
npm install -g @deepseek-ai/dsh@latest
当前 npm latest 标签指向 0.1.0-rc.7，装完执行 dsh -V 确认即可。
2. 想用 GitHub 上的 rc.12
rc.12 没有发布到 npm，无法通过 npm install 直接安装。要用这个版本，需要从源码拉取：
git clone --branch dsh-v0.1.0-rc.12 --depth 1 https://github.com/sdkwork-ai/deepseek-harness-desktop.git
cd deepseek-harness-desktop
pnpm install
pnpm run build
pnpm dsh web
--branch dsh-v0.1.0-rc.12 指定了你要的版本标签。--depth 1 只拉取最新提交，节省时间。
3. 用 npx 临时跑，不纠结版本号
如果只是临时使用，不需要固定版本，npx 是最省事的方案：
npx @deepseek-ai/dsh@next web
这条命令每次执行时都会从 npm next 渠道拉取最新可用版本。想确认当前会拉到什么版本，可以先跑：
npx @deepseek-ai/dsh@next --version
注意：npx @deepseek-ai/dsh web（不带 @next）和 npx @deepseek-ai/dsh@next web 拉的可能是不同版本，前者走 latest 标签，后者走 next 渠道。
升级前看一眼这个
DeepSeek Harness 目前处于开发者预览阶段，官方明确写了“未来将出现破坏兼容性的变更”。版本升级可能导致旧会话无法继续、插件设置卡片消失等问题。
如果你已经在用某个版本跑正式任务，升级前建议：
-
记录当前版本和已安装的插件列表 -
在隔离环境（比如新建一个目录）先验证新版本能否正常工作 -
确认没问题后再切换，保留旧版本环境以备回退
操作速览
| 你的目标 | 命令 |
|---|---|
| 更新到 npm 最新版 | npm install -g @deepseek-ai/dsh@latest |
| 用 GitHub rc.12 | 从源码 git clone --branch dsh-v0.1.0-rc.12 构建 |
| 每次临时跑最新 | npx @deepseek-ai/dsh@next web |
| 查看 npm next 渠道版本 | npx @deepseek-ai/dsh@next --version |
FAQ
Q：npm update -g 后版本没变，是我装错了吗？
不是。@deepseek-ai/dsh 的 npm 源目前最高就是 0.1.0-rc.7，没有更高版本可更新。
Q：GitHub 上已经有 rc.12 了，为什么 npm 装不到？
npm next 渠道与 GitHub Releases 独立发布，版本不同步。rc.12 目前只通过 GitHub 源码分发。
Q：npx @deepseek-ai/dsh@next web 和 npx @deepseek-ai/dsh web 有什么区别？
前者走 next 渠道，后者走 latest 标签。两者可能指向不同版本。
Q：我已经全局装了旧版，怎么切到 next 渠道？
npm install -g @deepseek-ai/dsh@next 会覆盖安装 next 渠道的版本。
Q：版本升级后旧会话打不开了怎么办？
开发者预览阶段存在破坏性变更，升级前建议在隔离环境先验证。如果已经升级且无法回退，可以尝试新建会话，旧会话数据可能已不兼容。
Q：dsh web 默认端口是多少？
npx 和源码方式默认 3080，Docker 部署默认 4080，Kubernetes 端口转发默认 4081。
Q：桌面应用和 npx 方式的数据会互相影响吗？
会。桌面应用和 npx 启动方式共享 $DSH_HOME 或 ~/.dsh 目录，包括配置文件、凭据、会话和附件。
