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.

패키지
dsh-native-launcher
호환성
미검증
버전
1.0.0
라이선스
MIT
최근 업데이트
2026. 9. 29.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-native-launcher

配置

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一键卸载的审计日志(刻意不随卸载清理,失败可溯源)