桌面启动器 kongbaiwds-web/dsh-launcher

DeepSeek Harness启动器（DSHLauncher）

给 DeepSeek Harness Web GUI 做的 Windows 轻量级桌面启动器：WebView2 套壳，带开机自启和桌面快捷方式支持。C# / .NET 8 / WinForms，单窗口、常驻系统托盘。

技术栈 WebView2 Release

📦 下载最新版：Releases 页面 —— 推荐下载 DSHLauncherSetup.exe（一键安装程序）；也提供便携版 DSHLauncher.exe（需 .NET 8 Desktop Runtime）

DeepSeek Harness启动器 主界面

安装

安装程序与启动器均为框架依赖版，需要 .NET 8 Desktop Runtime（下载）；Win10/11 装 Edge 后一般自带 WebView2。

方式一：下载安装程序（推荐）

下载 DSHLauncherSetup.exe 双击运行，按提示安装即可（默认装到 %LOCALAPPDATA%\Programs\DSHLauncher，自动创建桌面快捷方式）。

方式二：命令行 / AI Agent 一键安装

在 PowerShell 中执行（也适合交给 AI 助手直接运行，成功退出码为 0）：

irm https://github.com/kongbaiwds-web/dsh-launcher/releases/latest/download/DSHLauncherSetup.exe -OutFile "$env:TEMP\DSHLauncherSetup.exe"; & "$env:TEMP\DSHLauncherSetup.exe" --silent

静默参数：

| 参数 | 说明 |
| --silent | 静默安装（无界面），默认目录 + 创建桌面快捷方式，不自动启动 |
| --autostart | 开机自启（与 --silent 搭配）|
| --launch | 安装完成后启动启动器 |
| --dir=路径 | 指定安装目录 |

例如：& "$env:TEMP\DSHLauncherSetup.exe" --silent --autostart --launch

功能

✨ v1.5.0 新增

- 一键安装程序（DSHLauncherSetup.exe）：单文件安装程序（内嵌全部文件、黑色小鲸鱼图标），支持双击安装与命令行 / AI Agent 静默安装（--silent / --autostart / --launch / --dir=路径，退出码 0 = 成功）
- ⚙ 菜单新增「检查更新」（支持自动更新）：自动查询 GitHub 上版本号最高的 Release，发现新版本时可一键自动更新（下载 → 静默更新 → 自动重启）

⚙ 菜单 · 检查更新

✨ v1.4.0 新增

- DeepSeek Harness 品牌形象：窗口、托盘、桌面快捷方式统一使用黑色小鲸鱼图标（256×256 高清版）；窗口标题、托盘、关于等显示为 DeepSeek Harness启动器
- ⚙ 菜单新增「关闭 DSH 服务」：一键结束正在监听 127.0.0.1:3080 的 DSH 服务进程
- 桌面快捷方式自动迁移：启动/构建时自动把旧 DSH 启动器.lnk 更新为 DeepSeek Harness启动器.lnk

核心功能

- 自动启动 DSH 服务：启动器检测到 DSH 服务（默认 http://127.0.0.1:3080）未运行时，会自动以隐藏窗口拉起服务（等价于 pnpm dsh web），等就绪后再加载页面；⚙ 菜单里也有「启动 DSH 服务」可手动触发，横幅「重试」按钮同样会先尝试拉起服务
- 关闭方式可选：⚙ 菜单 →「关闭方式」：每次询问 / 最小化到托盘 / 直接退出；「每次询问」时点关闭会弹选择框，可勾选「以后不再提示」记住本次选择
- 记住窗口状态：窗口位置和大小自动记忆（拖动/缩放后 800ms 防抖写入注册表，关闭时再存一次），下次启动原样恢复；首次运行默认 1324×895
- WebView2 套壳：默认加载 http://127.0.0.1:3080（DeepSeek Harness Web GUI）
- 开机自启：⚙ 菜单一键开启/关闭（写入 HKCU\...\CurrentVersion\Run，无需管理员权限）；自启时以 --minimized 启动，直接驻留托盘
- 桌面快捷方式：⚙ 菜单一键创建「DeepSeek Harness启动器.lnk」到桌面
- 系统托盘：最小化按钮 = 普通任务栏最小化；按「关闭方式」设置（或询问时选择）收进托盘；双击托盘图标恢复；首次提示气泡
- 离线横幅：服务未启动时显示黄色横幅 + 重试按钮，不弹错误页干瞪眼
- 工具栏：后退 / 前进 / 刷新 / 主页 / 地址栏（回车跳转）/ 外部浏览器
- 单实例：重复启动会唤起已有窗口（而不是再开一个）
- 地址可改：⚙ 菜单「修改启动地址…」，设置保存在注册表，也可用 --url= 临时指定

