YYMYJS/DeepSeekHarnessLauncher

DeepSeek Harness 启动器

简介 · 功能特性 · 快速开始 · 设置说明 · 常见问题 · 从源码构建 · 致谢与许可

📖 简介

DeepSeek Harness 启动器是 DeepSeek Harness（dsh）的 Windows 桌面启动器。它把「启动 / 停止服务、多版本管理、自动更新、依赖与网络配置、开机自启」整合进一个免安装的单文件 exe，让你像使用桌面软件一样使用 DeepSeek Harness，而不必每次打开终端敲 pnpm dsh web。

非官方工具声明：本项目为第三方桌面管理工具，不属于 DeepSeek AI 官方产品，也不修改 DeepSeek Harness 的任何业务逻辑与数据。会话、预设等数据仍保存在 $DSH_HOME（默认 ~/.dsh）中，与启动器无关。

✨ 功能特性

| 功能 | 说明 |
|---|---|
| 一键启停 | 启动 / 停止 / 重启 Web 服务，关闭启动器不影响服务运行；停止采用「进程树 → pid 文件 → 端口占用者」三级兜底 |
| 多版本管理 | 从 GitHub 获取全部 Releases（含预发布），支持安装、升级、降级；已安装版本目录直接切换（秒级），旧版本目录始终保留 |
| 两种安装方式 | ① npm 官方发布包（推荐）：走 npm 依赖源下载官方构建产物，免下载 GitHub、免本地构建（实测约 6 秒）；② GitHub 源码：下载源码包并本地构建 |
| 依赖源镜像 | 内置常用 npm 镜像下拉预设（npmmirror / 华为云 / 腾讯云 / 官方源），也可自定义地址。国内直连官方源下载大包会超时，换镜像即可正常安装 |
| GitHub 加速 | 内置加速前缀下拉预设（ghproxy.net / gh-proxy.com / ghfast.top / gh.llkk.cc），用于检测更新与下载源码；留空为直连 |
| 版本列表多源容错 | GitHub API 不可用时自动降级：API → Releases Atom 源 → git ls-remote → 本地缓存；触发 API 速率限制时给出恢复时间与 Token 提示，版本列表照常可用 |
| 可选 GitHub Token | 填写后 API 限额从 60 次/小时提升到 5000 次/小时（不填也能用，已有多源降级与缓存） |
| 网络容错 | 依赖安装放宽超时（单请求 15 分钟）、失败自动重试 3 次且复用已下载内容；源码包下载失败自动重试 |
| 自定义端口 | 默认 3080，可在设置中修改（直接传给 dsh web --port） |
| 自定义安装位置 | 可指定任意安装目录，各版本独立存放（deepseek-harness-版本号），互不影响 |
| 依赖环境自动安装 | 检测不到 Node.js（或版本不受支持）时弹窗询问，同意后自动从国内镜像下载官方 Node.js 便携版并校验官方 SHA256，装到启动器目录下（无需管理员权限，不影响系统已有 Node） |
| 界面自适应 | 窗口尺寸与位置自动适配屏幕工作区：高 DPI 缩放、小屏笔记本、远程桌面下设置项可滚动、底部按钮始终可见可点 |
| 自动更新 | 启动时检查新版本并提醒，或一键「更新到最新」；检测与下载均可走加速前缀 |
| 浏览器集成 | 一键打开 Web UI；自动使用 dsh 输出的带 token 地址（避免直接访问根路径返回 401），可指定默认浏览器 |
| 开机自启 | 可选开机启动启动器并自动运行服务（HKCU 注册表，无需管理员权限） |
| 深浅主题 | Fluent 深色 / 浅色主题一键切换，即时生效并持久化 |
| 安全卸载 | 保留数据（仅删启动器）或完全卸载（只匹配删除 deepseek-harness- 版本目录，绝不误删其他文件） |
| 不误杀外部服务 | 部署 / 安装只停止本启动器启动的服务；你自己在别处运行的 dsh 实例不会被杀掉 |

