托盘启动器 SimonMedy/DSH-Launcher

DSH Launcher

非官方社区版 Windows 系统托盘启动器，面向 DeepSeek Harness。本项目与 DeepSeek 无隶属关系，也未获其背书。

DSH Launcher 在后台启动 DeepSeek Harness，等待校验通过的本地启动公告与 HTTP 就绪信号，并提供 WPF 托盘界面，用来打开、更新、重启和配置服务。

功能

- DeepSea WPF 托盘界面
- 本地 dsh web 生命周期管理
- DSH Web 仅绑定回环地址（127.0.0.1）
- 校验启动公告与 HTTP 就绪之后才打开浏览器
- 3080 被占用时，安全回退到系统分配的空闲端口
- 为 DSH Web 配置可信授权
- 按需把 DeepSeek Harness 更新到解析出的确切 npm 版本
- 已安装的 DSH 版本就是最新版时，检测为无需更新
- 全局 DSH 包缺失时自动首次安装
- 安全的进程归属：绝不终止无关进程
- 结构化进程参数：配置不会插值进 shell 命令
- 有界、轮转的本地日志，并遮蔽类 token 值
- 单实例保护

环境要求

- Windows 10 或 Windows 11 x64
- 从源码构建需要 .NET 10 SDK
- Node.js，且 PATH 中可用 npm

仓库通过 global.json 固定其 .NET 10 SDK 策略。

安装

1. 下载或克隆本仓库。
2. 把文件夹放在固定位置。
3. 运行 setup.cmd。
4. 启动器构建到 dist/，并创建 DeepSeek Harness 桌面快捷方式。

setup.cmd 不请求提权，也不绕过 PowerShell 执行策略。

使用

从桌面快捷方式启动 DeepSeek Harness。启动器解析全局安装的 @deepseek-ai/dsh Node.js 入口，直接启动 DSH，不把配置放进 shell 命令。

DSH Launcher 负责浏览器交接，并向 DSH 传入 --no-open。它等待进程专属的 dsh web: 启动公告，校验公告的 URL 仅指向回环地址，然后确认 HTTP 就绪，之后才启用 Open DeepSeek Harness。

如果 TCP 端口 3080 已被占用，现有监听者保持不动。DSH 以 --port 0 启动，由 Windows 分配空闲回环端口。端口与 3080 不同时，托盘状态会显示实际端口。

受信任的授权主机与远程访问

--trusted-host 是 DSH Web 的浏览器信任 / 授权主机校验设置。它不是身份认证，本身也不会把 Harness 暴露给其他设备。

只把你预期 DSH Web 会收到的 hostname 或 IP 授权主机填进去，例如：

my-pc.tailnet.ts.net
100.100.20.30
192.168.1.50
host.example:443
[fd00::1234]:443

DSH Launcher 保存前会校验这些值，启动 Harness 前再校验一次。scheme、path、凭据、格式错误的端口、shell 元字符都会被拒绝。

Launcher 自身强制把 DSH Web 的绑定主机固定为 127.0.0.1。自由填写的附加参数无法覆盖 --host 或 --trusted-host；受信任的授权主机必须通过专门的 Settings 字段配置。

要做远程访问，请把回环地址上的 Harness 端点放到可信网络边界之后，比如 Tailscale、WireGuard，或带身份认证的反向代理。不要把未做身份认证的 Harness 监听端口直接暴露到公网。

附加命令行参数

附加参数会先做分词，然后每个 token 通过 ProcessStartInfo.ArgumentList 直接传给 DSH Node.js 进程。

Launcher 自己管理的选项会特殊处理：

- --host 会被拒绝，始终固定为 127.0.0.1；
- --trusted-host 在自由填写的参数里会被拒绝，必须走受信任授权主机的 UI；
- --port / --port=... 由 launcher 解析并校验，包括 --port 0；
- --no-open 是多余的，因为浏览器交接始终由 DSH Launcher 负责。

Launcher 启动日志会刻意省略参数值。即便如此，也不要把凭据、API key 或其他机密写进命令行参数，因为操作系统或下游工具链可能看得到命令行。

带身份认证的浏览器交接

一些较新的 DeepSeek Harness 构建会公布一个浏览器 URL，其中带有身份认证 / 引导 token。DSH Launcher 把这个 URL 当作敏感的运行时状态：

- 完整的交接 URL 只留在内存里；
- 带 token 的 URL 绝不写入 runtime.json；
- 启动日志行在落盘前会先做脱敏；
- 日志里形似 token 的通用查询值会被打码；
- 就绪探测使用干净的回环 origin，因此不会消耗或重放浏览器 token；
- 只有当用户要求正在运行的 launcher 打开 DSH 时，才会用到内存里那个带身份认证的 URL。

第二次调用 launcher 不会持久化，也不会重建带身份认证的交接 token。如果需要带身份认证的交接，请用已经在运行的托盘实例来安全地打开 DSH。

Harness 更新

选中 Update DeepSeek Harness 后，DSH Launcher 先向 npm 查询 @deepseek-ai/dsh 的 dist-tags.latest，校验返回的版本号，再与已安装的包版本比较。
如果两个版本完全一致，就跳过更新，正在运行的 Harness 进程保持不动。否则启动器会安装解析出的确切版本，例如：

npm install -g @deepseek-ai/dsh@0.1.1-rc.2

可变的 @latest 目标绝不会直接写进安装命令。npm 仍是上游包分发的信任边界。

配置

配置存放在 Git 仓库之外，路径为：

%LOCALAPPDATA%\DeepSeekHarness\config.json

写入时先用临时文件，再做读回校验，最后在同目录内替换。保存失败会提示用户，而不是被忽略。

如果现有 JSON 已损坏，DSH Launcher 会保留一份带时间戳的副本，改用安全默认值，并显示恢复警告，而不是悄悄覆盖原配置。

日志

%LOCALAPPDATA%\DeepSeekHarness\logs\

文件：

harness.log
harness-error.log
launcher.log

每个活动日志上限约 5 MiB，轮转时保留一份 .1 备份。写入时会抹掉类似 token 的值，但日志仍可能包含 DSH 上游的普通输出；公开分享前请先检查。

开发与 CI

安全相关的解析、配置、更新版本处理和运行时端点行为，都在 tests/DSHLauncher.Tests 下有自动化回归测试。

GitHub Actions 在 Windows 上运行，执行还原、构建、测试、自包含 win-x64 发布和 CodeQL 分析。第三方 Actions 固定到不可变的 commit SHA，Dependabot 会为 Actions 和 NuGet 测试依赖提出分组更新。

安全

漏洞上报流程和安全模型见 SECURITY.md。

重要不变量：

- 用户可控的设置绝不会插进 Harness shell 命令；
- DSH Web 由启动器绑定到回环地址；
- 受信任的授权方会经过校验，无法通过自由形式的 --trusted-host 参数绕过；
- 只终止启动器自己拥有的进程树；
- 无关的端口占用者保持不动；
- 认证启动 token 不会留在启动器的持久状态和日志里；
- 配置写入失败和损坏恢复都可见；
- npm 安装针对经过校验的确切版本，已是最新时跳过；
- CI Actions 固定到不可变的 SHA。

许可证

MIT。见 LICENSE。