DeepSeek Harness Desktop

August 14, 2026 · View on GitHub

一个面向 Windows 的非官方 DeepSeek Harness 桌面封装：应用启动后会在本机运行 DeepSeek Harness WebUI，并在 Electron 窗口中打开 http://127.0.0.1:3080。

本项目是社区打包版本，并非 DeepSeek 官方桌面客户端。DeepSeek Harness 上游项目请访问 deepseek-ai/DeepSeek-Harness。

下载

请前往 Releases 下载：

  • DeepSeek-Harness-Setup-0.1.0-x64.exe：安装版，可选择安装目录，并创建桌面/开始菜单快捷方式。
  • DeepSeek-Harness-Portable-0.1.0-x64.exe：便携版，无需安装，双击即可运行。
  • SHA256.txt：发布文件的 SHA-256 校验值。
  • DeepSeek-Harness-Desktop-README.txt：简明使用说明。

系统要求：Windows 10/11 x64。发布包已包含运行所需的 Node.js 和 Harness 依赖，普通用户无需另装 Node.js。

主要特性

  • 默认只监听本机地址 127.0.0.1:3080。
  • 如果 3080 端口已有 Harness 服务，会直接复用，不会重复启动或结束该进程。
  • 如果端口空闲，会自动启动随应用打包的 @deepseek-ai/dsh 后端。
  • 仅关闭由桌面应用自身启动的后端进程。
  • 外部链接交给系统默认浏览器打开。
  • Electron 窗口启用 contextIsolation 和沙箱，并关闭页面的 Node.js 集成。

使用方法

安装版

  1. 下载并运行 DeepSeek-Harness-Setup-0.1.0-x64.exe。
  2. 按安装向导选择目录并完成安装。
  3. 从桌面或开始菜单启动 DeepSeek Harness。

便携版

直接运行 DeepSeek-Harness-Portable-0.1.0-x64.exe。首次启动需要先自解压，较慢的硬盘上可能需要几分钟。

当前发布包没有代码签名；Windows SmartScreen 可能显示“未知发布者”。请从本仓库 Release 下载，并使用 SHA256.txt 核对文件完整性。

从源码运行

需要：

  • Node.js 24.x（建议使用当前 LTS）
  • npm
  • Windows 10/11 x64
git clone https://github.com/TMLX1453/DeepSeek-Harness-Desktop.git
cd DeepSeek-Harness-Desktop
npm install
npm start

开发模式会直接使用 node_modules 中的 Harness 依赖。

构建 Windows 发布包

先准备独立运行时，再执行 electron-builder：

npm install
powershell -ExecutionPolicy Bypass -File .\scripts\prepare-runtime.ps1 -Force
npm run dist

生成结果位于 dist/。构建时会将当前 node.exe 和生产用 Harness 依赖复制到安装包中，因此发布后的应用无需依赖用户机器上的 Node.js。

当前版本主要依赖：

  • DeepSeek Harness (@deepseek-ai/dsh) 0.1.0-rc.6
  • Electron 37.x
  • electron-builder 26.x

故障排查

一直停留在启动界面

便携版首次自解压可能较慢，请先等待几分钟。如果仍无响应：

  1. 在任务管理器中结束残留的 DeepSeek Harness 进程后重试。
  2. 检查 3080 端口是否被其他程序占用：Get-NetTCPConnection -LocalPort 3080。
  3. 查看 Electron 用户数据目录下 logs\harness.log 中的后端日志。

端口冲突

应用默认使用 3080。开发调试时可通过环境变量改端口：

$env:DSH_DESKTOP_PORT = '3186'
npm start

校验下载文件

Get-FileHash .\DeepSeek-Harness-Setup-0.1.0-x64.exe -Algorithm SHA256
Get-FileHash .\DeepSeek-Harness-Portable-0.1.0-x64.exe -Algorithm SHA256

将输出与 Release 中的 SHA256.txt 对照。

许可证与归属

桌面封装源码沿用项目中各依赖自身的许可证。DeepSeek Harness、Electron、Node.js 及其依赖的名称和版权归各自权利人所有。发布包内包含第三方运行时，仅用于提供桌面启动体验。