🚀 快速开始

1. 获取启动器

- 前往 Releases 下载 DeepSeekHarnessLauncher.exe（单文件免安装，可放到任意目录）；
- 若 Releases 暂未提供，按下方 从源码构建 自行构建即可。

2. 依赖

需要 Node.js（^22.19.0 或 >=24.0.0，即 DeepSeek Harness 的 engines 要求）。

没装也没关系：启动器检测不到时会在启动后弹窗询问，点「是」即自动安装官方 Node.js 便携版
（从国内镜像下载、校验官方 SHA256、解压到启动器目录下的 runtime\，无需管理员权限）；
pnpm 未安装时自动使用 Node 自带的 corepack（corepack pnpm）。

3. 首次运行

1. 启动器会自动探测本机已存在的 deepseek-harness- / deepseek-harness 目录；
2. 若未找到，点击 「版本管理」 或 「安装」，选择一个版本自动部署；
3. 点击 「启动服务」，浏览器会打开 Web UI（地址形如 http://127.0.0.1:3080/?token=…）。

4. 让启动器接管已有的源码检出

若本机已有一份 deepseek-harness 源码检出，任选其一：

- 把 DeepSeekHarnessLauncher.exe 放到该目录的同级目录（自动探测会命中名为 deepseek-harness 的目录）；或
- 在「设置 → 安装位置」中填写其上级目录后保存，启动器会自动重新探测。

⚙️ 设置说明

| 设置项 | 位置 | 说明 |
|---|---|---|
| 服务端口 | 设置 → 服务 | dsh web --port，默认 3080，修改后需重启服务 |
| 安装位置 | 设置 → 服务 | 所有版本部署于此，留空 = 启动器上级目录 |
| 依赖源 | 设置 → 依赖源 | npm 镜像源下拉预设：npmmirror（国内推荐 / 实测最快）、华为云、腾讯云、官方源；也可直接输入自定义地址 |
| 安装方式 | 设置 → 更新与网络 | npm 官方发布包（推荐，免构建）/ GitHub 源码（本地构建，较慢） |
| GitHub 加速前缀 | 设置 → 更新与网络 | 检测更新与下载源码走此前缀，提供 ghproxy.net / gh-proxy.com / ghfast.top / gh.llkk.cc 预设；留空直连 |
| GitHub Token | 设置 → 更新与网络 | 可选；填写后 API 限额 60 → 5000 次/小时 |
| 默认浏览器 | 设置 → 默认浏览器 | 自动检测 Chrome / Edge / Firefox，可指定或使用系统默认 |
| 开机自启 / 自动运行服务 | 设置 → 行为 | HKCU 注册表实现，无需管理员权限 |
| 启动时检查更新 | 设置 → 行为 | 发现新版本时弹窗提醒 |
| 启动服务后自动打开浏览器 | 设置 → 行为 | 服务就绪后自动打开 Web UI |
| 深色 / 浅色主题 | 设置 → 外观 / 主界面「切换主题」 | 即时生效并持久化 |

❓ 常见问题

Q：更新时卡在下载依赖、报 error (23) 或 TimeoutError？
A：这是直连 npm 官方源速度过慢导致大包超时。请在「设置 → 依赖源」填写国内镜像（如 https://registry.npmmirror.com）后重试；已下载的包会被复用。更彻底的办法是使用「npm 官方发布包」安装方式——它不下载 GitHub 源码、也不需要本地构建。

Q：检测更新 / 下载源码很慢或连接被重置？
A：在「设置 → 更新与网络 → GitHub 加速前缀」中填写加速服务（如 https://ghproxy.net/）后重试。若你的网络直连 GitHub 正常，保持留空即可。

Q：点击「打开浏览器」提示 401 未授权？
A：Web UI 需要 URL 中的 token。启动器会从 dsh 输出中捕获带 token 的完整地址并自动使用；请通过启动器的「打开浏览器」按钮进入，或复制日志中 dsh web: http://127.0.0.1:…/?token=… 这一行。

