DeepSeek Harness 下载安装(DSH 安装 · DSH 下载):npx、npm 全局、源码构建怎么选?

安装与快速上手发布于 2026-09-02作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH下载安装npxnpm
DeepSeek Harness(DSH)官方下载渠道只有两处:npm 的 @deepseek-ai/dsh 与 GitHub 的 deepseek-ai/deepseek-harness。三选一:npx 一键运行、npm 全局安装、源码构建;装完用 npm view 核对后访问 127.0.0.1:3080 验证。

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 开头(来源)。

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

  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. 官网与文档只给命令,不给安装包:官网 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 的地方拿代码。

安装方式怎么选: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 webnpx @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 插件市场 里挑:官方收录、一键安装与卸载,装每个插件前有确认弹窗,装完还有系统日志可查,踩坑了也看得见。

插件市场

常见问题

DeepSeek Harness 从哪里下载?官网有没有安装包下载链接?

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 与源码构建怎么选?

快速体验用 npx @deepseek-ai/dsh web,临时拉取最新包、不占全局;日常使用用 npm install -g @deepseek-ai/dsh,装出 dsh 命令直接调用;改代码或做贡献从 GitHub 克隆源码构建。三种方式装完都通过浏览器访问 http://127.0.0.1:3080 使用 Web UI。

怎么确认下载到的是 DeepSeek Harness 官方最新版?

用 npm view @deepseek-ai/dsh version 直接查询 npm 上该包的最新版本号,再与 npx 运行时打印的版本或 npm ls -g @deepseek-ai/dsh 的输出比对。npm 上的 @deepseek-ai/dsh 只由官方发布,认准包名就不会装上第三方站点伪造的版本。

安装 DeepSeek Harness 需要什么环境?Windows 和 macOS 能装吗?

安装 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 官方文档

来源