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

dsh-web-launcher

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

一个用于 DeepSeek Harness (DSH) Web GUI 的 Windows 桌面快捷方式 + 自动更新启动器:双击即可打开,不用再手动输入 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(不自动开浏览器) |

install.ps1

| 参数 | 默认值 | 说明 |
|---|---|---|
| -WorkspaceRoot | 当前目录 | 作为 DSH 工作区根目录(写进快捷方式的"起始位置") |
| -ShortcutName | DeepSeek Harness | 快捷方式名称 |
| -LauncherPath | 同目录 start-dsh-auto.ps1 | 启动器脚本路径 |
| -StartMenu | 关 | 创建到开始菜单而不是桌面 |
| -Uninstall | 关 | 删除该快捷方式 |

常见问题

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

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。