前言¶

DSH 的理念是「一切皆插件」。DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。對經常使用 DSH Web 的開發者來說，已有做法通常是：打開終端，運行 dsh web，等待服務就緒，再手動打開瀏覽器。

下面介紹 cheng249hx/dsh-one-click-launcher：一個 DSH 插件，在 Windows 桌面生成一鍵啓動本地 Harness Web 服務的快捷方式。

這是什麼¶

dsh-one-click-launcher 是面向 Windows 10/11 的 DSH 插件，倉庫位於 cheng249hx/dsh-one-click-launcher，許可證爲 MIT，package.json 版本爲 0.1.0。

它解決的是重複啓動流程：安裝並啓用後，啓動時寫入 ~/.dsh/launch-dsh.bat 啓動腳本，並在桌面創建指向該腳本的快捷方式（.lnk）。桌面快捷方式名稱默認爲 DSH Web。

運行環境要求：

• Windows 10/11
• 已安裝 dsh CLI
• 已安裝 pnpm

核心功能¶

• 啓動時寫入 ~/.dsh/launch-dsh.bat
• 創建指向啓動腳本的桌面快捷方式（.lnk）
• 默認使用黑色鯨魚圖標，並提供藍色 #4176e6 變體
• 支持使用自定義 .ico 圖標
• 啓動腳本每秒輪詢一次端口，服務就緒後打開瀏覽器
• 等待失敗時逐秒計數，120 秒後給出提示
• 零依賴、無需構建，使用純 ESM JavaScript
• 關閉最小化的 DSH Server 窗口會停止服務

安裝與啓用¶

確認 Windows 10/11 環境、dsh CLI 和 pnpm 已可用後，執行下面的安裝命令：

dsh plugin --profile web add github:cheng249hx/dsh-one-click-launcher

該命令使用 --profile web，從 GitHub 安裝插件。下面重啓 dsh web，讓插件在啓動階段生成文件：

dsh web

啓用後，插件會在啓動時寫入 ~/.dsh/launch-dsh.bat，默認圖標和啓動腳本位於 ~/.dsh，並在桌面生成默認名稱爲 DSH Web 的快捷方式。

典型用法¶

1、安裝後重啓 dsh web：

dsh web

2、雙擊桌面上的 DSH Web 快捷方式啓動服務。

3、服務啓動後，腳本會等待端口就緒並打開瀏覽器；如果等待失敗，會逐秒計數，120 秒後給出提示。

4、關閉最小化的 DSH Server 窗口可停止服務。

自定義圖標¶

有三種可復現方式。

方式一：切換內置藍色圖標。在插件配置中設置：

icon: blue

icon 用於選擇內置鯨魚圖標；blue 對應藍色 #4176e6 變體。

方式二：使用自定義 .ico。在插件配置中設置：

iconPath: 'D:\icons\my-whale.ico'

iconPath 指向一個自定義 .ico 文件。

方式三：直接在桌面快捷方式上換圖標。右鍵桌面快捷方式，打開“屬性 → 快捷方式 → 更改圖標”，選擇任意 .ico 後確定。

注意：在配置中修改 icon 或 iconPath 後，需要先從桌面刪除快捷方式，再重啓 dsh web 重新生成：

dsh web

適用場景與注意¶

適合在 Windows 10/11 上長期使用 DSH Web、希望從桌面直接啓動的開發者。

使用前注意：

• 插件以當前 dsh 進程權限運行。安裝前請檢查源碼與許可證。
• 修改配置後需要重啓 dsh web 纔會重新生成快捷方式。
• 生成的 .bat 使用純 ASCII 和 CRLF 行尾，用於兼容 Windows 多語言環境。
• DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

參考鏈接¶

目錄頁（來自插件線索）：

https://www.skillhub.cn/plugins/cheng249hx/dsh-one-click-launcher

GitHub：

https://github.com/cheng249hx/dsh-one-click-launcher