前言¶
使用 dsh（DeepSeek Harness）的 Web UI 時，常見流程是打開終端、執行啓動命令，再打開瀏覽器。dsh-desktop-launcher 解決的是桌面入口問題：macOS 上生成 ~/Desktop/dsh.app，Linux 上生成 ~/.local/share/applications/dsh.desktop。雙擊入口後，可啓動 Web UI 並打開瀏覽器。
它只處理桌面側，不安裝終端命令，也不修改 PATH。
這是什麼¶
dsh-desktop-launcher 是 LvienOeria 維護的一個 dsh 插件，許可證爲 MIT。它的作用是給 dsh 安裝一個桌面雙擊啓動器，適合需要把 Web UI 做成桌面入口、但不想額外安裝終端命令的使用者。
核心功能¶
生成物¶
1、macOS 生成：
~/Desktop/dsh.app
雙擊 dsh.app 可啓動 Web UI，並自動打開瀏覽器。
2、Linux 生成：
~/.local/share/applications/dsh.desktop
它作爲應用菜單入口使用。
3、生成啓動腳本：
~/.dsh-launcher-desktop/dsh-start.command
該腳本用於輪詢 Web UI 地址並打開瀏覽器。
圖標與體積¶
- 內置
whale與whale-dark兩個 1024px PNG 圖標。 - 零依賴，包體積約 147 KB。
邊界¶
- 只碰桌面側，不安裝終端命令。
- 不修改
PATH。 - 終端命令在獨立的
dsh-launcher包中。 - 不支持 Windows；在 Windows 上不會安裝任何文件，只打一條警告。
安裝與啓用¶
前置條件¶
需要 dsh CLI 和 pnpm >= 9。如果當前環境中的 pnpm 版本較舊，可執行：
corepack enable
安裝插件¶
從 npm 安裝：
dsh plugin --profile web add dsh-desktop-launcher
從 GitHub 安裝：
dsh plugin --profile web add github:LvienOeria/dsh-desktop-launcher
本地路徑安裝：
dsh plugin --profile web add ./dsh-desktop-launcher
生成啓動器¶
安裝完成後，啓動一次 dsh：
dsh --profile web
如果當前目錄是源碼目錄，也可以使用：
pnpm dsh web
啓動後，macOS 桌面會出現 dsh.app；Linux 的應用菜單中會出現 dsh.desktop 對應的入口。
典型用法¶
自定義啓動器¶
插件支持以下配置項：
launcherName：桌面應用或入口名稱。iconStyle：內置圖標樣式，可用whale或whale-dark。iconFile：自定義圖標文件路徑。url：要輪詢並打開的 Web UI 地址。sourceDir：源碼目錄。startCommand：自定義啓動命令。autoOpenBrowser：是否自動打開瀏覽器。
這些配置用於調整啓動器名稱、圖標、目標地址、啓動命令和瀏覽器打開行爲。
安全與卸載¶
安全提示¶
- 插件會管理自己生成的文件；沒有
managed by dsh-desktop-launcher vX標記的已有文件或應用，會先備份爲<path>.bak再替換。 - 非法配置會直接報錯。
- 安裝失敗只打日誌，不會拖垮 harness。
- macOS 首次啓動時可能遇到 Gatekeeper，需要手動選擇打開。
- 插件由 dsh 加載後在本機生成桌面文件，運行權限取決於當前 dsh 進程。安裝前應檢查源碼和 MIT 許可證，只從可信來源安裝。
卸載¶
先移除插件：
dsh plugin --profile web remove dsh-desktop-launcher
再刪除插件生成的文件：
rm -rf ~/.dsh-launcher-desktop ~/Desktop/dsh.app
Linux 上如果使用了應用菜單入口，可額外刪除：
rm -f ~/.local/share/applications/dsh.desktop
結尾¶
dsh-desktop-launcher 的能力比較集中：把 dsh Web UI 的桌面入口做輕、做乾淨。適合只想要 macOS/Linux 桌面雙擊啓動、不想捆綁終端命令的使用者。
GitHub 倉庫：https://github.com/LvienOeria/dsh-desktop-launcher
