DeepSeek Harness 怎么安装最好?DSH plugin 全局、npx 与桌面三种方式对比
DeepSeek Harness 本体有三种拿法:npx 免安装直跑、npm install -g 全局常驻、桌面应用自带运行时(来源)。 这篇不做单方式的步骤教学,只做横向对比:三种方式各是什么、五个维度上怎么权衡、以及你该按哪个场景选哪条路。
概览:DeepSeek Harness 三种安装方式一张表
一句话先记住差异:npx 不留痕、全局常驻、桌面自带环境。 对照如下:
| 维度 | npx 免安装 | 全局安装 | 桌面应用 |
|---|---|---|---|
| 触发命令 / 入口 | npx @deepseek-ai/dsh web | dsh web | 双击应用图标 |
| 是否写入系统 | 不写 | 写 PATH 与全局依赖 | 装一个独立应用 |
| 版本新鲜度 | 每次拉最新 | 要手动更新 | 由应用自身检查更新 |
| 自带运行时 | 否,用系统 Node | 否,用系统 Node | 是,内置 Node / pnpm / Python |
| 典型场景 | 一次性试用 | 天天在终端用 | 当桌面软件常驻 |
看懂这张表,后面的对比与选型都能顺着推。
DeepSeek Harness 三种方式分别是什么:免安装、全局常驻与独立客户端
- npx 免安装直跑 —
npx @deepseek-ai/dsh web会临时拉取并运行 DeepSeek Harness,不写入 PATH,用完即走(来源)。预期:不装任何东西就能进界面。展开见《npx @deepseek-ai/dsh web 怎么用》。 - npm 全局安装 —
npm install -g @deepseek-ai/dsh把dsh命令装进系统全局位置并加入 PATH,之后任何目录都能直接敲dsh web。预期:dsh --version能打印版本号。步骤见《dsh 全局安装》。 - 桌面应用 — 从官网下载安装包得到独立客户端,界面通过应用内协议加载,并自带 Node、pnpm 与 Python 运行时(来源)。预期:双击图标直接进入界面。下载与形态见《DeepSeek Harness 桌面端下载》。
逐项对比:DeepSeek Harness 三种安装方式的五个维度怎么权衡
五个维度里,真正影响选择的是「要不要常驻」与「网络受不受限」,其余是顺带结果。
| 对比项 | npx | 全局安装 | 桌面应用 |
|---|---|---|---|
| 上手速度 | 首次要下载,最慢 | 装一次,之后最快 | 装一次,之后最快 |
| 版本新鲜度 | 每次最新,无需维护 | 手动 npm update -g | 应用内检查更新 |
| 全局环境 | 零残留 | 留一条 dsh 命令 | 装一个应用与内置运行时 |
| 离线 / 内网 | 基本不可用 | 需配镜像或离线包 | 装包后基本自足 |
| 更新方式 | 天然最新 | 一条命令 | 应用内更新 |
几点展开:
- 版本新鲜度:npx 每次运行都取 npm 上的最新版,天然不落后;全局安装要主动
npm update -g @deepseek-ai/dsh才会升;桌面端走自己的更新通道。 - 系统改动:npx 不写 PATH,适合不想留痕的场景;全局安装留一条命令,移除用
npm uninstall -g @deepseek-ai/dsh;桌面端多一份内置运行时,占磁盘但少折腾环境。 - 离线 / 内网:npx 与全局安装都依赖联网拉包,纯内网会失败;桌面端装好包后基本自足。受限网络请看《DeepSeek Harness 离线安装与内网部署》。
- 数据位置一致:不管哪种方式,会话、设置与凭据都落在同一个
$DSH_HOME(默认~/.dsh),换方式不必重配模型;差异只在可执行层与插件归属的 profile。
该怎么选 DeepSeek Harness 安装方式:一次性试用、长期使用、受限网络
按场景对号入座,别纠结「哪个最好」——三种方式本来就是给三种人用的。
- 只想试试看 → 用 npx。一条
npx @deepseek-ai/dsh web免安装直跑,不留痕。预期:几分钟内进界面,退出即净。 - 天天在终端里用 → 全局安装。装一次、之后
dsh web秒起,还方便写脚本调dsh plugin。预期:插件与命令都可脚本化。综合路径见《DeepSeek Harness 安装完整指南》。 - 当桌面软件常驻、不想配环境 → 桌面应用。自带运行时省去 Node / pnpm / Python 配置。预期:双击即用,环境零配置。
- 内网或受限网络 → 走离线分发,别用 npx。预期:不联网也能装起。
无论哪种方式,装好 DeepSeek Harness 本体后,能力扩展都从同一处补齐:到 DSH Plugin Hub 搜插件、装插件、看同类实现,插件机制与安装方式无关。

