deepseek-harness-desktop

DeepSeek Harness 桌面版

把 DeepSeek Harness 变成双击即用的 Windows 桌面软件。

无需安装 Node.js · 无需命令行 · 无需打开浏览器

English · 最新版本 · 上游项目

[!NOTE] 本项目是独立的社区桌面封装，并非 DeepSeek 官方发布。DeepSeek Harness 本体是 DeepSeek AI 开发的开源项目。

项目简介

DeepSeek Harness 桌面版使用 Electron 将官方 Web UI 封装到独立窗口，并内置 Node.js 运行环境。普通 Windows 用户不需要安装开发工具，不需要敲命令，安装后即可像普通桌面软件一样使用。

• Windows 一键安装，免管理员权限
• 独立桌面窗口，无需浏览器
• 内置 Node.js 运行时及所需依赖
• 自动创建桌面和开始菜单快捷方式
• 本地服务只监听 127.0.0.1，并自动使用空闲端口
• 关闭和卸载时自动清理后台进程
• 会话、配置和日志保存在 %APPDATA%\DeepSeekHarness

软件截图

启动画面

首次配置 API Key

工作区

一键下载与安装

1. 下载 DeepSeekHarness-Setup-1.0.0.exe。
2. 双击安装，无需管理员权限。
3. 如果出现 Windows SmartScreen，点击 “更多信息”→“仍要运行”。1.0.0 版本尚未购买代码签名证书。
4. 等待程序自动启动；首次启动初始化本地服务可能需要 10–30 秒。
5. 按提示填写你自己的 DeepSeek API Key。

安装包 SHA-256 见 SHA256SUMS.txt，GitHub Release 中也会同时提供校验文件。

从源码构建

环境要求：Windows 10/11、Node.js 18 或更高版本、npm、PowerShell。

git clone https://github.com/kalimustafa/deepseek-harness-desktop.git
cd deepseek-harness-desktop
.\build-exe.ps1

构建脚本会安装锁定版本的依赖、复制本机 Node 可执行文件作为内置运行时、清理其他平台的二进制文件，然后生成：

release\DeepSeekHarness-Setup-1.0.0.exe

中国大陆网络环境可启用 npm 和 Electron 镜像：

$env:DSH_USE_CHINA_MIRRORS = "1"
.\build-exe.ps1

开发运行

npm ci
npm start

构建后可执行安装、启动冒烟测试和卸载测试：

.\scripts\e2e-test.ps1

数据与隐私

• 调用模型需要联网。
• 本仓库和安装包不包含你的 API Key。
• 本地数据保存在 %APPDATA%\DeepSeekHarness。
• 内置 Web 服务仅监听本机回环地址，不向局域网开放。

许可证与致谢

本仓库的桌面封装源码采用 MIT License。DeepSeek Harness 是独立的上游 MIT 开源项目，其代码及打包依赖仍分别遵循各自许可证。详见 第三方声明。