DSH 托盘启动器 · DshLauncher

让 DeepSeek Harness 变成"双击就能用"的 Windows 程序 —— 而且它坏掉的时候，你能自己救回来。

---

这是什么

DeepSeek Harness（DSH）本身是个命令行工具：要开它得敲命令，出了问题得看日志、杀进程、翻配置。

DshLauncher 是套在它外面的一个小托盘程序（单 exe，约 50 KB，不需要安装器）：

情况	双击桌面图标会怎样
DSH 正常	秒开界面（优先复用 Chrome PWA 窗口）
DSH 挂了 / 没启动	自动清理卡住的旧进程 → 全新启动 → 打开界面
界面彻底进不去	走救援模式（命令行也能用，见下）

---

✨ 特性

• 🖱️ 双击即用 —— 桌面就一个「DeepSeek Harness」图标，别的都不用管
• 🩹 一键修复 —— 清理旧 DSH 进程（只杀 DSH，不碰其它 node 程序）→ 重新启动 → 就绪后开界面
• 🚑 救援模式 —— 本项目重点：DSH 起不来时的救命通道（详见下节）
• 🧭 托盘常驻 —— 右键：打开界面 / 重启 / 叫小D来修 / 救援 / 停止 / 查看日志 / 开机自启 / 退出
• 🔁 单实例 —— 重复双击走命名管道转发给已有实例，不会双开、不弹窗
• 📝 完整日志 —— 启动器动作日志 + 服务 stdout/stderr 分离落盘、自动轮转、启动失败自动附报错尾部
• 🚨 崩溃可感知 —— 托盘每 3 秒快检，DSH 意外退出会弹气泡提醒，点一下就能重启
• ⚙️ 零依赖 —— 单 exe（.NET Framework 4.x 系统自带），无需安装器、无需 Visual Studio

---

🚑 救援模式（本项目的重点）

什么时候用

• DSH 界面报 Failed to load plugins，插件一加载就崩
• 装了个插件之后，DSH 整个起不来了
• 启动直接闪退 / 卡死，根本看不到界面
• 改配置改坏了，进不去又退不回来

怎么用

界面还能开 → 托盘右键 → 救援

界面完全开不了 → 命令行（这才是救援模式真正的价值）：

DshLauncher.exe --rescue-brief        # 收集现场：只读生成诊断简报
DshLauncher.exe --rescue-diagnose     # 读最近简报，给修复建议
DshLauncher.exe --rescue-verify       # 救援验收：8 项自检清单
DshLauncher.exe --rescue-enter        # 进入安全模式（跳过用户插件，起干净实例）
DshLauncher.exe --rescue-exit         # 退出安全模式，恢复正常
DshLauncher.exe --rescue-scan         # 插件目录链接体检
DshLauncher.exe --rescue-snapshots    # 列出可用配置快照
DshLauncher.exe --rescue-patches      # 本地补丁状态

结果都会落盘到 logs\rescue-*.txt。本程序是无控制台的窗口程序，不往屏幕打印，所以以文件为准。

安全模式是干什么的

它用 DSH_SAFE_MODE=1 启动一个干净实例（默认 3090 端口，跳过你装的那些插件）。

这样即使某个插件把 DSH 搞挂了，你也能进到界面里，把那个插件关掉或卸掉，再切回正常模式。

它不会乱动你的东西

• 诊断部分全程只读
• 需要改配置时，动手前自动快照，可一键回滚
• 你的会话数据、记忆、插件都不会被删

---

📦 安装

前置条件：Windows 10/11 + Node.js + 已经装好 DeepSeek Harness（dsh web 能正常跑）

方式一：下载即用（推荐）

1. 到 Releases 下载最新的 zip
2. 解压到任意目录
3. （可选）双击 install.cmd → 创建桌面快捷方式「DeepSeek Harness」
4. 双击 DshLauncher.exe 或桌面图标

方式二：从源码构建

git clone https://github.com/abaicaia/dsh-tray-launcher.git
cd dsh-tray-launcher
build.cmd

只用系统自带的 .NET Framework 4.x csc.exe，不需要 Visual Studio。构建完会自动生成图标并创建桌面快捷方式。

---

🚀 使用

托盘右键菜单

打开界面 · 重启（清理旧进程）· 叫小D来修 · 救援 · 停止 · 查看日志 · 开机自启 · 退出

双击托盘图标 = 打开界面。

命令行

DshLauncher.exe                         # 启动托盘（DSH 没跑就自动拉起）
DshLauncher.exe --open                  # 托盘 + 打开界面
DshLauncher.exe --start [--noopen]      # 一次性：清理 → 启动 → 打开界面
DshLauncher.exe --restart [--noopen]    # 同 --start
DshLauncher.exe --stop                  # 停止 DSH（弹窗确认）
DshLauncher.exe --status                # 状态报告 → logs\status.txt
DshLauncher.exe --selftest              # 环境自检 → logs\selftest.txt
DshLauncher.exe --port 3199             # 指定端口（默认 3080）
DshLauncher.exe --rescue-*              # 救援模式，见上
DshLauncher.exe --help                  # 帮助

---

🐛 出问题了怎么查

按顺序看，一般第一步就能定位：

1. logs\launcher.log —— 启动器自己的动作记录（清理/启动/报错，带时间戳；启动失败会附服务报错尾部）
2. logs\dsh-web-3080.stderr.log —— DSH 服务本身的报错（自动轮转，上一份存 .prev）
3. DshLauncher.exe --selftest → logs\selftest.txt —— 环境自检（node / WMI / netstat / 端口 / 健康状态）
4. 界面都进不去了 → --rescue-brief（见上）

---

📁 目录结构

DshLauncher.exe      主程序（单文件，双击即用）
build.cmd            一键编译
ask-xiaod.cmd        叫小D来修（急救入口）
src\                 C# 源码（7 个文件）
scripts\             构建与打包脚本
assets\              图标
docs\                设计文档、开发复盘、编码规范
tests\               测试脚本
logs\                运行日志（不入库）

---

🔒 它不会碰什么

清理旧进程时，只杀确实是 DSH 的进程，不碰其它 node 程序：

• pid 文件里记录的进程
• 命令行含 @deepseek-ai\dsh 且端口一致的 node 进程
• 监听目标端口的进程（netstat 兜底）

救援模式：诊断只读，改配置前自动快照、可回滚。

---

📄 License

MIT —— 见 LICENSE