deepseek-harness-desktop

DS Harness 是一个面向 Windows 的 DeepSeek Harness 桌面封装程序。它使用 Electron 启动本地 DeepSeek Harness Web 服务，并在桌面窗口中打开使用界面。

这个项目的目标是把 DeepSeek Harness 做成一个可安装、可分发的 Windows 桌面软件：用户安装后可以直接从桌面图标启动，不需要手动运行命令行。

功能特点

• Windows 桌面应用入口，软件名为 DS Harness
• 内部界面保留 DeepSeek Harness 标识
• 启动时自动运行本地 @deepseek-ai/dsh Web 服务
• 自动选择本机可用端口并加载到 Electron 窗口
• 打包时内置 Node.js 运行时，适合制作离线完整安装包
• 使用 DeepSeek 小鲸鱼图标作为应用图标和启动页视觉
• 关闭窗口时显示确认提示，避免误退出本地服务

使用方式

如果只是安装使用，请下载发布版安装包：

DS Harness Setup 0.1.0.exe

安装完成后，从桌面快捷方式或开始菜单启动 DS Harness。

开发环境

本项目需要：

• Windows
• Node.js
• npm

安装依赖：

npm install

启动开发版：

npm start

运行测试：

npm test

打包发布

生成 Windows NSIS 安装包：

npm run dist

打包完成后，安装包会生成在：

dist/DS Harness Setup 0.1.0.exe

打包脚本会先执行 scripts/prepare-node-runtime.js，把当前 Node.js 运行时复制到 vendor/node/node.exe，再由 electron-builder 打进安装包。

项目结构

assets/                     应用图标和启动页图标
scripts/                    打包前置脚本
src/main/                   Electron 主进程代码
src/renderer/               启动页 HTML
test/                       Node.js 测试
package.json                项目脚本和 electron-builder 配置
package-lock.json           依赖锁定文件

不提交到仓库的内容

以下目录和文件不会提交到 Git 仓库：

• node_modules/
• dist/
• vendor/node/
• 本地日志文件

安装包建议通过 GitHub Releases 发布，不建议直接提交到源码仓库。

注意事项

当前安装包没有正式代码签名证书。Windows 可能会显示未知发布者或 SmartScreen 提示，这不影响程序运行，但如果要公开分发，建议后续增加代码签名。

离线完整安装包会包含 Electron、DeepSeek Harness 依赖和 Node.js 运行时，因此安装包体积和安装耗时都会比普通小工具更大。

图标来源

DeepSeek 图标资产来自 Wikimedia Commons 的 DeepSeek-icon.svg，页面标注来源为 chat.deepseek.com，许可为 MIT/Expat。