🐋 Whalecode

August 14, 2026 · View on GitHub

基于 Electron 的 DeepSeek Harness WebUI 桌面壳。

一键启动、自动托管 dsh web 服务,把浏览器里的 AI 开发工作台装进原生窗口,并支持自动更新。

✨ 特性

一键启动:自动探测 127.0.0.1:3080 端口 —— 已有服务直接复用,否则以隐藏子进程拉起 dsh web 并托管其生命周期(关闭窗口即停止自管服务)。
原生窗口:1280×840 自适应窗口、单实例锁、外链自动跳转系统浏览器、窗口图标为 DeepSeek 官方蓝鲸。
自动更新:基于 electron-updater(generic 源),启动时自动检查、后台下载、弹窗确认安装;支持差分更新。
两种分发形态:
- 便携版(Portable exe)—— 免安装,双击即用;
- 安装版(NSIS Setup)—— 开始菜单集成,支持自动更新。
可配置:全部行为支持环境变量覆盖(端口 / 仓库路径 / node 路径 / 更新源等),详见下表。

🚀 快速开始

直接使用(推荐)

到 Releases 下载:

文件	说明
`DeepSeek Harness-Portable-x.x.x.exe`	便携版,免安装,双击即用
`DeepSeek Harness-Setup-x.x.x.exe`	安装版,安装后支持自动更新

桌面端是 WebUI 的壳:运行前需要本机已有 DeepSeek Harness 代码库 (仓库路径解析见下文"仓库定位")。

从源码运行

npm install        # 安装 Electron 等依赖
npm start          # 启动桌面端
npm run dist       # 打包 portable + nsis 到 dist/

📦 目录结构

whalecode/
├── main.js            # Electron 主进程:服务托管 + 窗口 + 自动更新
├── package.json       # 依赖与 electron-builder 打包配置
├── update-server.js   # 本地更新源静态服务器(测试/自托管更新用)
├── start-dsh.ps1      # 一键启动脚本(浏览器路径,Windows PowerShell)
├── assets/            # 图标资源(官方蓝鲸 + 艺术版小鲸鱼)
├── build/             # 打包用多尺寸 ICO
└── dist/              # 构建产物(便携版 / 安装版 / latest.yml,发布到 Releases)

🔧 环境变量

变量	默认值	说明
`DSH_PORT`	`3080`	WebUI 服务端口
`DSH_REPO`	见"仓库定位"	DeepSeek Harness 代码库路径
`DSH_NODE`	`node`	Node.js 可执行文件路径
`DSH_UPDATE_URL`	打包内置地址	自动更新源(generic provider)
`DSH_AUTO_INSTALL`	关闭	`1` 时下载完成后免确认安装
`DSH_DEVTOOLS`	关闭	`1` 时启动时打开 DevTools

仓库定位(优先级)

DSH_REPO 环境变量;
可执行文件同目录下的 dsh-repo.txt(内容为仓库路径);
打包版本默认 E:\deepseek-harness。

🔄 自动更新发布流程

修改 package.json 中的 version;
执行 npm run dist 重新打包;
将 dist/ 下的 DeepSeek Harness-Setup-<ver>.exe、<ver>.exe.blockmap、latest.yml 上传到任意静态文件服务器(需支持 HTTP Range 请求,如 nginx);
客户端启动时自动检查更新,下载完成后弹窗询问"立即重启 / 稍后"。

本地验证:

node update-server.js 8765          # 启动本地更新源(支持 Range)
# 以 DSH_UPDATE_URL=http://127.0.0.1:8765/ 启动已安装版本
# 升级日志: %APPDATA%\DeepSeek Harness\updater.log

便携版无法自更新(可执行文件无法替换自身),自动更新仅适用于安装版。

🎨 图标

assets/whale.png / assets/whale-official.ico —— DeepSeek 官方蓝鲸(取自 deepseek.com 官网 favicon),用作应用窗口图标;
assets/icon-art.png / build/icon-art.ico —— 艺术版小鲸鱼:以官方蓝鲸为原型绘制的渐变圆角图标(白色鲸鱼 + 喷水柱 + 气泡 + 星光点缀),用作桌面快捷方式图标。

📚 来源与参考仓库

本项目是 DeepSeek Harness 的桌面端壳,服务端与 WebUI 完全来自上游仓库:

项目	仓库	用途
DeepSeek Harness	https://github.com/deepseek-ai/deepseek-harness	服务端 + WebUI(本壳所承载的应用本体)
Electron	https://github.com/electron/electron	桌面运行时框架
electron-builder	https://github.com/electron-userland/electron-builder	打包(portable / NSIS)与发布配置
electron-updater	https://github.com/electron-userland/electron-builder	自动更新(随 electron-builder 一起维护)
DeepSeek 官方品牌图标	https://www.deepseek.com	蓝鲸图标来源(版权归 DeepSeek 所有,仅作个人使用)

架构参考了"本地服务 + 桌面壳"的经典模式(如 VS Code 等 IDE 对内置服务的托管方式): 启动时探测端口,存在则复用、不存在则拉起并托管,关窗即停。

⚠️ 说明

本项目非 DeepSeek 官方项目,与 DeepSeek 无隶属关系;蓝鲸商标与图标的版权归 DeepSeek 所有。
打包产物未签名,Windows SmartScreen 可能提示"未知发布者",选择"仍要运行"即可。
遵循上游 DeepSeek Harness 的许可证条款;本仓库代码按上游许可证分发。