桌面快捷启动器 mtr587/dsh-web-launcher-auto

dsh-web-launcher

给 DeepSeek Harness (DSH) Web GUI 做一个 Windows 桌面快捷方式：双击即可打开，不用每次先开 PowerShell 再敲 npx @deepseek-ai/dsh web。

一个 Windows 桌面快捷方式，外加自动更新的启动器，用来打开 DeepSeek Harness (DSH) Web GUI：双击即可打开，不用再手动敲 npx @deepseek-ai/dsh web。

它解决什么问题

| 手动敲命令 | 本启动器 |
| 每次要开终端、输命令 | 桌面双击一下 |
| 永远用缓存里的旧版本 | 每次先查最新版，有新版才安装 |
| npx 解析慢、缓存被清就失效 | 自己维护一份本地副本，启动快、可离线兜底 |
| 工作区根目录容易搞错 | 快捷方式固定工作目录（默认装的时候那个目录） |

快速开始

1) 创建桌面快捷方式(默认把当前目录作为 DSH 工作区) powershell -ExecutionPolicy Bypass -File .\install.ps1

也可以指定工作区目录 / 名称 / 放到开始菜单 powershell -ExecutionPolicy Bypass -File .\install.ps1 -WorkspaceRoot "D:\MyProject" -ShortcutName "DeepSeek Harness" powershell -ExecutionPolicy Bypass -File .\install.ps1 -StartMenu

卸载快捷方式 powershell -ExecutionPolicy Bypass -File .\install.ps1 -Uninstall

之后双击桌面上的 DeepSeek Harness 即可：

- 首次运行：提示 First run: installing DeepSeek Harness <版本> (takes a while, one time only)...，安装一次（约 1 分钟，视网速），然后自动启动界面；
- 之后每次：约 1 秒进界面；发现新版本时自动更新再启动；
- 断网：连不上 npm 仓库时，直接用本地已安装版本启动。

工作原理

双击 .lnk └─ powershell.exe -NoExit -NoLogo -ExecutionPolicy Bypass -File "start-dsh-auto.ps1" (工作目录 = 你的工作区) ├─ npm view @deepseek-ai/dsh version # 查最新版本(约 1 秒) ├─ 与 %LOCALAPPDATA%\dsh-runtime 里已装版本比较 │ ├─ 没装 / 有新版 → npm install --prefix %LOCALAPPDATA%\dsh-runtime "@deepseek-ai/dsh@<版本>" │ └─ 已是最新 → 跳过 └─ node "...\dsh-runtime\node_modules\@deepseek-ai\dsh\lib\bin.js" web

要点：

- 本地副本放在 %LOCALAPPDATA%\dsh-runtime，不在 npx 缓存里，npm cache clean 不会清掉它；
- 升级只动运行时本体，不碰 ~/.dsh（你的插件、配置、会话都在那里）；
- 关闭窗口 = 停止服务；Ctrl+C 后窗口不消失，方便看报错或重跑。

参数

start-dsh-auto.ps1

| 参数 | 默认值 | 说明 |
| -Package | @deepseek-ai/dsh | 要运行的 npm 包 |
| -RuntimeDir | %LOCALAPPDATA%\dsh-runtime | 本地副本安装位置 |
| -DshArgs | @('web') | 传给 CLI 的参数，如 -DshArgs web,--no-open（不自动开浏览器） |
| -DistTag | latest | 跟随的 npm 发布通道，见下方「发布通道」 |

install.ps1

| 参数 | 默认值 | 说明 |
| -WorkspaceRoot | 当前目录 | 作为 DSH 工作区根目录（写进快捷方式的「起始位置」） |
| -ShortcutName | DeepSeek Harness | 快捷方式名称 |
| -LauncherPath | 同目录 start-dsh-auto.ps1 | 启动器脚本路径 |
| -LauncherArgs | 空 | 追加给启动器的参数，如 "-DistTag next"（把通道钉进快捷方式） |
| -StartMenu | 关 | 创建到开始菜单而不是桌面 |
| -Uninstall | 关 | 删除该快捷方式 |

发布通道（DistTag）

DSH 官方用 npm dist-tag 分渠道发布，latest 不一定等于版本号最高的那个：

| 通道 | 含义 | 示例（实测） |
| latest | 推荐/稳定通道（默认） | 0.2.0-rc.2 |
| next | 下一版候选（发布候选 rc） | 0.2.1-rc.2 |
| alpha | 前沿预览（可能不稳定） | 0.2.1-alpha.5 |

所以「明明有更新的版本却没升级」通常是通道不同，不是启动器故障。想换通道：

临时:直接用启动器参数跑 powershell -ExecutionPolicy Bypass -File .\start-dsh-auto.ps1 -DistTag next powershell -ExecutionPolicy Bypass -File .\start-dsh-auto.ps1 -DistTag alpha

长期:把通道写进桌面快捷方式(重建一次快捷方式)
powershell -ExecutionPolicy Bypass -File .\install.ps1 -LauncherArgs "-DistTag next"

也可以不依赖启动器，直接指定确切版本安装：
npm install --prefix "$env:LOCALAPPDATA\dsh-runtime" "@deepseek-ai/dsh@0.2.1-rc.2"

常见问题

Q: 脚本里有中文吗？为什么提示都是英文？ Windows PowerShell 5.1 读取无 BOM 的 UTF-8 脚本时，会按本地 ANSI 解码。中文字节会破坏引号配对，导致语法错误。因此本仓库所有 .ps1 都是纯 ASCII。你可以放心把提示文案改成中文 —— 只要保存为 UTF-8 with BOM。

Q: 官方已经有更新的版本，为什么启动器没升级？ 见上面「发布通道」：默认只跟 latest。用 -DistTag next / -DistTag alpha 切换到候选/预览通道即可。

Q: 双击后提示端口被占用？ dsh web 默认用 127.0.0.1:3080，先停掉上一个实例（关闭它所在窗口）再启动。

Q: 启动后浏览器地址带 ?token=...，每次还不一样？ 新版 DSH 会给本地 Web 服务生成一次性访问令牌；每次启动都会换新的，旧页面的令牌随即失效。用窗口里打印（并自动打开）的那个地址即可。

Q: 想固定版本、不要检查更新？ 把 start-dsh-auto.ps1 里「查最新版本」那段换成固定版本号，或直接用：
node "$env:LOCALAPPDATA\dsh-runtime\node_modules\@deepseek-ai\dsh\lib\bin.js" web

相关仓库

- dsh-deepseek-tide —— DSH Web GUI 的 DeepSeek API 峰谷计价指示灯插件。

License

MIT — 见 LICENSE。