前言¶
在 DeepSeek Harness (DSH) 的開發流程中，pnpm dsh web 是啓動本地開發服務器的標準命令。但在實際使用中，保持終端窗口打開以維持服務器運行、更新代碼後手動重啓、以及從日誌中提取令牌化 URL，都構成了繁瑣的儀式性操作。DSH Launcher 旨在解決這一問題，將服務器的啓動、重啓、停止以及瀏覽器跳轉等操作封裝爲 macOS 菜單欄應用，無需終端介入即可管理開發服務器。
是什麼¶
songer522/dsh-launcher 是一個針對 DeepSeek Harness 的 macOS 菜單欄工具。它允許開發者在菜單欄中直接控制本地開發服務器的生命週期（啓動、停止、重啓），無需打開終端或保持標籤頁打開。該工具包含一個配套的 DSH 插件，用於將運行中的服務器端口、進程 ID (PID) 和令牌化 URL 發佈給菜單欄應用。
核心功能¶
- macOS 菜單欄應用：應用以狀態欄圖標形式存在，無 Dock 圖標，常駐後臺。
- 無需終端操作：支持啓動、重啓和停止服務器，所有操作通過菜單或點擊完成。
- 信息發佈：通過配套 DSH 插件，自動獲取服務器的運行端口、進程 ID (PID) 和令牌化 URL。
- 高度可配置：支持自定義啓動命令、端口號、工作目錄和默認瀏覽器。
- 原生實現：基於原生 AppKit 開發，單 Swift 文件實現，無外部依賴。
安裝與啓用¶
安裝前需確保環境滿足以下條件：macOS 13+ 以及已安裝 Xcode 命令行工具。
- 安裝 DSH 插件（推薦）：
插件默認安裝到web配置文件中。
dsh plugin --profile web add https://github.com/songer522/dsh-launcher/releases/latest/download/dsh-menubar-launcher.tgz
安裝後需重啓服務器以使插件生效。
- 安裝菜單欄應用：
從 GitHub 倉庫克隆代碼並執行構建腳本。
git clone https://github.com/songer522/dsh-launcher.git
cd dsh-launcher
./build.sh
構建後的應用會自動安裝到 /Applications 並在菜單欄顯示。
配置說明¶
配置文件位於 ~/.config/dsh-launcher/config。首次運行時，應用會嘗試在常見工作目錄中查找 DeepSeek Harness 項目（如 ~/Workspace、~/Projects 等）。如果項目位置不同，可在應用的偏好設置中手動指定。
配置項包括：
* repo：工作目錄
* command：啓動命令，支持 {port} 佔位符
* port：監聽端口
* browser：默認瀏覽器
* logFile：日誌文件路徑
注意事項¶
- 插件依賴：菜單欄應用在沒有插件的情況下也能工作，它會讀取自己啓動的服務器的日誌來獲取端口和 PID。但爲了支持從終端啓動的服務器，推薦安裝插件。
- 權限運行：插件以當前 DSH 進程的權限運行，請確保從可信來源安裝並檢查源碼。
- 配置文件：插件配置文件位置爲
~/.config/dsh-launcher/runtime.json。若配置文件不存在，說明服務器未重啓或未運行。 - 狀態欄交互：菜單欄圖標每 3 秒輪詢一次服務器狀態，運行時爲實心，停止時爲變暗。
結語¶
DSH Launcher 將 DeepSeek Harness 的終端啓動儀式轉化爲菜單欄的一鍵操作，減少了維護服務器狀態的精力消耗。對於頻繁使用 DSH 進行本地開發的 macOS 用戶，這是一個提升效率的實用工具。
目錄鏈接：https://www.skillhub.cn/plugins/songer522/dsh-launcher
GitHub 鏈接：https://github.com/songer522/dsh-launcher
