DeepSeek Harness Launcher

August 15, 2026 · View on GitHub

DeepSeek Harness 的非官方 Windows 桌面启动器。它把需要在仓库目录执行的 pnpm dsh web 包装成可双击运行的软件，并负责 Web 服务的完整生命周期。

CI Latest release

下载

从 GitHub Releases 下载 DeepSeekHarnessLauncher.exe。同一页面提供 SHA256SUMS.txt，可用于校验下载文件。

已实现功能

  • 参考 DeepSeek Harness 官方页面的深色视觉语言，采用深蓝光晕、胶囊导航和响应式卡片
  • 设置页支持滚动，在小屏幕和高 DPI 缩放下也能完整访问全部选项
  • 双击启动、停止和重启 DeepSeek Harness
  • 读取官方 readiness 输出并在 HTTP 真正可用后再打开浏览器
  • 系统默认浏览器，以及 Edge、Chrome、Firefox、Brave 和自定义 EXE
  • 首次使用时一键克隆官方仓库、安装依赖并构建
  • Node.js、pnpm、Git、仓库结构和 Web 构建产物检查
  • 系统托盘、关闭到托盘、启动成功后自动隐藏
  • 当前用户级 Windows 开机自启，无需管理员权限
  • “开机启动软件”“自动启动 Harness”“登录时打开浏览器”三个独立开关
  • 端口占用识别；不强制停止并非由启动器创建的服务
  • 实时日志、轮转日志文件和一键复制诊断信息
  • 单实例保护
  • Windows Job Object 防止启动器异常退出后遗留进程
  • Ctrl+C 优雅停止，给 Harness 留出插件卸载与会话落盘时间，超时后再清理完整进程树

出于安全原因，首版固定监听 127.0.0.1，不会把拥有本地工具执行能力的 Web UI 暴露到局域网。

直接使用

下载后双击：

DeepSeekHarnessLauncher.exe

首次打开后有两种选择：

  1. 已经克隆 Harness：在“概览”页选择 deepseek-harness 仓库目录，然后点击“安装依赖并构建”。
  2. 尚未克隆：进入“环境与安装”，点击“下载并安装 Harness…”。

准备完成后点击“启动 Harness”。默认地址为 http://127.0.0.1:3080。

启动器配置保存在：

%APPDATA%\DSHLauncher\config.json

日志保存在：

%LOCALAPPDATA%\DSHLauncher\launcher.log

从源码运行

需要 Python 3.11：

.\run-dev.ps1

也可以手动执行：

py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r .\requirements-build.txt
.\.venv\Scripts\python.exe .\launcher.py

构建 EXE

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\build.ps1

构建脚本会：

  1. 安装锁定版本的构建依赖
  2. 运行单元测试和 Windows 进程树集成测试
  3. 生成应用图标
  4. 生成单文件、无控制台窗口的 dist\DeepSeekHarnessLauncher.exe
  5. 对打包后的 EXE 执行逻辑和 UI 冒烟测试
  6. 生成 dist\SHA256SUMS.txt

测试

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe .\launcher.py --smoke-test .\build\source-smoke.json
.\.venv\Scripts\python.exe .\launcher.py --ui-smoke-test .\build\source-ui-smoke.json

Windows 集成测试会启动一个真实的隐藏控制台进程树和临时 HTTP 服务，验证 readiness、Ctrl+C 优雅退出、进程树回收和端口释放。

如果已有完成构建的官方仓库，还可以执行真实端到端测试：

.\.venv\Scripts\python.exe .\scripts\test_real_harness.py `
  'D:\path\to\deepseek-harness' `
  .\build\real-harness-test.json

该测试使用隔离的临时 DSH_HOME，启动随机本机端口、验证 HTTP 200，再通过与桌面启动器相同的路径优雅停止。

Harness 前置条件

启动器会检测官方当前要求：

  • Node.js 22.19+ 或 24+
  • pnpm
  • Git（已有本地仓库时可选）
  • 已完成 pnpm install 与 pnpm run build 的 Harness 源码仓库

DeepSeek Harness 仍处于 Developer Preview，未来可能出现破坏兼容性的 CLI 调整。启动器通过 readiness 和环境检查尽量给出明确错误，但升级 Harness 后仍建议重新运行环境检查。

许可证

本项目采用 MIT License。DeepSeek 名称、DeepSeek Harness 名称和蓝鲸鱼 Logo 均属于其各自权利人；Logo 仅用于标识本启动器所服务的产品。本项目与 DeepSeek 官方无隶属或背书关系。