前言¶
在 DeepSeek Harness（DSH）中使用本地服務時，通常需要打開終端執行命令，或者手動打開瀏覽器訪問服務地址。這種手動操作在頻繁切換或需要固定訪問入口的場景下效率較低。
dsh-shortcut-creator 插件解決了這個問題。它允許用戶在 DSH 的設置頁面直接生成 Windows 桌面快捷方式，通過雙擊圖標即可啓動服務並自動打開瀏覽器，同時提供任務欄固定的能力。
插件介紹¶
該插件由 Yvesgao 維護，屬於客戶端類插件。其核心目標是簡化本地服務的啓動流程，將原本需要手動敲擊命令或打開瀏覽器的操作轉化爲桌面上的雙擊動作。
插件通過內置的 PowerShell 腳本實現快捷方式生成與任務欄固定邏輯，無需用戶進行額外的腳本編寫。
核心功能¶
插件主要提供以下四個核心能力：
-
設置頁 UI
在 DSH 設置中註冊了名爲「Desktop Shortcut」的配置區塊。用戶可以在該區塊填寫表單，包括服務名稱、啓動命令、訪問 URL 以及工作目錄。 -
Host JSON API
提供兩個 JSON API 接口：POST /plugins/desktop-shortcut/api/install：負責執行 PowerShell 引擎，生成桌面快捷方式。.../status：用於上報當前平臺狀態。
-
啓動器生成
插件會生成一個.cmd啓動器文件。- 該文件會啓動指定的服務命令，並在控制台窗口中保持存活（關閉窗口即停止服務）。
- 啓動器內置端口檢查邏輯，等待服務就緒後自動打開默認瀏覽器。
- 如果檢測到服務已在運行，則直接打開瀏覽器，避免重複啓動。
-
任務欄固定
插件會嘗試將生成的快捷方式固定到 Windows 任務欄。如果系統策略阻止了程序化固定，插件會打印兜底指引，告知用戶手動固定運行中窗口的步驟。
安裝與啓用¶
安裝該插件需要重啓 DSH 的 Web 進程。請根據環境選擇以下命令之一執行：
# 方式一：使用 GitHub 源碼安裝（推薦）
dsh plugin --profile web add github:Yvesgao/dsh-shortcut-creator#main
# 方式二：使用 npm 包安裝
dsh plugin --profile web add dsh-shortcut-creator
安裝完成後，執行 dsh web 重啓 Web 服務，然後在瀏覽器中打開設置頁面即可找到「Desktop Shortcut」區塊。
典型用法¶
- 打開 DSH 設置頁面，導航至「Desktop Shortcut」區塊。
- 在表單中填寫信息：
- 名稱：自定義快捷方式顯示的名稱（如「DeepSeek Harness」）。
- 命令：啓動服務的命令（如
node app.js）。 - URL：瀏覽器訪問的地址（如
http://localhost:3000）。 - 工作目錄：服務的運行目錄。
- 點擊「Create desktop shortcut」按鈕。
- 在桌面生成對應的
.lnk文件，雙擊即可啓動服務並自動打開瀏覽器。
注意事項¶
- 僅支持 Windows：該插件依賴 Windows 原生的 PowerShell 引擎，因此僅能在 Windows 平臺上正常使用。
- 平臺兼容性：雖然設置頁 UI 在所有平臺都會出現，但在非 Windows 平臺執行時會報錯。建議在 Windows 環境下使用。
- 權限與安全：插件以當前 DSH 進程的權限運行，建議在安裝前檢查源碼與許可證（MIT）。
