DeepSeek Harness 下载安装（DSH 安装 · DSH 下载）：npx、npm 全局、源码构建怎么选？

DeepSeek Harness（DSH）有两条官方获取路径：要图形界面就下官网的桌面端安装包（macOS .dmg / Windows .exe），要走命令行就用 npm 上的 @deepseek-ai/dsh 或 GitHub 上的 deepseek-ai/deepseek-harness 源码仓库；它没有第三方「下载站」，凡是让你从别处下载安装包的页面都别信。

这篇讲的是命令行版本的下载安装。DSH 命令行版没有传统意义上的「点一下下载」安装包，所谓「下载」其实是让 npm 把官方发布包拉到你本机；需要桌面端请直接看《DeepSeek Harness 桌面端怎么下载安装》。下面先把命令行版的两条官方渠道认清楚，再按你的用途选安装方式。

DeepSeek Harness 官方下载渠道：npm 包与 GitHub 源码

DeepSeek Harness 命令行版的官方下载渠道只有两处：npm 注册表上的 @deepseek-ai/dsh，和 GitHub 上的 deepseek-ai/deepseek-harness 官方仓库；官网与官方文档里给的运行命令，都以 @deepseek-ai/dsh 开头（来源）。

下载前先核对下面四步，确认自己在官方渠道上：

1. npm 渠道认包名：官方发布包名固定为 @deepseek-ai/dsh，包主页在 https://www.npmjs.com/package/@deepseek-ai/dsh；npm 上其他名字带 dsh 的包多是社区插件，DSH 本体只认这一个（来源）。
2. GitHub 认官方组织：官方仓库地址为 deepseek-ai/deepseek-harness，所属组织 deepseek-ai 是 DeepSeek AI 的官方 GitHub 账号，clone 时核对这个组织名（来源）。
3. 认准桌面端的官方下载域名：桌面端安装包的官方域名是 download.deepseek.com，下载页在 https://www.deepseek.com/download/，官网 https://www.deepseek.com/harness/ 的「下载桌面端」按钮也指向它；命令行侧官方文档 https://deepseek-harness.github.io/deepseek-harness/guide/quickstart 给的仍是 npx @deepseek-ai/dsh web 这类命令（来源）。
4. 见到第三方下载站直接跳过：搜索结果里「DeepSeek Harness 下载站」「汉化版」「破解版」这类页面都不是官方分发点，DSH 是开源的，官方没有理由让你从非 npm、非 GitHub、非 download.deepseek.com 的地方拿安装包。

安装方式怎么选：npx 一键运行、npm 全局安装、源码构建

安装 DeepSeek Harness 只有三种方式：npx 一键运行适合快速体验、npm 全局安装适合日常使用、源码构建适合改代码，前置都只需要 Node.js 18 及以上。

先准备运行环境：

1. 安装 Node.js 18 或更高版本：到官网 https://nodejs.org 下载 LTS 版安装包，按默认选项装完，或用 nvm 安装；
2. 重开一个终端窗口，执行 node -v，输出 v18 或更高即就绪；
3. 再执行 npm -v，能输出 npm 版本号说明包管理器可用（npx 随 npm 一起安装）。

方式一：npx 一键运行（最快，适合临时体验）

1. 终端执行 npx @deepseek-ai/dsh web；
2. 首次运行会从 npm 拉取最新发布包，之后每次运行都会检查最新版；
3. 启动完成后浏览器打开 http://127.0.0.1:3080，看到 Web UI 即成功（来源）。

npx 方式不写进系统 PATH，不占全局位置，试完即走。

方式二：npm 全局安装（适合天天用）

1. 终端执行 npm install -g @deepseek-ai/dsh，等安装完成退出；
2. 执行 dsh --help，能看到启动器用法说明即安装成功；
3. 若提示 command not found（Windows 提示「不是内部或外部命令」）：说明 npm 全局 bin 目录不在 PATH，先执行 npm prefix -g 查出目录，macOS/Linux 运行 export PATH="$(npm prefix -g)/bin:$PATH" 再重试当前终端；Windows 重开一个终端即可（安装 Node.js 时已把全局目录加进 PATH）；
4. 之后直接用 dsh web 启动，Web UI 同样在 http://127.0.0.1:3080；
5. 升级用 npm update -g @deepseek-ai/dsh，卸载用 npm uninstall -g @deepseek-ai/dsh（来源）。

方式三：源码构建（适合改代码、做贡献）

1. 先确认已装 Git 与 pnpm：没有 pnpm 就执行 npm install -g pnpm，再用 pnpm -v 验证；
2. 执行 git clone https://github.com/deepseek-ai/deepseek-harness.git；
3. 进入目录并装依赖：cd deepseek-harness && pnpm install；
4. 构建产物：pnpm run build（生产运行必须先构建）；
5. 启动：pnpm dsh web，浏览器访问 http://127.0.0.1:3080（[来源](https://github.com/deepseek-ai/deepseek-harness)）。

一句话怎么选：想先看看 DSH 长什么样，用 npx；确定要长期用、想直接敲 dsh 命令，用 npm 全局安装；要调试或改内核代码，走源码构建。

装完怎么验证：版本号与 3080 端口

验证 DeepSeek Harness 装没装对就两步：用 npm view @deepseek-ai/dsh version 核对官方最新版本号，再用浏览器打开 http://127.0.0.1:3080 确认 Web UI 能访问。

1. 执行 npm view @deepseek-ai/dsh version，npm 会返回官方最新版本号（不装包也能查）；
2. 全局安装后用 npm ls -g @deepseek-ai/dsh 查看本机实际装的版本，两者一致说明拿到的是官方最新；
3. 启动 dsh web 或 npx @deepseek-ai/dsh web 后，浏览器访问 http://127.0.0.1:3080，页面能打开即安装成功；
4. 若浏览器打不开 3080，多数是端口被占用或 Node.js 版本过低，先检查 node -v 是否 ≥ v18。

装完 DSH 之后：配模型、装插件，留意开发者预览状态

装好 DeepSeek Harness 后，下一步是打开 Web UI 的「设置 → 模型」填入模型密钥，再按需安装插件；DSH 目前是开发者预览版本，升级前留意破坏性变更（来源）。

1. 启动后在 Web UI 中进入「设置 → 模型」，填入模型 API 密钥保存，模型路由立即生效；
2. 插件通过 dsh plugin --profile web add <包名或仓库地址> 安装，装完重启 dsh web 生效，完整步骤见《DSH plugin 怎么安装》；
3. 关注官方仓库的更新说明：DSH 处于开发者预览阶段，版本迭代可能引入不兼容变更，升级 DSH 本体前先看 Release 与文档。

装好 DSH 之后，与其在第三方下载站里碰运气，不如到社区维护的 DSH Plugin Hub 插件市场 里挑：官方收录、一键安装与卸载，装每个插件前有确认弹窗，装完还有系统日志可查，踩坑了也看得见。