Q：部署新版本会不会把我正在运行的服务停掉？
A：不会。启动器只停止由它自己启动的服务；检测到端口上运行的是外部启动的实例时会给出警告并跳过停止。

Q：卸载会不会误删我的其他文件？
A：「完全卸载」只删除安装位置下匹配 deepseek-harness-* 的版本目录与启动器自身，其他文件不动；「保留数据卸载」仅删除启动器。

Q：日志出现 403 rate limit exceeded / 检测更新失败？
A：这是 GitHub 对未认证请求的限制（60 次/小时）。启动器会自动降级：改用 Releases Atom 源 → git ls-remote → 本地缓存，版本列表照常可用；日志会提示额度恢复时间。若想彻底避免，可在「设置 → 更新与网络」填写 GitHub Token（限额提升到 5000 次/小时）。

Q：提示"缺少依赖环境"，会自动装什么？装在哪里？
A：会从国内镜像下载官方 Node.js 便携版（约 34 MB），用官方 SHASUMS256.txt 校验后解压到启动器目录下的 runtime\，只在启动器内部生效，不改系统 PATH、不影响你已装的 Node.js。删除该目录即完全卸载。

Q：屏幕缩放较大（或笔记本屏幕小）时界面显示不全？
A：窗口尺寸与位置会自动适配屏幕工作区：内容超出时可滚动，底部「保存 / 取消」按钮固定在窗口底部始终可见。若仍需强制更小窗口（如远程桌面），可设置环境变量 DSH_LAUNCHER_WORKAREA=1280x650（宽x高，单位为逻辑像素）。

🔨 从源码构建

git clone https://github.com/YYMYJS/DeepSeekHarnessLauncher.git
cd DeepSeekHarnessLauncher
dotnet publish -c Release -r win-x64 --self-contained true \
-p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true \
-p:EnableCompressionInSingleFile=true -o .\发布

产物：发布\DeepSeekHarnessLauncher.exe（自包含单文件，约 70 MB）。

环境要求：.NET SDK 8+（global.json 固定 8.0.301，rollForward: latestFeature）、Windows 10/11。

项目结构

DeepSeekHarnessLauncher.csproj   项目文件（显式文件列表，避免运行时产物污染编译）
global.json                      .NET SDK 版本
App.xaml(.cs)                    应用入口（主题应用、异常写 crash.log）
MainWindow.xaml(.cs)             主界面：状态、启停、更新、日志
SettingsWindow.xaml(.cs)         设置：端口、安装位置、依赖源、安装方式、GitHub 加速、浏览器、行为、外观
VersionPickerWindow.xaml(.cs)    版本选择对话框（Releases / Tags）
Core/
AppConfig.cs                   配置持久化、目录探测、版本读取
ServiceManager.cs              服务启停、端口就绪检测、token 地址捕获
UpdateManager.cs               版本查询、两种安装方式、下载与构建、网络重试
DependencyInstaller.cs         依赖环境检测与自动安装（便携 Node.js，含官方 SHA256 校验）
WindowSizing.cs                窗口尺寸/位置自适应（工作区限制与钳制）
PnpmHelper.cs                  Node / pnpm 环境探测
BrowserHelper.cs               浏览器检测与打开
StartupHelper.cs               开机自启（HKCU）

🙏 致谢与许可

本项目在 GNU AGPL-3.0 下发布，改编自 YYMYJS/InfiniteCanvasLauncher（同为 AGPL-3.0），感谢原作者的开源工作。

- 服务对象：deepseek-ai/deepseek-harness —— MIT License
- 界面 UI：lepoco/wpfui —— MIT License

分发修改版或作为网络服务提供时，请遵循 AGPL-3.0：公开完整源代码、保持同一许可，并保留原作者、版权与来源说明。