构建

需要 .NET 8 SDK（本机若没有，参考文末「本机 SDK 安装」）。

pwsh ./build.ps1
或手动： dotnet publish DSHLauncher.csproj -c Release -r win-x64 --self-contained false -o publish\win-x64 产物在 publish\win-x64\DSHLauncher.exe（框架依赖，需要 .NET 8 Desktop Runtime； WebView2 运行时需已安装，Win10/11 装 Edge 后一般自带）。

使用

1. 双击 DSHLauncher.exe（无需先手动启动 DSH 服务：服务没开时启动器会自动拉起）
2. 点右上角 ⚙ 菜单：
- 开机自启：勾选后开机自动驻留托盘，并自动启动 DSH 服务
- 启动 DSH 服务：手动拉起/重启服务（服务已运行则无操作）
- 创建桌面快捷方式：桌面上生成「DeepSeek Harness启动器.lnk」
- 修改启动地址…：改默认 URL
3. 关闭窗口 = 最小化到托盘；托盘右键 → 退出 才真正退出

命令行参数

| 参数 | 说明 |
| --minimized | 启动后直接最小化到托盘（开机自启自动携带） |
| --url= | 临时指定启动地址（优先级高于注册表保存值） |

实现细节

| 事项 | 做法 |
| 自动启动服务 | 启动时探测 URL，不可达则以隐藏窗口运行 pnpm.cmd dsh web（工作目录 E:\deepseek\deepseek-harness-master）；PATH 里没有 pnpm 时回退到 node.exe --import tsx/esm apps/cli/src/bin.ts web（即 pnpm dsh web 展开后的命令）。日志：%LOCALAPPDATA%\DSHLauncher\dsh-server.log。注册表 HKCU\Software\DSHLauncher 的 ServerNode / ServerDir / ServerArgs 可覆盖默认值 |
| 开机自启 | HKCU\Software\Microsoft\Windows\CurrentVersion\Run 写入 "" --minimized；取消即删值。检测逻辑校验值指向当前 exe |
| 桌面快捷方式 | WScript.Shell COM 创建 .lnk，目标为当前 exe（自动适配 OneDrive 重定向的桌面） |
| 设置持久化 | HKCU\Software\DSHLauncher\Url |
| WebView2 数据目录 | %LOCALAPPDATA%\DSHLauncher\WebView2（exe 可随意移动，不产生垃圾） |
| 单实例 | 命名 Mutex + 命名 EventWaitHandle，二次启动 Set 事件让首实例弹窗 |
| 外部链接 | _blank 弹窗一律交给系统默认浏览器 |

⚠️ 开机自启和快捷方式都绑定当前 exe 路径：若移动/重命名 exe，需重新勾选自启、重新创建快捷方式。

常见问题

- 横幅提示「无法连接到…」：正常情况下启动器会自动拉起 DSH 服务并等待就绪；若启动超时，点「重试」再试，或查看 %LOCALAPPDATA%\DSHLauncher\dsh-server.log 里的服务日志
- 提示 WebView2 初始化失败：安装 WebView2 运行时
- 目标机没有 .NET 8 Desktop Runtime：先装 .NET 8 Desktop Runtime，或把发布命令改成 --self-contained true 得到免运行时版本（体积约 +70MB）

本机 SDK 安装备注（无管理员、无 winget 可用时）

沙箱环境里 schannel TLS 不可用，winget / Invoke-WebRequest 都会失败，可用 Python（OpenSSL）下载 SDK zip 后手动解压：

1) 从 https://builds.dotnet.microsoft.com/dotnet/release-metadata/8.0/releases.json 找到最新稳定版 SDK 的 win-x64 zip 地址，用 python 下载
2) 解压到任意目录（本机为 E:\deepseek\work\.dotnet）
3) 使用：& "E:\deepseek\work\.dotnet\dotnet.exe" ... 或加入 PATH

目录结构

dsh-launcher/
├── DSHLauncher.csproj # 项目文件（net8.0-windows + WebView2 包） ├── Program.cs # 入口：单实例 + 事件唤醒 ├── LaunchOptions.cs # 命令行参数解析 ├── Settings.cs # 注册表设置 / 开机自启 / 桌面快捷方式 ├── MainForm.cs # 主窗体：工具栏、横幅、托盘、WebView2、服务自愈逻辑 ├── DshServer.cs # DSH 服务启动命令构造与可用性探测 ├── UrlDialog.cs # 修改地址对话框 ├── AppIcon.cs # 运行时绘制的应用图标 ├── build.ps1 # 一键发布脚本 └── publish/win-x64/ # 构建产物