桌面启动器 2bitbit/dsh-desktop

dsh-desktop

DeepSeek Harness（@deepseek-ai/dsh）的原生 Windows 桌面启动器点击快捷方式 = 在指定目录执行 dsh web --no-open，解析本次进程 token，最大化打开 Edge 应用窗；窗口收进托盘常驻，托盘菜单退出时才回收后台。

[!IMPORTANT]
仅限 Windows 10 1607+ / 11 x64。依赖 Win32 GUI、Job Object、WinEventHook、低层输入钩子、每显示器 DPI 感知 v2，以及本机已安装的 Microsoft Edge。

不需要在 Edge 里预先安装任何应用：本程序用 msedge.exe --app=<tokenUrl> 直接开独立窗口。

做什么

dsh web 从 0.1.2 起在根路径强制认证：每次进程启动都会打印带 ?token= 的认证 URL，浏览器用它换 cookie 后再进界面。没有有效 cookie 或当前进程 token，直接打开根地址会返回 401。认证 URL 在同一进程内可重复兑换，不是用一次即销毁的令牌。

本仓库把这条链路收成一个无控制台 exe：

1. 单实例检查：已有实例在跑时，只把它的窗口前置，然后自己退出。
2. 立刻弹出原生启动窗（可取消）。
3. 直通 pnpm 的 node.exe 跑 dsh web --no-open，stdout 进管道。
4. 解析 dsh web: http://127.0.0.1:<port>/?token=...。
5. 只打开一次 Edge --app=<tokenUrl>，并最大化；随后挂出托盘图标。
6. 窗口关掉（叉号 / Alt+F4 / Ctrl+Shift+W）只是收进托盘，后台继续跑。
7. 托盘菜单「退出」→ Job Object 秒杀 node 进程树，端口立刻释放。
8. 托盘或市场重启 → 等待当前后台的认证就绪，验证 HTTP 兑换后换新页面；托盘图标保持。

关闭与重启

| 操作 | 结果 |
| 左键点标题栏叉号 | 收进托盘，后台继续运行 |
| Alt+F4（应用窗口在前台） | 同上 |
| Ctrl+Shift+W（应用窗口在前台） | 同上 |
| 左键单击托盘图标 / 再次运行 exe | 前置已有窗口 |
| 右键托盘图标 → 显示窗口 | 同上 |
| 右键托盘图标 → 重启后台 | 重启后台，验证认证 URL 后开新窗、关旧窗；托盘图标保持 |
| 再运行一次 exe 并带 --restart | 同上（等价于托盘那一项，方便做快捷方式） |
| 在 dshmarket 里点「重启」 | 等作业内替补监听、完整认证日志与 HTTP 验证，随后换新窗 |
| 右键托盘图标 → 退出并结束后台 | 关窗口 + 杀后台进程树 + 移除托盘图标 + 退出 |
| 窗口被其它途径销毁（任务栏预览关闭、浏览器崩溃等） | 同样回收后台再退出，不留僵尸进程 |

三条「收进托盘」的路径都不弹任何通知，也不会让后台进程退出。

热键只在应用窗口处于前台时才拦，不会抢其它程序的 Alt+F4 / Ctrl+Shift+W。

重启的就绪判据

市场重启由助手拉起替补，助手和替补仍在启动器的 Job Object 内。启动器不能在旧进程退出时立即杀掉整个作业，也不能只凭端口开始监听就报告成功：DSH 先监听端口，再完成插件加载和启动审计，最后才打印认证 URL。

启动器按以下顺序完成市场重启：

1. 确认新监听进程属于当前 Job，且不是已退出的旧 PID；拒绝接管外部进程。
2. 持续读取市场日志尾部（%TEMP%\\dsh-market-restart-.out.log），只接受同端口回环根地址上的完整 token 行。
3. 不以修改时间筛掉日志。Windows 的持续写入句柄未关闭前，mtime 可能仍是旧值。陈旧日志中的 token 由当前服务器验证，不能凭时间戳认定新旧。
4. 用独立 WinHTTP 会话验证：新 token 请求 → 303 和 dsh-auth- cookie → 携带该 cookie 请求首页 → 200、HTML、DSH 引导标记。不使用 Edge cookie，不走代理，不跟随外部跳转。
5. 验证通过才接管新后台并换窗；先把销毁钩子挂到新窗口，再关旧窗。旧窗口隐藏在托盘时，新窗口也会被隐藏。

认证观察预算为 60 秒；单次 HTTP 操作设有 1 秒超时并受剩余预算限制。作业已空、认证超时或换窗失败时，启动器明确记 ERROR 并回收本作业，不再静默保留未完成的窗口却报告成功。

