ingleav626-art/dsh-native-launcher ↗★ 6
dsh-native-launcher
dsh plugin (Windows): desktop shortcut that launches dsh web silently (hidden console) and auto-opens the browser; port-aware reconnect; settings UI section; tray with native toast notifications and close-to-exit semantics.
Install
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-native-launcherREADME
Read the full README ↗配置
cordis.patch.yml(或 profile 的 patch 层覆盖):
- id: native-launcher
config:
# 快捷方式双击后执行的启动命令(由启动脚本执行,依赖 PATH 里的 dsh;dsh 缺失时自动回退 npx --yes @deepseek-ai/dsh)
# --no-open:让官方 dsh web(rc.8 起默认自动开浏览器)让位,避免双开——浏览器由插件负责打开(已装应用优先)
launchCommand: dsh --profile web --no-open
# 是否自动打开浏览器(仅快捷方式启动且带 DSH_LAUNCHER=1 时)
autoOpen: true
# 快捷方式名称(不含扩展名)
shortcutName: DSH WebUI
# 快捷方式已存在时是否强制覆盖
force: false
# 端口探测端口(需与 webserver 端口一致)
port: 3080
# 是否启用系统托盘
tray: true
# 打开方式:app(独立窗口,默认)| new-window(新窗口)| default(浏览器默认行为)
openMode: app
# 关窗行为(桌面应用行为):所有页面窗口关闭后,无任务则优雅退出服务;有任务则驻留到完成
closeToExit: true
生成物(用户目录 ~/.dsh-webui-launcher/,日志统一在 logs/ 子目录):
排错时的一步操作:把
logs文件夹整个发过来即可(不必判断该看哪个文件)。 所有日志都在那一个文件夹里,没有第二处——主日志native-launcher.log最全,其余按组件分文件。 设置页「打开日志目录(排错用)」按钮可直接弹出该文件夹。
| 文件 | 作用 |
|---|---|
launcher.vbs | 启动入口:隐藏窗口调起启动脚本(快捷方式默认指向它) |
launcher-visible.vbs | 同上但显示窗口——排错用,可以看到启动全过程与逐行耗时 |
launch.ps1 | 就绪探测 + 启动/直连 + 拉起托盘(逐行耗时写入日志) |
launch.cmd | 同上的历史形态(v0.4.1 起默认不用,保留作回退备份) |
launch-ready.ps1 | 就绪等待辅助:后台等待服务可访问并记录时间 |
open-webui.ps1 | 多路探测打开已安装应用 / 浏览器(已运行→聚焦,未运行→启动) |
tray.ps1 | 托盘(单实例保护;打开 / 退出 WebUI;通知轮询) |
tray-state.json | 托盘运行状态(进程 / 脚本版本 / 启动时刻;用于托盘自动更新) |
tray-notify.json | 通知队列文件(插件写 → 托盘轮询发送 → 消费删除) |
webui-url.json | 带 token 的 WebUI 地址(打开页面时优先使用) |
shortcut-registry.json | 桌面快捷方式登记(卸载时定点清除) |
dsh-webui.ico | 快捷方式 / 托盘图标(官方 DSH 图标) |
logs/native-launcher.log | 主日志:启动/快捷方式/托盘/通知/关窗行为/设置/模块,含环境快照与网页端事件 |
logs/native-launcher.prev.log | 主日志的上一代(超过 1MB 自动轮转归档) |
logs/launch.log | 启动入口日志(每次双击的探测结果、逐步耗时与走向) |
logs/open-webui.log | 打开页面链日志(应用优先/聚焦/新开窗口的判定过程) |
logs/tray-exit.log | 托盘启动与退出原因记录(单实例冲突 / 正常退出) |
logs/tray-notify.log | 通知发送与失败原因 / 轮询错误 |
logs/pwa-scan.log | 应用扫描诊断日志(每次启动重写) |
logs/uninstall.log | 一键卸载的审计日志(刻意不随卸载清理,失败可溯源) |