一键启动器great-man2096/dsh-launcher

dsh-launcher

DSH（DeepSeek Harness）的一键启动器：在后台拉起 dsh web 服务，就绪后自动打开浏览器；同时带上崩溃自愈守护、系统托盘控制和（可选的）跨会话记忆。

- ✅ 无任何写死的绝对路径 —— 换台机器直接用，不用改代码（所有配套脚本用 %~dp0 / $PSScriptRoot 定位同目录文件）
- ✅ 自动定位 dsh 命令（PATH → npm 全局 → npx 缓存 → npx 按需下载）
- ✅ 后台运行：服务器最小化启动，不弹窗打扰
- ✅ 崩溃自愈：dsh-watchdog.ps1 每 5 秒探测一次，服务挂了约 2 秒自动拉起
- ✅ 系统托盘图标：右下角一键「打开 WebUI / 停止 DSH」，双击图标打开页面
- ✅ 一键关闭：stop-dsh-all.vbs 静默结束所有 DSH 相关进程，无窗口残留
- ✅ 跨会话记忆（可选）：集成 Hindsight，没装就优雅跳过，绝不报错
- ✅ 带 DSH 鲸鱼图标（.ico），一键创建桌面快捷方式
- ✅ 结构化日志，出问题可回溯（launcher.log 记录启动器决策，dsh-server.log 记录服务器输出）
- ✅ 冷启动自动回收残留端口，且只会杀 node.exe 进程，不误伤其他软件

一个 DeepSeek Harness 的一键启动器。在后台启动 dsh web，打开浏览器，并附加自愈守护进程、系统托盘图标和可选的 Hindsight 记忆。零硬编码路径。

环境要求

- Windows（启动器是 .bat + PowerShell 脚本 + 桌面快捷方式）
- 已安装 Node.js
- 已安装 dsh（DeepSeek Harness）。任选其一：
- npm i -g @deepseek-ai/dsh
- 或把 dsh.cmd 所在目录加入 PATH
- 或设置环境变量 DSH_CMD 指向 dsh.cmd 的完整路径

watchdog、托盘、一键关闭只需 PowerShell（Windows 自带），无额外依赖。

快速开始

方式一：双击（最简单）

1. 把仓库里所有 .bat / .ps1 / .vbs / .ico 文件放进同一目录（推荐 %USERPROFILE%\.dsh\）
2. 右键 Start-DSH.bat → 发送到 → 桌面快捷方式（可选：在快捷方式属性里把图标改成本仓库的 dsh.ico）
3. 双击即可：服务在跑就直接开浏览器；没在跑就后台拉起再开浏览器，同时托盘图标出现在右下角

方式二：一键安装脚本

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

脚本会把全部文件装进 %USERPROFILE%\.dsh\，并在桌面生成带鲸鱼图标的「DSH.lnk」。

可选模块：Hindsight 跨会话记忆

Hindsight（vectorize-io/hindsight）提供按仓库的长期记忆——自动把 git 历史与对话蒸馏成可召回的记忆，跨会话保留。

不装完全没关系：启动器会检测到「未安装」并静默跳过，DSH / watchdog / 托盘照常工作，日志里只有一行 Hindsight not detected ... Skipping。不会报错、不会中断。

想启用的话，大致步骤（详见 Hindsight 官方文档）：

1. 安装 uv：irm https://astral.sh/uv/install.ps1 | iex
2. 给 DSH 装 Hindsight 插件：dsh plugin --profile web add @vectorize-io/hindsight-coding-agents
3. 配置记忆 daemon（本机 daemon 模式，端口 9077）及 LLM key（HINDSIGHT_API_LLM_* 环境变量）

启动器启动时若探测到 hindsight-api.exe（uv 缓存里）会自动把记忆 daemon 拉起来；探测不到就跳过。

系统托盘图标

启动后右下角会出现 DSH 图标：

- 双击 → 打开 WebUI
- 右键 → Open WebUI → 打开/切到 DSH 页面
- 右键 → Stop DSH → 静默结束所有 DSH 进程，托盘图标一并退出

