dsh-launcher: DeepSeek Harness 一鍵啓動器

前言¶

DeepSeek Harness 生態強調“一切皆插件”。在進行智能體開發或調試時，通常需要手動檢查後臺進程是否運行、啓動 dsh web、等待服務就緒，最後再打開瀏覽器。這些步驟重複且耗時。dsh-launcher 通過自動化這一流程，減少手動操作。

這是什麼¶

dsh-launcher 是 DeepSeek Harness 的一鍵啓動器，由 shaun5297 維護。

它提供兩種形態：
1. CLI 工具：提供 dsh-launcher 命令，用於檢測後臺狀態、啓動服務、等待就緒並打開瀏覽器。
2. Harness 插件 Bundle：通過 dsh plugin add 安裝後，爲 agent 提供 harness_launch 工具，讓 agent 能夠自行拉起或恢復 Harness 環境。

該工具僅依賴 dsh-tools，無其他運行時依賴。

核心功能¶

• 自動化流程：檢測後臺 → 啓動 dsh web → 等待就緒 → 打開 Chrome。
• 插件集成：提供 harness_launch 工具，嵌入到 Harness 插件生態中。
• 零依賴：僅依賴 @deepseek-ai/dsh-tools。
• 跨平臺：macOS 和 Windows 支持完整；Linux 代碼已適配。
• 桌面快捷方式：支持生成 .command（macOS）、.cmd（Windows）或 .desktop（Linux）文件。
• 環境變量配置：支持自定義監聽地址、端口和瀏覽器。

安裝與啓用¶

作爲 CLI 工具¶

全局安裝：

npm install -g git+https://github.com/shaun5297/dsh-launcher.git

安裝後即可使用 dsh-launcher 命令。

作爲 Harness 插件¶

在 Harness 環境中添加插件：

dsh plugin --profile web add dsh-launcher

刷新頁面或重啓 dsh web 後，agent 即可獲得 harness_launch 工具。

典型用法¶

基礎操作¶

# 檢測後臺 → 啓動（若未運行）→ 等待就緒 → 打開 Chrome
dsh-launcher

# 等價寫法
dsh-launcher start

# 後臺已在運行時，僅打開主頁面
dsh-launcher open

# 查看後臺狀態（-- 輸出標準格式）
dsh-launcher status
dsh-launcher status --

高級選項¶

# 生成桌面快捷方式
dsh-launcher make-shortcut

# 指定端口和補丁文件
dsh-launcher --port 3080 --patch ./enable-skills.yml

# 演練模式：打印命令但不執行
dsh-launcher --dry-run

環境變量¶

插件支持以下環境變量覆蓋默認配置：

注意事項¶

• 平臺實測：macOS 和 Windows 支持完整已實測。Linux 平臺代碼已適配但未實測。
• macOS 權限：首次運行生成的 .command 文件時，若被系統攔截，需在“系統設置 → 隱私與安全性”中允許執行權限，或右鍵選擇打開。
• 依賴項：需要 Node.js >= 18，並依賴 @deepseek-ai/dsh-tools。
• 許可證：MIT 許可證。