Web 界面自启 Hushverse/dsh-web-autostart

DSH Web 自启动

为 DeepSeek Harness 的浏览器界面 dsh web 做一个小工具，实现开机自启动 + 桌面快捷方式：登录 Windows 后在后台静默把 Web UI 拉起来，并自动打开浏览器。

不用每次手动敲 npx @deepseek-ai/dsh web。

English README · MIT License

特性

| 特性 | 说明 |
| 开机自启 | 登录后在后台静默启动，看不到任何黑窗口 |
| 桌面/开始菜单快捷方式 | 双击即用，已启动时只重新打开浏览器，不会重复起进程 |
| 单实例保护 | 端口已在服务时什么都不做，避免多个实例抢同一份会话存储 |
| 认证友好 | 启动时交给 dsh web 自己用带 token 的地址打开浏览器；已在运行时复用并校验日志里的 token URL |
| 双启动模式 | 优先「分离模式」；若系统拒绝分离子进程，自动降级为「守护模式」，必定能起来 |
| 日志 | 标准输出/错误追加写入 %LOCALAPPDATA%\dsh-web\logs，并自动按 5 MB 轮转 |
| 无需配置 PATH | 自动把 node.exe 与 dsh 解析成绝对路径，登录时的精简环境也能跑 |
| 失败可见 | 静默启动失败时弹出提示框，不会「默默什么都没发生」 |
| 停止干净 | 停止时结束整棵进程树，端口占用者用 netstat 兜底定位，不留孤儿进程 |
| 一键卸载 | 只删快捷方式，不碰你的会话数据和 DSH 本体 |

快速开始

1) 安装：创建开机自启 + 桌面 + 开始菜单快捷方式 powershell -ExecutionPolicy Bypass -File .\install-autostart.ps1

2) 立刻启动一次（可选） powershell -ExecutionPolicy Bypass -File .\dsh-web.ps1

3) 卸载 powershell -ExecutionPolicy Bypass -File .\install-autostart.ps1 -Uninstall

也可以直接双击 install-autostart.cmd / start-dsh-web.cmd / uninstall-autostart.cmd。

装好之后：

* 开机：自动静默启动，浏览器自动打开
* 桌面「DSH Web」：随时一键启动/唤起
* 开始菜单「DSH Web - Status」：看一眼端口、PID、日志路径
* 开始菜单「DSH Web - Stop」：关掉由本工具启动的实例

文件说明

dsh-web.ps1 核心启动器（启动 / 状态 / 停止 / 干跑） dsh-web-hidden.vbs 无窗口启动壳，供快捷方式与开机自启使用 start-dsh-web.cmd 手动启动（带控制台，方便看输出） stop-dsh-web.cmd 停止 status-dsh-web.cmd 状态 install-autostart.ps1 安装快捷方式 + 开机自启 uninstall-autostart.cmd 卸载入口 publish-to-github.ps1 一条命令建仓并推送到 GitHub（配合 gh） tests/smoke-test.ps1 自检脚本（用假服务器跑通全流程） tests/fake-dsh-bin.js 自检用的假 dsh（只监听端口）

工作原理

登录 / 双击 └─ wscript.exe dsh-web-hidden.vbs （0 号窗口 = 完全隐藏） └─ powershell -File dsh-web.ps1 -ErrorPopup ├─ 端口 3080 已在服务？ → 直接打开浏览器，退出 ├─ 解析 node.exe 与 @deepseek-ai/dsh 的绝对路径 ├─ 分离模式：Start-Process -WindowStyle Hidden │ └─ 端口就绪后记录 PID，启动器退出（最省资源） └─ 分离失败？ → 守护模式 └─ 用 cmd /c 命令行启动服务器（日志由 cmd.exe 重定向），服务器是本进程的子进程；启动器即守护进程

几个刻意的设计选择：

* 为什么有「守护模式」：Start-Process -WindowStyle Hidden 在绝大多数 Windows 上都没问题，但在被安全软件/沙箱严格限制的机器上，分离出来的子进程会以 0xC0000142（STATUS_DLL_INIT_FAILED）立刻退出。这种情况下守护模式（子进程直接挂在隐藏的 PowerShell 下）永远可用，代价是这个隐藏进程会一直存在，服务随它一起退出。
* 为什么日志交给 cmd.exe 重定向：PowerShell 自己的 >> 会走管道，某些受限环境不允许创建管道；cmd.exe 用的是普通文件句柄，兼容性更好。
为什么用命令行而不是 .cmd 文件启动服务器：批次文件是按控制台代码页解码的，路径里只要有中文（比如项目放在「项目」这类目录下）就会被写成 ? 导致启动失败；而命令行是以 Unicode 交给 cmd.exe 的。项目与日志路径全为 ASCII 时，会额外生成一个 run-server.cmd，方便你手动运行。
* 为什么停止要杀整棵树：守护模式下真正在跑的服务是孙子进程，只杀父进程可能留下孤儿；-Stop 会 taskkill /T 整棵树，再用 netstat 兜底定位仍占着端口的进程，且只对 node / powershell / pwsh / cmd 下手。
* 为什么把浏览器交给 dsh web 打开：DSH 的 Web 根路径需要进程 token 或它换来的 Cookie，自己拼一个干净 URL 在无 Cookie 的浏览器里只会看到 401。交给 dsh web 自己打开，它带的就是能认证的地址；只有在「已在运行」这条路径上，工具才需要自己去日志里找 token，并且会先校验。
* 为什么不注册成 Windows 服务：DSH 的凭据、会话、插件都放在当前用户的 %DSH_HOME% 下，用系统账户跑服务会看不到你已有的会话，得不偿失。

