dsh-oneclick-launcher

August 30, 2026 · View on GitHub

Windows 一键启动 DeepSeek Harness（独立窗口版） One-click launcher for DeepSeek Harness on Windows (standalone window, not a browser tab)

问题 / Problem

启动 DeepSeek Harness 需要两步操作，比较繁琐：

打开 PowerShell，运行 dsh web（服务在终端里运行）
点击桌面 Chrome PWA 快捷方式，才能打开独立的 GUI 窗口

如果直接运行 dsh web，它会在浏览器标签页中打开 GUI，而不是像桌面应用那样的独立窗口。

方案 / Solution

一个 VBS 启动脚本 + 桌面快捷方式，双击即完成全部工作：

HTTP 存活探测 3080 端口（请求返回 200 才算服务正常，不只是端口被占）
服务未就绪或假死（端口被占但 HTTP 不通）时，自动清理占用进程并后台隐藏启动 dsh web（设置正确的工作目录）
等待服务真正就绪（HTTP 200，最长 90 秒）
用 Chrome PWA 独立窗口（app 模式）打开 GUI —— 不是浏览器标签页
每次运行写入 launcher.log，方便排查

v7 起：端口被僵死进程占用（如旧服务残留）时，脚本会自动 taskkill 该进程并重启服务，避免 PWA 打开后白屏/无法连接。

文件 / Files

文件	说明
`DeepSeekHarnessLauncher.vbs`	一键启动脚本（VBScript，无需安装任何依赖）
`install.ps1`	安装脚本：自动探测路径、生成快捷方式（可选）

安装 / Install

方式 A：手动（最简）

把 DeepSeekHarnessLauncher.vbs 放到任意目录（例如 D:\softinstall\deepseeek harnees\）
打开脚本，按你的环境修改开头几行常量：

Const PORT = 3080                                    ' dsh web 监听端口
Const DSH_DIR = "C:\Users\10780\AppData\Roaming\npm" ' dsh 命令所在目录（npm 全局目录）
Const NODE = "D:\softinstall\nodejs\node.exe"        ' node.exe 绝对路径
Const BIN = "C:\...\node_modules\@deepseek-ai\dsh\lib\bin.js"  ' dsh bin.js 绝对路径
Const CHROME = "C:\Program Files\Google\Chrome\Application\chrome_proxy.exe"  ' Chrome
Const APP_ID = "hgiemfgfjhalibdoboikeiepnnjapnpc"    ' DeepSeek Harness PWA 的 app-id

右键桌面 → 新建快捷方式 → 目标填：

wscript.exe "D:\softinstall\deepseeek harnees\DeepSeekHarnessLauncher.vbs"

双击快捷方式即可。

方式 B：自动安装脚本

# 以管理员或普通用户运行均可（安装脚本会自动探测环境）
powershell -ExecutionPolicy Bypass -File .\install.ps1

install.ps1 会：

自动探测 node.exe、dsh 安装目录、Chrome 路径
探测 DeepSeek Harness 的 PWA app-id（从 Chrome Web Applications 目录）
生成 DeepSeekHarnessLauncher.vbs（写入探测到的路径）
在桌面创建 DeepSeek Harness.lnk 快捷方式

工作原理 / How it works

为什么是独立窗口而不是标签页？

dsh web 启动时默认在浏览器标签页打开 GUI。要在独立窗口（类桌面应用）打开，使用 Chrome 的 PWA app 模式：

chrome_proxy.exe --profile-directory=Default --app-id=<PWA_APP_ID>

这个 app-id 来自你首次在 Chrome 中"安装" DeepSeek Harness PWA 时生成的注册（存储在 %LOCALAPPDATA%\Google\Chrome\User Data\Default\Web Applications\_crx_<app-id>\）。

为什么用 VBScript？

VBScript 可以隐藏窗口运行 dsh web（服务在后台运行，不占终端）
双击 .vbs 由 wscript.exe 执行，无需安装 Node/Python 等运行时
系统自带，零依赖

踩坑记录（重要！）

开发这个脚本时踩过这些坑，供参考：

VBScript 不区分大小写：变量 isListening 和函数 IsListening() 同名会编译报错 → 改名避免冲突
LOG 是 VBScript 内置函数名（自然对数），不能用作常量 → 改名 LOGFILE
shell.Exec 管道读取可能死锁：netstat | findstr 的输出用 AtEndOfStream 判断可能卡住 → 改为重定向到临时文件再读取
cmd /c 嵌套引号 + 路径含空格（如 deepseeek harnees）会解析失败 → 用 shell.CurrentDirectory 设置工作目录，避免 cmd /c
dsh web 需要正确的工作目录：直接 node bin.js --profile web 若工作目录不对会启动失败；手动 cd <npm目录> && dsh web 才能成功
端口监听 ≠ 服务健康：旧版只检查端口是否被占，端口被即将退出的进程占着时 PWA 会打开白屏 → v7 改为 HTTP 探测（WinHttp.WinHttpRequest.5.1，注意旧组件 MSXML2.XMLHTTP 不支持 setTimeouts），假死进程自动清理重启

卸载 / Uninstall

删除桌面快捷方式
删除 DeepSeekHarnessLauncher.vbs
如需彻底停止后台服务：任务管理器结束 node.exe 进程

更新历史 / Changelog

v7 (2026-08-30)：HTTP 存活探测（WinHttp）替代纯端口检查；端口被占但 HTTP 不通（假死进程）时自动 taskkill 并重启服务；每次运行写 launcher.log；修复"PWA 打开白屏/无法连接"问题
v6 (2026-08-19)：用 shell.CurrentDirectory 修复路径含空格问题；临时文件法避免 shell.Exec 管道死锁
v5 (2026-08-19)：首个发布版（端口轮询 + 90 秒等待）

许可证 / License

MIT