DeepSeek Harness（DSH）完整安装+桌面启动器免命令行方案

一、前言

DeepSeek Harness（简称DSH）是DeepSeek推出的开发者Agent测试工具，主打一切皆插件架构，支持模型、工具、Agent自定义组合调试，可本地Web界面可视化操作。本文基于Windows系统，提供两种使用方案：

1. 原生npx网页版（官方一键启动，适合临时测试）
2. dsh-launcher桌面启动器（无需每次敲命令，长期使用推荐）

二、前置环境：安装Node.js & npm

DSH依赖Node.js运行环境，必须先安装，推荐v24版本。

1. 验证本机是否已安装

按下Win+R输入cmd打开命令提示符，依次执行两条命令：

node -v
npm -v

文档实测成功输出示例：

C:\Users\wang.zhip>node -v
v24.19.0
C:\Users\wang.zhip>npm -v
11.17.0

• 输出版本号 → 环境就绪，直接跳转第三步
• 提示“不是内部命令” → 前往Node.js官网下载LTS稳定版，安装时勾选Add to PATH自动配置环境变量，安装完成重启cmd再验证。

三、方案一：官方网页版一键安装启动（原生npx）

步骤1：复制官方启动命令

打开DeepSeek Harness官网：https://www.deepseek.com/harness/
页面右侧复制一键启动指令：

npx @deepseek-ai/dsh web

步骤2：cmd执行启动命令

在任意目录cmd中粘贴运行，流程如下：

1. 执行命令后终端提示需要安装依赖包@deepseek-ai/dsh 0.1.0-rc.6，输入y确认下载；
2. 出现npm过时警告deprecated node-domexception可忽略，不影响运行；
3. 下载完成自动启动本地服务，输出访问地址：http://127.0.0.1:3080；

C:\Users\wang.zhip>npx @deepseek-ai/dsh web
Need to install the following packages:
@deepseek-ai/dsh@0.1.0-rc.6
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
Ok to proceed?(y)y
web:http://127.0.0.1:3080

步骤3：浏览器访问Web后台

复制地址http://127.0.0.1:3080打开浏览器进入DSH可视化面板。

步骤4：配置DeepSeek API密钥（核心，不配置无法使用模型）

1. 点击右上角设置 → 左侧选择【模型】；
2. 选中DeepSeek提供商，点击【编辑】；
3. 填入DeepSeek官方API密钥，点击【保存】；
   

API密钥获取教程

1. 访问DeepSeek开放平台：https://platform.deepseek.com/，手机号/微信登录；
2. 左侧菜单栏找到API Keys，点击【创建API Key】；
3. 自定义名称，生成后立刻复制保存（密钥仅展示一次，丢失无法找回）；
4. 新用户赠送免费测试额度，额度耗尽后可充值使用。

步骤5：选择工作目录并测试

保存API配置后，选择本地项目文件夹作为工作目录，即可调用DeepSeek模型、插件、Agent功能调试。

重要提醒：网页版每次使用都必须重新打开cmd执行启动命令，关闭终端窗口即停止服务。

四、方案二：dsh-launcher桌面启动器（免命令行，长期使用首选）

网页版每次启动都要敲终端命令，操作繁琐，社区开源dsh-launcher桌面工具可一键启动，无需重复执行npx。

1. 下载地址

GitHub开源仓库：https://github.com/Ruler4396/dsh-launcher

1. 进入仓库页面，点击右侧Releases；
2. 下载Windows对应安装包msi，双击完成安装；
   

2. 使用优势

1. 双击桌面图标自动启动DSH本地服务，自动弹出浏览器后台；
2. 内置进程管理，关闭程序自动销毁3080端口服务；
3. 无需重复输入npx启动命令，适合日常高频调试。

五、常见问题排错

1. npx下载依赖超时/失败
   切换npm淘宝镜像，cmd执行：

   npm config set registry https://registry.npmmirror.com
   

2. 访问127.0.0.1:3080打不开页面
   • 检查cmd终端是否关闭（关闭终端服务直接停止）；
   • 3080端口被占用：关闭占用端口软件，或修改DSH启动端口参数；
3. API密钥保存后模型调用失败
   • 核对密钥复制完整，无多余空格；
   • 登录DeepSeek平台查看账户额度是否耗尽；
   • 重启DSH服务重新加载配置。
4. Node版本过低报错
   卸载旧版Node，安装v22及以上版本，推荐v24稳定版。
5. 更新.net
   要下载更新windowsdesktop-runtime-10.0.11-win-x64.exe，才能安装桌面版

六、总结

1. 临时测试、偶尔使用：选官方npx网页版，无需额外安装软件，一条命令启动；
2. 日常开发、频繁调试Agent：选dsh-launcher桌面启动器，摆脱命令行，一键启动；
3. 使用前提：必须安装Node.js环境 + DeepSeek有效API Key，二者缺一不可。