DeepSeek Harness 怎么安装：npx、全局 npm、桌面端与源码四条路对照怎么选

DeepSeek Harness 有四条安装路：npx、全局 npm、桌面端、源码。 四条都能跑，但前提、维护方式与适用人群不同；选错，后面更新与卸载都会别扭。

四条路对照

先看一张表，再逐条展开。

四条路不要求都装，数据位置也与安装方式解耦。 选一条作为主路径，其余只在特定场景使用；同时装多份，容易出现版本与数据混淆。会话、插件与配置在 DSH_HOME 下，换安装方式不会自动迁移，但也不会丢。

npx：临时体验

npx 是最低门槛的入口，适合先看看。

1. 确认 Node.js 可用：node -v。
2. 执行 npx @deepseek-ai/dsh web。
3. 浏览器打开终端输出的本地地址。
4. 首次进入按引导初始化模型与 profile。
5. 用完关闭即可，不残留全局命令。

npx 每次都拉最新版，也会写数据。 好处是不用管更新，坏处是启动慢、版本会变；需要稳定版本时改用全局安装。会话与配置仍落在 DSH_HOME；以为「临时运行不留痕」，可能会意外保留数据。

全局 npm：长期使用

开发机长期使用，全局安装最省事。

1. 确认 npm 全局目录与 PATH。
2. 执行 npm install -g @deepseek-ai/dsh。
3. 用 dsh --version 确认命令可用。
4. 启动 dsh web，浏览器访问。
5. 需要升级时用 npm 更新，不要重复安装。

PATH 是最常见的问题，全局安装也要管版本。 命令找不到时，先看全局 bin 是否在 PATH；npx 能跑、dsh 不能跑，就是路径问题。升级前记录当前版本，出问题能回退；不要每次都装 latest 而不留记录。

桌面端：图形界面

桌面端适合想要窗口、托盘与系统集成的人。

1. 打开 Releases，选择对应系统的安装包。
2. 安装并启动，按引导完成初始化。
3. 在设置里配置模型与插件市场。
4. 更新走应用内提示，不要手动覆盖安装目录。
5. 卸载走系统卸载流程，再清理残留数据。

桌面端与命令行共享数据时要小心，Linux 也没有官方桌面包。 同一份 DSH_HOME 被两个版本同时使用，可能出现锁与版本不一致；不要让两个进程同时写。Linux 这种情况改用命令行加浏览器，不要找第三方打包。

源码：开发与定制

需要改代码、看实现或提 PR 时才走源码。

1. 克隆仓库并切换到目标分支。
2. 按仓库说明安装依赖并构建。
3. 用构建产物启动，确认版本与提交对应。
4. 改动后重新构建，必要时清理缓存。
5. 更新用 git pull，再重新构建。

源码路线的成本在构建，源码与全局安装也不要混用命令。 依赖、Node 版本与构建脚本都可能出问题；只想要功能时，不要走这条路。两个 dsh 可能指向不同位置；用 which dsh 确认实际调用的是哪个。

怎么选：按场景对号

选择标准是「用多久、要不要改、要不要图形」。

先选一条主路径，再按需补充，不要为了「都试试」装四条。 例如日常用全局 npm，排查源码问题时临时克隆仓库。版本与数据混淆的排查成本，远高于省下的选择时间。

装完验证

四条路的验证信号一致，按三层确认。

1. 命令层： dsh --version 能输出版本。
2. 服务层： dsh web 能启动并输出访问地址。
3. 功能层： 浏览器能打开界面，完成一次最小对话。

三层都过，才算装好，也要记录安装方式与版本。 只过命令层，可能服务启动失败；只过服务层，可能模型没配好。出问题时先确认「装的是哪条路、哪个版本」，比盲目重装有效。

更新与卸载的对应

四条路的维护方式不同，别用错。

1. npx： 无需更新，每次拉最新；清理缓存即可。
2. 全局 npm： 用 npm 更新与卸载，注意 PATH 残留。
3. 桌面端： 应用内更新，系统卸载；再清数据目录。
4. 源码： git pull 后重新构建；切换分支要清理产物。

卸载不等于删数据，更新前也要做快照。 会话、插件与配置在 DSH_HOME 下，需要单独清理；只卸载应用，数据还在。版本清单与数据目录各一份，出问题能回退。

下一步

先选路径，再验证三层。 想看四条路的详细对比，看《DeepSeek Harness 安装方式对比》；想看桌面端下载，看《DeepSeek Harness 从哪下载》；想看 Linux 方案，看《deepseek harness desktop linux 怎么跑》。

来源：DeepSeek Harness 官方文档、dsh CLI README、DeepSeek Harness Releases