dsh-app-launcher

Readme

# 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 安装(推荐)

```bash
dsh plugin --profile web add github:Alvin-Somedo/dsh-app-launcher
```

### 从 npm 安装

```bash
dsh plugin --profile web add dsh-app-launcher
```

安装后**下次启动生效** `dsh web`(或 `npx @deepseek-ai/dsh web`)生效。

## 配置

在 `~/.dsh/profiles/web/cordis.patch.yml` 里按 id 覆盖(**不要写 `insert`,插件行由 bundle 自带**):

```yaml
- 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`
内嵌插件版本标记,升级后下次启动发现版本不一致会自动重建,因此启动命令的调整随升级自动生效。
桌面快捷方式只负责"不打开终端也能启动";窗口打开与关窗退出仍由插件完成。

## 卸载

```bash
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 新标签)。