前言¶

使用 DSH 的 Web GUI 時，通常先啓動 dsh web，再通過瀏覽器訪問。如果你希望它更像桌面應用：啓動後打開一個獨立的應用窗口，關閉這個窗口就讓整個 DSH 進程優雅退出，可以安裝 dsh-app-launcher。

下面介紹它的能力、安裝命令和配置項。

這是什麼¶

dsh-app-launcher 是一個 DSH profile bundle，包名爲 dsh-app-launcher，倉庫地址是 https://github.com/Alvin-Somedo/dsh-app-launcher，許可證爲 MIT。

它的作用是：

• 以獨立應用窗口打開 DSH Web GUI；
• 用專用瀏覽器配置目錄打開 Chrome/Edge 應用窗口，不影響日常瀏覽器；
• 窗口 URL 自帶進程 token，用於 dsh web 首頁請求認證；
• 關閉窗口後調用 appExit(0)，讓 DSH 進程優雅退出；
• 可作爲 DSH profile bundle 從 GitHub 或 npm 安裝。

核心功能¶

獨立應用窗口¶

插件使用專用瀏覽器配置目錄打開 Chrome/Edge 應用窗口。配置項 browser 可選擇 auto、chrome、edge。

認證窗口 URL¶

窗口 URL 自帶進程 token。dsh web 首頁請求需要認證，不帶 token 只會看到未認證頁。

關窗退出¶

關閉應用窗口後，插件調用 appExit(0)，DSH 進程優雅退出。

Windows 桌面快捷方式¶

在 Windows 下默認開啓 createShortcut，會自動生成桌面 DSH.lnk 一鍵啓動快捷方式。

dsh.ico 與桌面 DSH.lnk 已存在時不會被覆蓋；start-dsh.vbs 版本不一致時會自動重建。

關閉拼寫檢查¶

默認關閉應用窗口拼寫檢查。

記住窗口狀態¶

默認記住應用窗口的大小、位置和最大化狀態，並在下次啓動時恢復。

最大化恢復只傳 --start-maximized，不傳位置/尺寸。

安裝與啓用¶

安裝前需要 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 app-launcher 覆蓋 config。

不要寫 insert，插件行由 bundle 自帶。

- id: app-launcher
  config:
    enabled: true
    openOnStart: true
    exitOnClose: true
    browser: auto
    disableSpellcheck: true
    rememberWindow: true
    createShortcut: true

這些配置項用於控制：

• enabled：是否啓用插件；
• openOnStart：啓動時是否打開窗口；
• exitOnClose：關閉窗口時是否退出 DSH；
• browser：選擇 auto、chrome、edge；
• disableSpellcheck：是否關閉應用窗口拼寫檢查；
• rememberWindow：是否記住窗口大小、位置和最大化狀態；
• createShortcut：Windows 下是否生成桌面快捷方式。

卸載與升級¶

卸載：

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

適用場景與注意¶

適合：

• 希望把 dsh web 作爲桌面應用式入口；
• 希望關閉應用窗口即結束 DSH 進程；
• 希望應用窗口使用獨立瀏覽器配置，不影響日常瀏覽器；
• 在 Windows 下使用桌面快捷方式啓動 DSH。

注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼和許可證（MIT）。
• 安裝後需要下次啓動 dsh web 才生效。
• 窗口 URL 需要進程 token；不帶 token 只會看到未認證頁。
• createShortcut 爲 Windows 相關行爲，默認開啓。
• 在 cordis.patch.yml 中覆蓋配置時不要寫 insert。
• DSH 社區目錄是獨立站點，不等同於 DeepSeek/幻方官方應用商店。

結尾¶

經過上面的步驟，dsh-app-launcher 可以把 DSH Web GUI 打開爲獨立應用窗口，並在關閉窗口時通過 appExit(0) 優雅退出 DSH 進程。它主要解決的是“啓動入口、瀏覽器隔離、關窗退出”這幾件具體事情。

GitHub：https://github.com/Alvin-Somedo/dsh-app-launcher

目錄頁：本次已覈實資料未給出具體 URL，可按包名 dsh-app-launcher 在 DSH 社區目錄中檢索。