oxgbl/dsh-no-cmd-launcher

DSH 后台启动工具（免 cmd，适配纯 CLI / npm 安装）

给习惯在 cmd / 终端里敲 dsh web 的人用：双击桌面图标即可后台静默启动 DSH，
不出现任何 cmd 窗口，关掉终端也不影响运行，启动完成后自动打开浏览器界面。

本工具不依赖 DSH Desktop 桌面应用，适用于通过 npm 等纯 CLI 方式安装 dsh 的用户。

前置条件

- Windows + Node.js（dsh 命令行工具运行所需）
- 已安装 dsh 且 dsh 命令在 PATH 中（例如 npm install -g @deepseek-ai/dsh，
以你实际的安装方式为准）。验证：在 cmd 里执行 dsh --version 能输出版本号。

文件说明

| 文件 | 作用 |
| --- | --- |
| start-dsh.ps1 | 核心启动器（端口可改，见下文） |
| stop-dsh.ps1 | 停止器：只结束本工具拉起的后台服务（node.exe / DSH Desktop.exe 进程树） |
| start-dsh.vbs | 无窗口外壳（快捷方式指向它，零闪烁） |
| stop-dsh.vbs | 无窗口外壳（停止用） |
| install-shortcuts.ps1 | 一键安装桌面快捷方式（图标自动取 DSH Desktop.exe → node.exe → 系统默认） |
| README.md | 本文档 |

安装（一次性）

在 PowerShell 里执行（或右键 install-shortcuts.ps1 → “使用 PowerShell 运行”）：

powershell -ExecutionPolicy Bypass -File "本目录\install-shortcuts.ps1"

可选参数：

- -AutoStart：额外注册开机自启（登录后静默后台启动 DSH）
- -Uninstall：移除桌面快捷方式与自启项

装完桌面上会出现两个图标：DSH 后台启动、DSH 后台停止。

使用

- 点 DSH 后台启动：
- DSH 已在运行（3080 或 6338 端口有服务）→ 直接打开浏览器，不会开第二个实例；
- 未运行 → 无窗口后台启动 dsh web --port 3080，就绪后自动打开浏览器。
- 点 DSH 后台停止：结束后台服务（按 PID 文件精确结束进程树，安全）。

配置（可选）

编辑 start-dsh.ps1 顶部几行：

- $Port = 3080：服务端口，与 cmd 里 dsh web 的默认端口一致。
- $AltPort = 6338：备用检测端口——该端口上已有 DSH（如桌面版）在跑时，直接打开它。
- 日志：%USERPROFILE%\.dsh\dsh-web-background.log
- 进程记录：%USERPROFILE%\.dsh\dsh-web-background.pid

原理

start-dsh.vbs（wscript，本身无窗口）以隐藏方式调用 PowerShell
（-WindowStyle Hidden），PowerShell 先通用解析 PATH 里的 dsh 命令
（npm shim 是 dsh.cmd），再以 cmd /c call "dsh.cmd" web --port 3080 >> 日志 2>&1
的 CreateNoWindow（无窗口）+ 日志重定向 方式启动 dsh web，进程与调用者完全脱离——
所以没有 cmd 窗口，关掉任何终端也不影响它。就绪后脚本把监听端口的进程 PID 写入
dsh-web-background.pid，stop-dsh.ps1 据此 taskkill /T 结束进程树。

常见问题

- 点了没反应？ 看日志 %USERPROFILE%\.dsh\dsh-web-background.log。
- 提示"未找到 dsh 命令"？ 确认已 npm install -g @deepseek-ai/dsh（或你的安装方式）
且 bin 目录在 PATH；重开一个终端验证 dsh --version。
- 启动超时？ 多半是 3080 被其它程序占用，改 $Port 后重试。
- 本机同时装了 DSH Desktop？ 桌面版端口是动态的，启动器会自动检测其主进程
正在监听的端口并直接打开它（不会重复启动）；两者共用同一套浏览器界面。
检测失败时则退回静态端口检查（$AltPort）。