DeepSeek Harness 下载安装(DSH 安装 · DSH 下载):npx、npm 全局、源码构建怎么选?
DeepSeek Harness(DSH)的官方下载渠道只有两处:npm 上的 @deepseek-ai/dsh 发布包,和 GitHub 上的 deepseek-ai/deepseek-harness 源码仓库;它没有第三方「下载站」,凡是让你从别处下载安装包的页面都别信。
DSH 是命令行工具,所谓「下载」其实是让 npm 把官方发布包拉到你本机,不存在传统意义上的安装包下载。下面先把官方渠道认清楚,再按你的用途选安装方式。
DeepSeek Harness 官方下载渠道:npm 包与 GitHub 源码
DeepSeek Harness 的官方下载渠道只有两处:npm 注册表上的 @deepseek-ai/dsh,和 GitHub 上的 deepseek-ai/deepseek-harness 官方仓库;官网与官方文档里给的运行命令,都以 @deepseek-ai/dsh 开头(来源)。
下载前先核对下面四步,确认自己在官方渠道上:
- npm 渠道认包名:官方发布包名固定为
@deepseek-ai/dsh,包主页在 https://www.npmjs.com/package/@deepseek-ai/dsh;npm 上其他名字带dsh的包多是社区插件,DSH 本体只认这一个(来源)。 - GitHub 认官方组织:官方仓库地址为
deepseek-ai/deepseek-harness,所属组织deepseek-ai是 DeepSeek AI 的官方 GitHub 账号,clone 时核对这个组织名(来源)。 - 官网与文档只给命令,不给安装包:官网 https://www.deepseek.com/harness/ 和官方文档 https://deepseek-harness.github.io/deepseek-harness/guide/quickstart 提供的都是
npx @deepseek-ai/dsh web这类命令,不存在「点一下下载」的入口(来源)。 - 见到第三方下载站直接跳过:搜索结果里「DeepSeek Harness 下载站」「汉化版」「破解版」这类页面都不是官方分发点,DSH 是开源的,官方没有理由让你从非 npm、非 GitHub 的地方拿代码。
安装方式怎么选:npx 一键运行、npm 全局安装、源码构建
安装 DeepSeek Harness 只有三种方式:npx 一键运行适合快速体验、npm 全局安装适合日常使用、源码构建适合改代码,前置都只需要 Node.js 18 及以上。
先准备运行环境:
- 安装 Node.js 18 或更高版本:到官网 https://nodejs.org 下载 LTS 版安装包,按默认选项装完,或用 nvm 安装;
- 重开一个终端窗口,执行
node -v,输出 v18 或更高即就绪; - 再执行
npm -v,能输出 npm 版本号说明包管理器可用(npx 随 npm 一起安装)。
方式一:npx 一键运行(最快,适合临时体验)
- 终端执行
npx @deepseek-ai/dsh web; - 首次运行会从 npm 拉取最新发布包,之后每次运行都会检查最新版;
- 启动完成后浏览器打开 http://127.0.0.1:3080,看到 Web UI 即成功(来源)。
npx 方式不写进系统 PATH,不占全局位置,试完即走。
方式二:npm 全局安装(适合天天用)
- 终端执行
npm install -g @deepseek-ai/dsh,等安装完成退出; - 执行
dsh --help,能看到启动器用法说明即安装成功; - 若提示
command not found(Windows 提示「不是内部或外部命令」):说明 npm 全局 bin 目录不在 PATH,先执行npm prefix -g查出目录,macOS/Linux 运行export PATH="$(npm prefix -g)/bin:$PATH"再重试当前终端;Windows 重开一个终端即可(安装 Node.js 时已把全局目录加进 PATH); - 之后直接用
dsh web启动,Web UI 同样在 http://127.0.0.1:3080; - 升级用
npm update -g @deepseek-ai/dsh,卸载用npm uninstall -g @deepseek-ai/dsh(来源)。
方式三:源码构建(适合改代码、做贡献)
- 先确认已装 Git 与 pnpm:没有 pnpm 就执行
npm install -g pnpm,再用pnpm -v验证; - 执行
git clone https://github.com/deepseek-ai/deepseek-harness.git; - 进入目录并装依赖:
cd deepseek-harness && pnpm install; - 构建产物:
pnpm run build(生产运行必须先构建); - 启动:
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 能访问。
- 执行
npm view @deepseek-ai/dsh version,npm 会返回官方最新版本号(不装包也能查); - 全局安装后用
npm ls -g @deepseek-ai/dsh查看本机实际装的版本,两者一致说明拿到的是官方最新; - 启动
dsh web或npx @deepseek-ai/dsh web后,浏览器访问 http://127.0.0.1:3080,页面能打开即安装成功; - 若浏览器打不开 3080,多数是端口被占用或 Node.js 版本过低,先检查
node -v是否 ≥ v18。
装完 DSH 之后:配模型、装插件,留意开发者预览状态
装好 DeepSeek Harness 后,下一步是打开 Web UI 的「设置 → 模型」填入模型密钥,再按需安装插件;DSH 目前是开发者预览版本,升级前留意破坏性变更(来源)。
- 启动后在 Web UI 中进入「设置 → 模型」,填入模型 API 密钥保存,模型路由立即生效;
- 插件通过
dsh plugin --profile web add <包名或仓库地址>安装,装完重启dsh web生效,完整步骤见《DSH plugin 怎么安装》; - 关注官方仓库的更新说明:DSH 处于开发者预览阶段,版本迭代可能引入不兼容变更,升级 DSH 本体前先看 Release 与文档。
装好 DSH 之后,与其在第三方下载站里碰运气,不如到社区维护的 DSH Plugin Hub 插件市场 里挑:官方收录、一键安装与卸载,装每个插件前有确认弹窗,装完还有系统日志可查,踩坑了也看得见。

