dsh-app-launcher
把 DSH Web GUI 变成"桌面应用":以独立应用窗口打开,关闭窗口即优雅退出整个 DSH 进程(appExit),npx/cmd 包装进程随之自动结束;Windows 下默认还会在桌面 自动生成 DSH.lnk 一键启动快捷方式。
行为
1. web 服务器绑定成功(webServer 服务出现)后,用 专用浏览器配置目录 (<DSH_HOME>/app-window/<browser>)打开 Chrome/Edge 应用窗口,不影响日常浏览器; 2. 关闭该窗口 → 插件调用 appExit(0) → DSH 进程优雅退出(先 dispose 整棵树); 3. Windows: createShortcut(默认开启)自动生成桌面快捷方式(详见下方); 4. disableSpellcheck(默认开启):应用窗口里不再出现红色拼写波浪线——注入页面的 脚本把输入框的 spellcheck 置为 false(随界面重渲染自动维持),并把配置目录里 "在网页上输入文字时检查是否有拼写错误"总开关对应的偏好设为关闭; 5. rememberWindow(默认开启):记住应用窗口的大小和位置——页面探针定期把窗口 几何(screenX/screenY/outerWidth/outerHeight)上报给本地路由并落盘,下次启动 用 --window-size/--window-position 原样恢复。
安装
需要 pnpm:npm i -g pnpm 或 corepack enable。
从 GitHub 安装(推荐)
dsh plugin --profile web add github:Alvin-Somedo/dsh-app-launcher从 npm 安装
dsh plugin --profile web add dsh-app-launcher安装后下次启动生效 dsh web(或 npx @deepseek-ai/dsh web)生效。
配置
在 ~/.dsh/profiles/web/cordis.patch.yml 里按 id 覆盖(不要写 insert,插件行由 bundle 自带):
- id: app-launcher
config:
enabled: true # false = 完全停用
openOnStart: true # 启动时打开窗口
exitOnClose: true # 关窗即退出 DSH
browser: auto # auto | chrome | edge
# profileDir: C:\custom\profile # 自定义浏览器配置目录
disableSpellcheck: true # 默认开启:应用窗口关闭拼写检查(页面级 spellcheck=false + 配置目录偏好);false = 关闭
rememberWindow: true # 默认开启:记住窗口大小/位置,下次启动恢复;false = 关闭
# windowStateFile: ... # 窗口几何状态文件,默认 <DSH_HOME>/app-window/window-state.json
createShortcut: true # 默认开启:启动时自动在桌面创建"隐藏启动 DSH"快捷方式(仅 Windows);false = 关闭
# shortcutName: DSH # 快捷方式名(不含 .lnk),默认 DSH
# launcherDir: ... # 生成的 start-dsh.vbs / dsh.ico 存放目录,默认 <DSH_HOME>/launcher
# desktopDir: ... # 快捷方式生成位置,默认真实桌面createShortcut(默认开启)会生成:
<DSH_HOME>/launcher/start-dsh.vbs— 隐藏启动npx --yes @deepseek-ai/dsh web --no-open
(--no-open 阻止 DSH 另开默认浏览器,窗口由插件打开);
<DSH_HOME>/launcher/dsh.ico— 内置的 DSH 图标;- 桌面
DSH.lnk— 指向 wscript + 上面的 vbs。
dsh.ico 与桌面 DSH.lnk 已存在时不会被覆盖(生成时会跳过);start-dsh.vbs 内嵌插件版本标记,升级后下次启动发现版本不一致会自动重建,因此启动命令的调整随升级自动生效。 桌面快捷方式只负责"不打开终端也能启动";窗口打开与关窗退出仍由插件完成。
卸载
dsh plugin --profile web remove dsh-app-launcher或手动:从 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 移除包名, 删除 ~/.dsh/profiles/node_modules/dsh-app-launcher。
> 升级插件:dsh plugin --profile web update(或 remove 后重新 add 新标签)。