DSHLauncher
已验证 · 实测可装 xuanyvne
功能简介
DSH全程自行编写的DSH启动器，对默认的3080端口进行操作。相对于从仓库pnpm dsh web，提升一定的启动速度
可用 — 实测通过，早期项目
DSH全程自行编写的DSH启动器，对默认的3080端口进行操作。相对于从仓库pnpm dsh web，提升一定的启动速度 实测能干净安装、正常启动。早期项目，但功能可用。
「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计，也不代表对第三方代码的背书。
README
DSH 启动器 (DeepSeek Harness Launcher)
DeepSeek Harness 的桌面启动器：原生 WinForms EXE，基于 Windows 自带的 .NET Framework 4.8 编译，无需安装任何运行时或第三方依赖。
功能
| 功能 | 说明 |
|---|---|
| 启动服务 | 内置智能启动判断：遍历仓库依赖闭包，比较各 workspace 包的 src/ 与 lib/（前端 app 特判 dist/）新鲜度。产物新鲜 → 直接运行内置产物（快速）；源码较新 → 自动退回 tsx 源码模式。端口被占用时视为已在运行并打开页面；服务就绪后自动打开浏览器 |
| 停止服务 | 终止本启动器拉起的进程树；若端口仍被外部进程占用（如命令行里手动启动的实例），用 netstat 定位并弹窗确认后终止其进程树 |
| 检查/获取更新 | git fetch 源仓库（https://github.com/deepseek-ai/deepseek-harness）；直连失败时自动探测本地代理（Clash Verge 7897 等常见端口）并用只读 ls-remote 验证后重试；SSL 证书错误可选项忽略证书重试；落后时确认后拉取（ff-only）；无提交历史的 zip 副本用 reset --hard + checkout -B 对齐远端，保留不在远端中的本地文件 |
| 构建 | 在仓库目录运行一次 pnpm run build，实时输出日志，完成后弹窗提示成功/失败，并自动刷新启动模式状态 |
| 打开页面 | 手动打开 http://127.0.0.1:3080 |
| 创建桌面快捷方式 | 在桌面创建指向本 EXE 的快捷方式（带图标） |
其他特性：
- 单实例（Mutex），重复启动只提示已在运行
- 仓库目录可改，记忆在 %APPDATA%\DSHLauncher\config.json（首次启动未配置时会弹出目录选择）
- 彩色日志（错误红 / 提示橙 / 成功绿），同时写入 %USERPROFILE%.dsh\desktop-launcher\launcher.log
- 环境变量 DSH_HTTP_PROXY 可指定首选代理
- 全局异常处理：崩溃详情写入 exe 同目录 DSHLauncher-crash.log
依赖
- Windows 10/11（内置 .NET Framework 4.8 与 csc 编译器）
- node、git、pnpm 需在 PATH 上（运行服务 / 更新 / 构建用）
- 直连 GitHub 受限的网络环境需本地代理（应用会自动探测）
构建
build.cmd
build.cmd 调用系统自带编译器：
"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe" /nologo /target:winexe /out:DSHLauncher.exe /win32icon:DSHLauncher.ico /r:System.dll /r:System.Core.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll /r:"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\System.Web.Extensions.dll" src\*.cs
自检
DSHLauncher.exe --selftest
type DSHLauncher-selftest.log
源码结构（src/）
| 文件 | 职责 |
|---|---|
| Program.cs | 入口、单实例 Mutex、全局异常处理 |
| MainForm.cs | 界面、配置记忆、快捷方式、构建流程 |
| SmartLaunch.cs | 智能启动：依赖闭包 + src/lib 新鲜度判断 |
| HarnessService.cs | 服务进程管理、端口探测、netstat 定位外部进程 |
| GitUpdater.cs | 更新流程：fetch / 代理探测 / SSL 重试 / 拉取 |
| AppLog.cs | 彩色日志（界面 + 文件双写） |
| Selftest.cs | 无界面自检 |
注意：源码为 C# 5 兼容语法（系统自带编译器仅支持到 C# 5，无字符串插值、无 ?. 运算符）。
安全说明
- 项目不含任何凭据；运行时数据（仓库路径、端口）只写本机 %APPDATA%\DSHLauncher\config.json
- 仓库目录路径为运行时配置，不写死在源码中
- 日志仅存本机（%USERPROFILE%.dsh\desktop-launcher\launcher.log），不会上传
提示
- SmartScreen 可能提示"未知发布者"：EXE 未签名，点"仍要运行"即可
- 停止服务会按端口定位进程，弹窗确认后才终止外部进程，避免误杀
- 仓库更新（zip 副本场景）会执行 git reset --hard，二次确认后才执行
安装
装一次目录插件，之后本站所有插件都能让 DeepSeek Harness 自动找、自动装：
dsh plugin add dshbase-catalog然后对 agent 说「帮我装 DSHLauncher」，它会在目录里找到并自动安装。文档：dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码（未发 npm）——直接从仓库装：
Web profile：
dsh plugin --profile web add github:xuanyvne/DSHLauncherHeadless（CLI）profile：
dsh plugin --profile headless add github:xuanyvne/DSHLauncher实测报告
验证通过：从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行（dsh 0.1.0-rc.6）。
使用场景
把 dsh 跑成原生桌面应用——独立窗口、托盘图标、快捷键——而不是浏览器标签。
适合谁
想要已安装应用的感觉和系统集成（托盘、全局热键、开机自启）的人。
二次开发建议
原生壳是缝——加全局快捷键、通知、单实例锁或按 OS 定制的行为。
分享徽章
把这枚徽章粘进 README——它会链回本页，实测状态变化时自动更新：
[](https://dshbase.com/zh/plugins/DSHLauncher/)<a href="https://dshbase.com/zh/plugins/DSHLauncher/"><img src="https://dshbase.com/badges/DSHLauncher.svg" alt="dshbase 实测可装"></a>