安装 DeepSeek Harness 的注意事项
- npx 每次都下载:免安装的代价是首次启动慢,网络差时体验明显,别拿它当日常入口。
- 全局安装注意 Node 版本:它用系统自带的 Node,版本过低会先撞环境问题,装前先确认 Node 与包管理器可用。
- 桌面端不接命令行:桌面端的 profile 由它自己独占,命令行不接管,插件要装在对应环境里。
- 数据别重复配:三种方式共享同一个
$DSH_HOME,换方式前不必迁移,但清理时要确认影响范围。 - 更新分两条线:本体更新(npx / 全局 / 桌面各不相同)与插件更新(统一走市场)是两件事,别混为一谈。
来源:dsh CLI README、npm - @deepseek-ai/dsh、DeepSeek Harness 桌面端 README
常见问题
核心差别是「装没装到系统」与「谁提供运行时」:npx 免安装直跑、每次拉最新版;npm install -g 把 dsh 装进全局 PATH 长期常驻;桌面应用是自带 Node、pnpm、Python 运行时的独立客户端。 三者的启动入口、更新方式与对系统的改动都不同,选择时先看你是偶尔用还是天天用。
一次性试用选 npx:npx @deepseek-ai/dsh web 免安装直跑,不往系统里留任何东西。 它每次从 npm 拉最新版,用完即走,不用考虑版本与清理,代价是每次启动都要先下载、略慢一点。
不会污染项目,但会在系统的全局 node_modules 与 PATH 里留下一条 dsh 命令。 项目里 npm install 装的依赖与它互不影响,数据统一落在 $DSH_HOME(默认 ~/.dsh);不想留痕就用 npx,想彻底移除用 npm uninstall -g @deepseek-ai/dsh。
受限网络不要走 npx,改用离线包或内网镜像分发。 npx 与全局安装都依赖联网拉包,纯内网会拉取失败;官方另给了离线安装与内网分发路径,配合本地镜像源使用,具体步骤见离线安装指引。
npx 不用管,每次运行天然最新;全局安装一条 npm update -g @deepseek-ai/dsh;桌面端由应用自身检查更新。 装好 DeepSeek Harness 本体后,插件再走插件市场统一更新,与本体更新是两条独立的线。
相关术语
- npx(免安装运行)
- npx 是随 npm 一起提供的执行器,npx @deepseek-ai/dsh web 会临时拉取并运行 DeepSeek Harness,不写入系统 PATH,每次运行都取 npm 上的最新版本。— https://www.npmjs.com/package/@deepseek-ai/dsh
- npm install -g(全局安装)
- npm install -g @deepseek-ai/dsh 把 DeepSeek Harness 的 dsh 命令装进系统全局位置并加入 PATH,装完在任何目录都能直接调用,升级用 npm update -g @deepseek-ai/dsh。— https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/README.md
- 桌面应用(自带运行时)
- DeepSeek Harness 桌面端是包裹完整 dsh Web 应用的独立客户端,自带 Node、pnpm 与 Python 运行时,面向本机单机使用,插件落在它独占的 desktop profile。— https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/desktop/README.md
- $DSH_HOME
- $DSH_HOME 是 DeepSeek Harness 的数据根目录,默认位于 ~/.dsh,会话、设置、凭据与插件都存放在这里,与具体安装方式无关。— https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/README.md
来源
- dsh CLI README· deepseek-ai
- npm - @deepseek-ai/dsh· npm
- DeepSeek Harness 桌面端 README· deepseek-ai