DeepSeek Harness 启动命令详解：3 种方式从零跑通 Web UI

DeepSeek Harness（简称 dsh） 是 DeepSeek 开源的 Agent 运行框架，基于“一切皆插件”的理念设计。它把模型、工具、会话、沙箱、UI 等都做成可替换的插件，开发者可以自由组装出自己的 Agent。

简单说，Harness 不是开箱即用的成品 Agent，而是一套可复用的 Agent 底层能力——会话管理、工具调用、记忆与沙箱隔离都以插件形式提供，按需启用。它通过本地 Web UI 运行，在浏览器里配置好模型与插件即可开始使用。

以下是 3 种启动方式，按推荐度排序。

一、npx 一键启动（最推荐）

这是官方推荐的最快方式，无需克隆代码、无需安装额外工具，适合绝大多数用户。

前置条件：安装 Node.js 22.19.0 或更新版本（推荐 24+）。

在终端（Windows 用 CMD 或 PowerShell，Mac 用 Terminal）中直接运行：

npx @deepseek-ai/dsh web

左下角搜索框输入cmd：

输入命令：

首次运行会自动下载依赖，启动后终端会打印 Web UI 地址，默认为 http://127.0.0.1:3080。本机启动时还会自动用默认浏览器打开页面。成功后，在浏览器中打开该地址即可进入 DeepSeek Harness 的 Web 界面。

提升启动速度：可先全局安装，之后直接用 dsh web 启动，不用再敲一长串 npx 命令：

npm install -g @deepseek-ai/dsh
dsh web

注意：npx 启动后，不能关闭终端窗口，否则服务会停止。

二、从源码运行（适合开发者）

如需修改源码或深度定制，可从 GitHub 克隆仓库自行构建。

前置条件：Node.js 22.19.0+ 和 pnpm 11+。

# 克隆仓库（国内网络慢可用代理加速）
git clone https://github​.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

# 安装依赖并构建
pnpm install
pnpm run build

# 启动 Web UI
pnpm dsh web

运行完毕后，终端会打印端口地址，默认 http://127.0.0.1:3080。pnpm run build 会准备仓库产物，之后 pnpm dsh web 会直接使用已构建产物，不会重新构建。

三、桌面应用（无需命令行）

如果不想碰命令行，社区已开发了桌面端应用，可像安装普通软件一样双击安装。

特点：

• 自动启动和管理本地 Harness 服务
• 集成系统托盘与桌面窗口
• 无需安装 Node.js 或执行命令

下载地址：GitHub Releases（搜索 deepseek-harness-desktop）。Windows 下载 DSH-Desktop-2.0.0-x64-Setup-public.exe，macOS（Apple 芯片）下载 DSH Desktop-2.0.0-arm64-public.dmg。

四、首次启动后的配置

无论用哪种方式启动，首次进入 Web UI 后还需要完成以下配置才能开始对话。

1. 配置 API Key

进入 Settings → Models，填入 DeepSeek API Key（以 sk- 开头）并保存。模型路由保存后立即可用，无需重启服务。API Key 需从 DeepSeek 开放平台（platform.deepseek.com）获取。

2. 选择工作区

点击 Choose workspace，添加并选择一个工作目录。工作区可以让 Harness 访问指定文件夹内的文件。

配置完成后，即可在主界面创建会话，向 AI 下达指令。

五、总结

DeepSeek Harness 的 3 种启动方式对比如下：

启动方式	命令	适合人群	特点
npx 一键启动	npx @deepseek-ai/dsh web	绝大多数用户	最快，无需克隆代码
源码运行	pnpm dsh web	开发者	可深度定制、修改源码
桌面应用	双击安装包	不想用命令行的用户	无需 Node.js，图形界面

DeepSeek Harness 目前仍处于开发者预览阶段，正在快速迭代，未来可能出现破坏兼容性的变更。建议优先使用 npx 一键启动方式快速体验，如需深度定制再考虑源码构建或桌面应用。