一键关闭

- 双击 stop-dsh-all.vbs（静默、无窗口）
- 或运行 stop-dsh-all.bat（带进度提示）

会结束：Hindsight 记忆 daemon、watchdog、DSH Web（node.exe）、残留的控制台窗口。只按命令行特征精准匹配，不误伤其他程序。

配置（全部可选，用环境变量覆盖）

| 变量 | 默认值 | 说明 |
|------|--------|------|
| DSH_HOME | %USERPROFILE%\.dsh | DSH 数据目录（日志也写这里） |
| DSH_PORT | 3080 | web 服务端口 |
| DSH_CMD | 自动检测 | 强制指定 dsh.cmd / dsh.exe 的路径 |
| DSH_WATCH_INTERVAL | 5 | watchdog 探测间隔（秒） |

示例（PowerShell）：

$env:DSH_PORT = 8080
$env:DSH_CMD  = "D:\tools\dsh.cmd"
.\Start-DSH.bat

工作原理

双击 → 启动 watchdog（幂等）→ 启动 Hindsight daemon（可选，缺失跳过）
→ HTTP 存活探测（curl，~0.5s）
├─ 已有响应（200）→ 直接开浏览器（最快路径，无需定位 dsh）
└─ 无响应 → 定位 dsh → 回收端口（仅杀 node.exe）→ cmd /c 拉起服务器 → 轮询等 200 → 开浏览器
→ 启动托盘图标（幂等）
- 存活探测用 curl.exe（Windows 自带）发真实 HTTP 请求，而不是只看端口占用，避免误判「正在退出但仍占着端口的旧进程」
- 服务器输出重定向到 %DSH_HOME%\dsh-server.log，启动器自身决策写 %DSH_HOME%\launcher.log
- 日志超 1MB 自动滚动清空
- 服务器用 cmd /c 启动（而非 start xxx.bat 的默认 /K），退出后窗口自动关闭、不残留

日志与排查

出问题时看两个文件（路径都在 %DSH_HOME% 下）：

- launcher.log —— 启动器每一步决策 + 时间戳，能看出慢在哪一步、Hindsight 是否被跳过
- dsh-server.log —— 服务器的 stdout/stderr，启动崩溃的报错在这里
- dsh-watchdog.log —— 守护进程的重启记录

常见问题

Q：双击提示 dsh command not found？
没装 DSH 或不在 PATH。执行 npm i -g @deepseek-ai/dsh，或设置 DSH_CMD。

Q：我没装 Hindsight，会报错吗？
不会。启动器检测到未安装会静默跳过（日志记一行），DSH 照常启动。

Q：托盘图标没出现？
托盘靠 PowerShell 的 WinForms（Windows 自带）实现。确认脚本都放在同一目录、且系统没禁用 PowerShell。

Q：安全软件（如火绒）拦我的快捷方式？
本启动器走普通 .bat 路线，一般不拦。若被拦，把安装目录加入安全软件「信任区」即可。

Q：想完全退出？
托盘右键 → Stop DSH，或双击 stop-dsh-all.vbs。

文件清单

| 文件 | 作用 |
|------|------|
| Start-DSH.bat | 主入口：watchdog + Hindsight(可选) + DSH Web + 托盘 |
| start-dsh-server.bat | DSH 服务器包装（输出重定向到日志） |
| dsh-watchdog.ps1 | 崩溃自愈守护（5 秒探测，挂了自动重启） |
| start-hindsight-api.ps1 | 启动 Hindsight 记忆 daemon（可选，缺失跳过） |
| dsh-tray.ps1 | 系统托盘图标（打开 / 停止） |
| stop-dsh-all.bat / stop-dsh-all.vbs | 一键静默关闭 |
| dsh.ico | DSH 鲸鱼图标 |
| install.ps1 | 一键安装（复制全部文件 + 生成桌面快捷方式） |
| scripts/make-icon.js | 从 DSH 官方 favicon.svg 重新生成 dsh.ico（需要 npm i sharp） |

License

MIT