dsh-web.ps1 参数

| 参数 | 默认值 | 说明 |
| -Port | 3080 | 监听端口，dsh web --port |
| -BindHost | 127.0.0.1 | 监听地址，建议保持本机回环 |
| -NoBrowser | 关 | 不自动打开浏览器 |
| -SpawnMode | Auto | Auto / Detached / Attach |
| -Status | | 打印端口、PID、解析到的路径与日志尾部 |
| -Stop | | 停止本工具启动的实例（必要时连带清理仍占着端口的进程） |
| -DryRun | | 只解析并打印将要执行的命令，不启动任何东西 |
| -DshBin | 自动探测 | 手动指定 ...\@deepseek-ai\dsh\lib\bin.js |
| -NodeExe | 自动探测 | 手动指定 node.exe |
| -DataDir | %LOCALAPPDATA%\dsh-web | PID 文件与日志目录 |
| -WaitSeconds | 180 | 等待端口就绪的最长秒数 |
| -ErrorPopup | 关 | 失败时弹窗（静默模式使用） |

dsh 的查找顺序：

1. %APPDATA%\npm\node_modules\@deepseek-ai\dsh（全局安装）
2. 当前 dsh 命令所在的 node_modules
3. %LOCALAPPDATA%\npm-cache\_npx\\node_modules\@deepseek-ai\dsh（npx 缓存，取最新）

想让启动更快、离线也能用，建议装一次全局：npm install -g @deepseek-ai/dsh

常见问题

Q：装了以后开机没反应？
先看 %LOCALAPPDATA%\dsh-web\logs\dsh-web.out.log；再运行 status-dsh-web.cmd。若日志为空且端口没开，多半是没找到 dsh —— 执行 npm install -g @deepseek-ai/dsh 后重跑安装脚本。

Q：端口 3080 被别的程序占了？
install-autostart.ps1 -Port 8080 重新安装即可（或直接给 dsh-web.ps1 -Port 8080）。

Q：我手动跑着 npx @deepseek-ai/dsh web，会冲突吗？
不会。启动器检测到端口已在服务就只打开浏览器，不会起第二个实例。

Q：怎么改「开机只启动、不自动开浏览器」？
install-autostart.ps1 -NoBrowser 重新安装，参数会写进快捷方式。

Q：把项目文件夹挪走了？
快捷方式里存的是绝对路径，挪动后请重新运行 install-autostart.ps1。

Q：会不会影响我原来的 DSH？
不会。本工具不修改 DSH 本体、不改配置文件，只是在合适的时候执行等价的 dsh web 命令，卸载只删快捷方式。

Q：停止时会不会误杀别的程序？
-Stop 只处理两种目标：本工具记录的 PID（连同其子进程），以及仍占着该端口的、进程名属于 node / powershell / pwsh / cmd 的进程。别的程序占着端口只会提示，不会动它。

Q：打开后提示 dsh web authentication required？
DSH 的根路径需要两样东西之一：dsh web 启动时打印的进程 token（?token=...），或该 token 换来的浏览器 Cookie（Cookie 有效期很长，同一浏览器之后直接访问干净地址即可）。
启动服务器时本工具不加 --no-open，由 dsh web 自己用带 token 的地址打开浏览器，所以首次使用不会碰到这个问题。
若是「服务器已经在跑、你只是点快捷方式唤起」这种情况，工具会从自己的日志里取上次打印的 token URL、实际校验它当前还有效（失效的 token 会返回 401），有效就用它，无效就退回干净地址；此时运行 status-dsh-web.cmd 可以看到 token url 那一行。

发布到 GitHub

仓库已在本地初始化并完成首次提交（git log 可见 v1.0.0）。发布到你的 GitHub 账号只需三步：

winget install --id GitHub.cli -e # 没装过 gh 才需要 gh auth login # 只需一次，浏览器登录你自己的账号 powershell -ExecutionPolicy Bypass -File .\publish-to-github.ps1

脚本会调用 gh repo create 在你的账号下建一个公开仓库并推送当前提交；也可以直接双击 publish-to-github.cmd。

.\publish-to-github.ps1 -Check # 只检查 gh 是否已安装并登录 .\publish-to-github.ps1 -RepoName dsh-web-autostart # 指定仓库名 .\publish-to-github.ps1 -Visibility private # 改成私有仓库

不想用 gh，手动推送也可以：

cd "C:\Users\MECHREVO\PycharmProjects\PythonProject\项目\deepseek harness自启动程序"
git remote add origin https://github.com//dsh-web-autostart.git
git push -u origin main

仓库里已经准备好了 LICENSE（MIT）、.gitignore、双语 README 和 CHANGELOG.md。
推之前如果想把署名换成自己的，改 LICENSE 里的版权人一行，并设置 git config user.name / user.email。

自检

powershell -ExecutionPolicy Bypass -File .\tests\smoke-test.ps1

用 tests/fake-dsh-bin.js 当假服务器，在测试端口上跑一遍「启动 → 状态 → 停止」，不会碰你真实的 DSH 会话。

兼容性

Windows 10 / 11，Windows PowerShell 5.1（系统自带）与 PowerShell 7 均可
* 需要已安装 Node.js（node.exe）与 @deepseek-ai/dsh（全局或 npx 缓存均可）
* 不写注册表、不装服务、不需要管理员权限

许可

MIT