DeepSeek Harness从零到一：全平台保姆级安装部署使用教程

引言

DeepSeek 于八月中旬憋了个大的，开源发布了 DeepSeek Harness，它是一个 Agent 框架，类似于 codex 和 WorkBuddy，但是又不同于它们，这源于五个字：一切皆插件！功能及 UI 都可以通过插件来实现扩展，插件 +Agent 这样的组合，会不会让人眼前一亮？

今天鼠标从零到一，全平台保姆级安装部署，以及后续的使用，包括插件安装等！

安装部署

linux 平台

安装 DeepSeek Harness 之前，我们需要装环境依赖 Node.js，官方支持版本 22.19+ 或 24+，咱们就默认安装 LTS 版本，也就是 24+，Linux 控制台依次执行以下命令，过程中可以能需要特殊网络环境：

# 下载并安装 nvm：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 代替重启 shell，使命令生效
\. "$HOME/.nvm/nvm.sh"
# 下载并安装 Node.js：nvm install 24
# 验证 Node.js 版本：node -v
# 验证 npm 版本：npm -v

验证版本可以正常返回版本号，说明我们将 Node.js 安装成功，接下来就可以安装运行 DeepSeek Harness 了，控制台输入如下命令并运行：

npx @deepseek-ai/dsh web --no-open

程序开始自动下载并安装依赖，过程根据网络环境不同，时间也长短不定，如果过程中出现这个画面报错，提示爆内存了，我们可以输入如下命令，重新运行部署：

NODE_OPTIONS="--max-old-space-size=4096" npx --yes @deepseek-ai/dsh web --no-open

当控制台出现这个段代码提示，就说明我成功部署并启动，至于如何打开 DeepSeek Harness，Linux 桌面版可以直接在浏览器中输入这个地址打开，而 DP 官方处于安全考虑，只允许绑定 127.0.0.1 这个地址，所以服务器版本的 linux，我们只能通过 SSH 隧道的方式打开 DeepSeek Harness，具体操作方法：

1. 需要打开 DeepSeek Harness 的 Winsows 电脑上，运行 PowerShell 依次执行如下命令：

   icacls "C:\Users\ShuBiao\.ssh\config" /inheritance:r /grant:r "$($env:USERNAME):(R,W)"
   ssh -N -f -L 3080:127.0.0.1:3080 用户名 @服务器 IP

   第二条命令这里输入 yes 回车确认，再输入你的服务器密码，这样我们就打通 SSH 隧道。

2. 此时，我们打开浏览器，输入这个地址，就可以访问 linux 的 DeepSeek Harness 了

Windows 平台

Windows 系统安装 DeepSeek Harness，同样需要安装环境依赖 Node.js。访问Node.js 官网，点击获取 Node.js，版本同样选择 LTS24+ 版本，这里下拉选择 Windows 64，再点击 Windows 安装程序下载安装包。

Node.js 安装包下载好后，直接双击运行安装，过程一路下一步进行安装。

1. 环境依赖安装好后，我们就可以部署 DeepSeek Harness 了。运行 PowerShell 并执行如下命令，目的是修改 PowerShell 的默认执行策略，不修改会拦截我们接下来执行安装脚本：

   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

2. 过程中弹窗提示时按 Y 回车，安装 DeepSeek Harness 前，我们还需要装下 pnpm，其插件生态都是调用 pnpm 进行安装，执行如下命令进行安装：

   npm install -g pnpm

3. 执行完毕后再执行如下命令部署 DeepSeek Harness：

   npm install -g @deepseek-ai/dsh

4. 部署过程中，可能需要特殊网络环境，同样根据网络环境不同，部署的时间也长短不定。部署完成后，会出现命令提示符，再执行如下命令，验证版本是否正常安装部署：

   dsh --version

5. 出现版本号后，再执行如下命令，运行 DeepSeek Harness，同时会自动打开浏览器：

   dsh web

以上，是 Windows 平台官方的 DeepSeek Harness 部署方法。有些人会觉得，Web 版本部署使用上，有些繁琐，没关系，你的需求，有大佬已经替你解决了！

DSH Desktop，基于 DeepSeek Harness 构建的 Windows 开源桌面客户端。访问 该项目地址，Releases 里下载最新程序包，简单安装后一键运行，无需安装依赖环境，无需繁冗部署。

macOS 平台

鼠标手头没有 mac 设备，无法演示其平台的安装过程，DeepSeek Harness 官方文档提示，安装过程大同小异，也需要先安装 Node.js，接着一套命令安装部署。当然，你感觉繁琐，刚刚介绍的 DSH Desktop 项目，也提供 mac 平台的桌面客户端，你也可以直接下载安装使用。

使用教程

初始配置

首次运行 DeepSeek Harness 会提示输入 API Key，咱们点击稍后设置，这样就进入软件主界面，操作方法啥的，没啥好说的，和其他 Agent 工具大同小异。现在开始配置 AI 模型吧，否则无法正常使用软件！依次点击设置 - 模型，如果你用的是 DeepSeek，可以直接在这里填 API Key。考虑到是保姆教程，获取 DeepSeek API Key 也演示下吧！

访问DeepSeek API 官网，左侧导航点击 API keys，右侧点击创建 API key，名称随意填写，复制 API key，回到 DeepSeek Harness 填入即可！

如果是其他模型，点击添加提供方，提供方下拉选择模型厂商，接着填入 API 密钥，最后保存。

回到 DeepSeek Harness 聊天界面，创建一个工作区，下方模型就可以选择我们填入的模型了，给它一条指令，让它干活吧！

安装插件

DeepSeek Harness 主打一切皆插件，那么，我们该如何装插件呢？就以桌面客户端为例，插件为 DSH-IM 为例进行演示！这款插件通过扫码等方式，接入微信、飞书、钉钉，以及 QQ 等，使我们更为方便的随时随地，控制电脑上 DeepSeek Harness。

先说桌面端安装方式，依次点击设置 - 打开 DSH 终端，执行如下命令：

dsh plugin --profile desktop add -w @xmanrui/dsh-im

Web 版本打开 PowerShell 执行如下命令：

dsh plugin --profile web add -w @xmanrui/dsh-im

命令执行完毕后，我们重启 DeepSeek Harness，设置 - 插件里，就可以看见我们安装的 IM 机器人了，需要对接什么平台，直接便捷的扫码就可以了！

在桌面客户端里，其实作者已经内置了插件市场，依次点击设置 - 桌面版，右侧下拉找到插件市场，默认选择的是不启用插件市场，下面两个插件市场备选，建议选择第二个，速度和适配度更好！

选中插件市场后，桌面客户端会自己重启，重启后在设置里，就可以看见插件市场了。进入插件市场，找到你需要的插件，直接点击安装，就这么简单，插件就装好了，装好的插件一般情况下，都在设置里。

总结

以上，就是本期视频全部内容，DeepSeek Harness 从全平台部署到使用的保姆教程，视频中涉及的软件及工具，都可以在鼠标博客免费下载，本期视频就到这里，我是鼠标，谢谢您的观看，感觉视频有用，点赞收藏一下吧！

资源下载