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 查看。