下载 dsh-harness-desktop-1.0.2-x64.exe（87MB 单文件）：
- 官方下载页：GitHub Releases （直接链接：https://github.com/FeatherHunter/SKILLS/releases/download/v1.0.2/dsh-harness-desktop-1.0.2-x64.exe ）
- 或向维护者索取；也可以自己打包（见开发者专区）
双击它 → 首次等待几分钟（自动下载安装 DSH 本体）→ 自动进入界面
之后双击即秒开；关掉窗口它仍在右下角托盘后台运行，随时点开秒回

想要桌面快捷方式？在 exe 所在目录执行：

.\dsh-harness-desktop-1.0.2-x64.exe --install-shortcut
# 桌面出现「桌面版」图标，以后双击它直接打开

Windows 弹出「已保护你的电脑」？点 更多信息 → 仍要运行 即可（exe 未签名，本地构建产物，安全）。

日常使用：关窗后应用仍在右下角托盘后台运行（DSH 服务不停）。左键单击托盘图标打开窗口；右键托盘图标可退出（带确认）或勾选开机自启（登录后后台常驻，双击图标即开）。

方式 B：npm 安装（有 Node 环境的开发者）

# ① 建个文件夹并进入
mkdir dsh-app && cd dsh-app

# ② 安装（npm 源，国内镜像也快；看到 added 1 package 即成功）
npm install dsh-harness-desktop

# ③ 进入包目录，补装 electron 运行时（必做：npm 默认不装对方包的开发工具）
cd node_modules/dsh-harness-desktop
npm install

# ④ 启动（首次自动下载 DSH 本体，之后秒开）
npm start

⚠️ 国内网络第 ③ 步大概率报 TypeError: fetch failed（electron 二进制从 GitHub 下载被挡）。解决：先设镜像再执行 npm install：
$env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'
npm install
若已经报错，设完镜像后执行 node node_modules/electron/install.js 即可补下成功。

桌面快捷方式（可选）：在包目录执行 npx dsh-harness-desktop shortcut。

🛠 开发者专区

cd dsh-plugin/dsh-desktop
npm install && npm start    # 源码运行
npm run dist                # 打包便携 exe → dist/dsh-harness-desktop-1.0.2-x64.exe
npm run pack                # 快速验证：不打安装包，直接跑 win-unpacked/

常用环境变量（可选）：

变量	默认	说明
`DSH_DESKTOP_PORT`	`3080`	DSH 服务端口
`DSH_DESKTOP_COMMAND`	内置运行时	自定义启动命令（整行，shell 解析；设置后跳过内置运行时）
`DSH_DESKTOP_REGISTRY`	自动测速选源	安装 DSH 时的 npm 源；默认并发测速官方源与 npmmirror 选快者，设置后强制用它
`DSH_DESKTOP_REINSTALL=1`	关	强制重装/升级 DSH 运行时（走 `@latest` 显式版本）
`DSH_DESKTOP_HIDDEN=1`	关	隐藏启动：窗口不显示，右下角托盘常驻（服务化；`--hidden` 同效）
`DSH_DESKTOP_USER_DATA`	默认	独立 userData 目录（测试隔离：单实例锁/设置按目录隔离，普通用户不需要）

内部调试变量（DSH_DESKTOP_SMOKE / DSH_DESKTOP_SHOT / DSH_DESKTOP_SIZE）见 main.js 顶部注释。

❓ 常见问题

双击没反应 / 提示"已保护你的电脑"？ → SmartScreen 拦截，点「更多信息 → 仍要运行」。
首次启动等很久？ → 正在下载 DSH 本体（数百 MB），几分钟正常；装好后离线秒开。安装页会显示真实进度（已下载 MB / 包数 / 百分比）与当前源；若长时间无进展可点「切换镜像重试」（自动换 npmmirror 重装）。本机 npm 缓存里已有 DSH 时直接复制复用，免下载。
提示"端口 3080 被其他程序占用"？ → 有别的程序占了 3080，关掉它，或用 DSH_DESKTOP_PORT 换一个端口。
关窗后 DSH 还在跑吗？ → 在跑。关窗只是隐藏窗口（右下角托盘常驻），左键单击托盘图标随时打开；托盘「退出」才会真正停止后台服务。
怎么真正退出？ → 右下角托盘图标右键 → 「退出（停止后台 DSH）」→ 确认。
怎么开机自启？ → 托盘图标右键勾选「开机自启（登录时后台常驻）」；下次开机 DSH 自动后台运行（窗口不显示），双击图标即开。
怎么升级 DSH？ → 打开应用后点左上角「检查更新」→「升级并重启」即可（自动下载新版并重启）。备选：删除 %APPDATA%\dsh-desktop\runtime 目录后重新打开，或设置 DSH_DESKTOP_REINSTALL=1 启动（重装走 @latest 显式版本，确保真的拉到新版）。
需要装 Node.js 吗？ → exe 方式不需要（内置运行时）；npm 方式需要。
Linux 双击没反应？ → 桌面环境 PATH 可能不含所需命令，用 DSH_DESKTOP_COMMAND 指定完整启动方式。

🔧 原理速览（开发者选读）

进程管家：主进程拉起 DSH → 监控 → 关窗 = 隐藏到托盘（后台 DSH 继续运行），只有托盘「退出」（确认弹窗）或应用退出时才杀掉整棵进程树（含安装阶段的 npm），不留孤儿进程；只有"本次由桌面版拉起的 DSH"才会被杀，不误伤手动实例。托盘不可用（如部分 Linux 桌面无托盘）时自动退回「关窗即退」老行为。
内置运行时（零依赖）：Electron 自带完整 Node（ELECTRON_RUN_AS_NODE）+ 捆绑 npm（11MB）→ 首次运行自动安装 DSH 到 %APPDATA%/dsh-desktop/runtime，之后离线可用。
检查更新：页面左上角按钮查 npm registry（DSH_DESKTOP_REGISTRY 可指定源）比对 semver，发现新版经确认后强制重装 @latest 并自动重启；REINSTALL 环境变量同路径。
首次安装三优先：① 本机 npm 缓存（%LOCALAPPDATA%/npm-cache/_npx）已有 DSH → 直接复制复用（免联网下载）；② 否则并发测速官方源与 npmmirror，自动选快者下载； ③ 安装页显示真实进度（字节/包数/百分比），90 秒无进展提示可「切换镜像重试」。
标题栏带：页面整体下移 40px 形成无边框标题区，窗口控制按钮悬浮其上；顶部事件走 DOM 层（面板/浮层拖拽不被吞），空白带手动拖拽移动窗口。
日志：%APPDATA%/dsh-desktop/dsh.log（Linux/macOS 为 ~/.config/dsh-desktop/dsh.log），出错页可直接查看尾部。