托盘「重启后台」和 --restart 从自己的 stdout 取得认证 URL，也执行同一 HTTP 验证和换窗流程。你不需要手动关窗，窗口句柄会更换；可见窗口可能短暂切换。
验证边界：HTTP 检查证明当前主机接受该 token 和新签发的 cookie，不等于已检查 Edge 内的 cookie、React 装配或每个插件的渲染。此启动器不修复 DSH 更新插件时的 revision 404、热更新黑屏或通知插件内部缺陷。市场日志文件名仍是与 dshmarket 的实现耦合点。

v2.3.2 的替身测试未覆盖持续写句柄和延迟打印，因此不能证明真实市场重启修复成功。本仓库现在提供这些回归用例，并明确区分夹具测试、真实 DSH HTTP 验证与完整界面验收。

快速使用

1. 前提

- Windows 10 1607+ / 11 x64，已安装 Microsoft Edge
- 已全局安装 dsh ≥ 0.1.2：pnpm add -g @deepseek-ai/dsh

2. 安装快捷方式

下载 最新 Release 压缩包 解压后，在 PowerShell 中执行：

交互模式：弹出文件夹选择框 .\install_shortcut.ps1

指定工作目录与快捷方式名称 .\install_shortcut.ps1 -TargetDirectory "D:\Workspace\MyProject"

会在桌面与开始菜单各放一个快捷方式。点击它 = 在该目录执行 dsh web --no-open，等 token 就绪后打开最大化的 Edge 应用窗。

托盘图标取自 exe 内嵌资源（src/tray_icon.ico），快捷方式图标同样用的是它。

生命周期

快捷方式 (--cwd <dir>)
│
▼
dsh_desktop.exe ── 单实例检查（已有实例 → 只前置窗口，然后本进程退出） │ ├─ 启动窗 │ ├─ Job Object ──▶ node (dsh web --no-open) │ │ │ └─ stdout: dsh web: http://127.0.0.1:<port>/?token=** │ ├─ Edge --app=<tokenUrl> （最大化） │ ├─ 托盘图标常驻 │ ├─ 叉号 / Alt+F4 / Ctrl+Shift+W ──▶ 隐藏到托盘（后台照常跑） │ ├─ 托盘「重启」/ --restart / dshmarket 的重启 │ └─▶ 等待作业内监听者 + 完整认证输出 + HTTP 兑换验证 │ ├─ 验证通过 ──▶ 接管新进程，换新窗口（托盘保持） │ └─ 超时 / 作业已空 / 换窗失败 ──▶ 报错并回收 │ └─ 托盘菜单「退出」 ──▶ TerminateJobObject ──▶ 回收进程树 / 释放端口

运行期间用 SetWinEventHook + MsgWaitForMultipleObjects 挂起，0 轮询 / 0% CPU。

叉号之所以能被拦下：程序挂了一个 WH_MOUSE_LL 低层鼠标钩子，左键按下时若点在窗口顶部带内，就向应用窗口问一次 WM_NCHITTEST；Chromium 会为自绘标题栏如实回答，关闭按钮返回 HTCLOSE。只有拿到 HTCLOSE 才吞掉这次点击并隐藏窗口，页面内的普通点击不受影响。

常用参数

| 参数 | 说明 | 示例 |
| --cwd <path> / -w <path> | 后台 dsh 工作目录 | dsh_desktop.exe --cwd "D:\Projects\Demo" |
| --debug / -d | 调试日志 + 失败弹窗 | dsh_desktop.exe --debug |
| --restart | 让正在运行的实例重启后台（等价于托盘菜单「重启后台」） | dsh_desktop.exe --restart |

exe 同级会写两份日志（每次启动清空，运行中追加并限大小；token 脱敏）：

| 文件 | 内容 | 上限 |
| dsh_desktop.log | 启动器自身日志 | 512 KB |
| dsh_web_console.log | dsh web 的 stdout/stderr | 2 MB |

源码编译

需要 MinGW-w64 / LLVM Clang / MSVC 之一，以及配套的资源编译器（windres 或 rc.exe）：

.\scripts\build.ps1

脚本会先把 src/dsh_desktop.rc（内嵌托盘图标 src/tray_icon.ico）编译成资源对象，再连同 src/dsh_desktop.cpp 一起链接。

产物：bin/dsh_desktop.exe。GCC 路径用 -static -static-libgcc -static-libstdc++ 静态链接，成品不依赖 MinGW 运行时 DLL。

GCC 路径已在 MinGW-w64 GCC 15 上实测；Clang / MSVC 两条路径未实测。

隔离回归

.\scripts\test.ps1

需要 MinGW-w64 GCC 和 Node。测试使用私有临时目录、系统分配端口与自建子进程；不打开 Edge，不操作用户的 DSH 实例。覆盖持续写句柄、旧 mtime、完整换行、延迟输出、陈旧 token、兑换响应、Job/PID 归属与超时。HTTP 夹具通过不等于真实市场或完整 UI 已验收。

版本沿革

见 CHANGELOG.md。

协议

MIT License