dsh-launcher: 为 DSH Web 创建 Windows 桌面快捷方式

前言¶

在使用 DSH Web 进行开发时，每次打开工作台都需要先打开终端、切换到项目目录并执行 dsh web，这会打断工作流。dsh-launcher 是一个由 NoMindSama 维护的 DSH 插件，用于在 Windows 桌面自动创建快捷方式，实现双击直达工作页面。

该插件通过 dsh plugin 命令安装，不会修改 DSH Web 的原生功能（如聊天、侧栏、设置），仅负责桌面快捷方式的创建与启动编排。

核心功能¶

一键直达：双击桌面快捷方式即可进入 DSH Web 工作页面。
智能状态判断：如果 DSH Web 已运行，直接打开页面；如果未运行，自动在工作目录中启动 dsh web。
自动识别端口：优先读取 DSH 实际监听端口，默认回退到 3080。
可配置项：支持配置工作目录、快捷方式名称、图标以及桌面路径。
原生实现：仅依赖系统自带的 Windows PowerShell，无需额外运行时。
幂等安装：每次 DSH 启动时会检查并更新快捷方式，不会产生重复图标。
平台兼容：当前版本仅支持 Windows，非 Windows 平台会安全跳过。

安装与启用¶

在安装前，请确保环境满足以下要求：
* 操作系统：Windows 10 或 Windows 11
* Node.js 版本：>= 20
* 工具：已安装 pnpm 并在 PATH 中

执行以下命令安装插件：

dsh plugin --profile web add github:NoMindSama/dsh-launcher

安装完成后，重启 DSH Web：

dsh web

DSH 启动时会自动在桌面创建名为 DSH 工作台 的快捷方式。

使用与配置¶

安装并重启 DSH 后，双击桌面上的 DSH 工作台 快捷方式即可使用。

配置示例¶

你可以通过 profile patch 配置快捷方式的行为。例如，在 profiles/web/cordis.patch.yml 中添加：

- id: dsh-launcher
  config:
    workspace: "E:\\projects\\my-dsh-workspace"
    port: 3080
    shortcutName: "DSH 工作台"
    dshCommand: "C:\\Users\\you\\AppData\\Roaming\\npm\\dsh.cmd"
    desktop: "C:\\Users\\you\\Desktop"

配置项说明：
* workspace：指定 dsh web 启动时的工作目录。
* port：DSH Web 默认端口，实际运行时会优先使用真实监听端口。
* shortcutName：桌面快捷方式的名称。
* dshCommand：dsh 可执行文件的路径。
* desktop：桌面目录路径，支持 OneDrive 重定向。

注意事项¶

该插件仅在 Windows 平台生效。安装后，DSH 会将脚本和图标文件复制到 %USERPROFILE%\.dsh\launcher\ 目录。
插件以 DSH 进程的权限运行，不会修改 DSH Web 的聊天、侧栏或设置等原生功能。
如果需要更换图标，可以替换 %USERPROFILE%\.dsh\launcher\icon.ico 文件。

总结¶

dsh-launcher 将繁琐的终端启动命令转化为桌面操作，降低了 DSH Web 的使用门槛。通过原生 PowerShell 实现，它轻量且稳定。所有源码与文档可在 GitHub 查看。