常见问题
DeepSeek Harness 没有 exe 或 dmg 式的安装包,官方通过 npm 与 GitHub 两条渠道分发:npm 上的 @deepseek-ai/dsh 是唯一官方发布包,源码在 deepseek-ai/deepseek-harness 官方仓库。官网 www.deepseek.com/harness 与官方文档给出的运行命令都以 @deepseek-ai/dsh 开头,其余自称官方下载站的第三方页面都不是官方渠道。
快速体验用 npx @deepseek-ai/dsh web,临时拉取最新包、不占全局;日常使用用 npm install -g @deepseek-ai/dsh,装出 dsh 命令直接调用;改代码或做贡献从 GitHub 克隆源码构建。三种方式装完都通过浏览器访问 http://127.0.0.1:3080 使用 Web UI。
用 npm view @deepseek-ai/dsh version 直接查询 npm 上该包的最新版本号,再与 npx 运行时打印的版本或 npm ls -g @deepseek-ai/dsh 的输出比对。npm 上的 @deepseek-ai/dsh 只由官方发布,认准包名就不会装上第三方站点伪造的版本。
安装 DeepSeek Harness 需要 Node.js 18 及以上,Windows、macOS、Linux 都支持,命令基本通用。源码构建方式额外需要 Git 与 pnpm。
相关术语
- DeepSeek Harness(DSH)
- DeepSeek Harness(DSH)是 DeepSeek AI 开源的智能体框架,命令行工具为 dsh,采用「一切皆插件」架构,由 Cordis 驱动。它当前处于开发者预览阶段,迭代快、会有破坏性兼容变更。— deepseek-ai/deepseek-harness README
- @deepseek-ai/dsh
- @deepseek-ai/dsh 是 DeepSeek Harness 在 npm 官方注册表上发布的唯一官方包名,npx @deepseek-ai/dsh web 即从 npm 拉取该包并启动 Web UI。— @deepseek-ai/dsh - npm
- dsh 命令
- dsh 是 DeepSeek Harness 的命令行启动器,通过 profile(默认内置 web)组织插件层,dsh web 等价于 dsh --profile web。dsh plugin 子命令用于管理 profile 内的插件。— dsh CLI README
- npx
- npx 是 npm 自带的包执行工具,临时下载并运行包而不写入全局环境,适合体验 @deepseek-ai/dsh 这类不定期更新的命令行工具。— npm 官方文档
来源
- deepseek-ai/deepseek-harness· GitHub
- DeepSeek Harness 官方文档 - Quickstart· deepseek-harness
- dsh CLI README· deepseek-ai
- @deepseek-ai/dsh - npm· npm