前言¶
DSH 的理念是「一切皆插件」。對智能體開發者來說，啓動 harness 的常見做法是先執行 CLI 或源碼命令；如果需要從終端一鍵啓動，並自動打開瀏覽器，可以安裝 dsh-launcher。下面介紹它的定位、安裝方法、配置項和注意事項。
這是什麼¶
dsh-launcher 是一個輕量的 dsh（DeepSeek Harness）插件：安裝一個終端命令，輸入 dsh-go 即可啓動 harness 並自動打開瀏覽器。
它零依賴，包體積約 9 KB。倉庫路徑爲 LvienOeria/dsh-launcher，許可證爲 MIT。桌面雙擊版在獨立包 dsh-desktop-launcher。
核心功能¶
生成終端命令與啓動腳本¶
插件以 bundle 方式加載。插件 apply 會在每次 harness 啓動時收斂生成產物；配置未變時爲空操作。
生成的文件包括：
- 啓動腳本：
~/.dsh-launcher/dsh-start.command - 終端命令：
~/.local/bin/dsh-go
安裝來源¶
支持從 npm、GitHub 或本地路徑安裝。
可配置項¶
可通過 profile patch 配置以下項目：
command
url
sourceDir
startCommand
autoOpenBrowser
ensurePath
啓動命令解析順序¶
啓動命令按下面順序解析：
1、startCommand
2、sourceDir
3、源碼目錄
4、PATH 上的 dsh CLI
5、回退 dsh --profile web
安全與失敗處理¶
- 對已有文件，如果沒有
managed by dsh-launcher標記，會先備份爲.bak再替換。 - 非法配置會報錯。
- 安裝失敗只記錄日誌，不導致 harness 啓動失敗。
安裝與啓用¶
前置條件是 dsh CLI 和 pnpm >= 9。harness 固定 pnpm 11；如果本機版本較舊，可執行：
corepack enable
先確認已滿足前置條件，再從 npm 安裝：
dsh plugin --profile web add dsh-launcher
如果從 GitHub 安裝：
dsh plugin --profile web add github:LvienOeria/dsh-launcher
如果本地已有插件目錄：
dsh plugin --profile web add ./dsh-launcher
安裝後啓動一次 harness，插件會據此生成啓動器：
dsh --profile web
# 或
pnpm dsh web
經過上面的步驟，終端裏就可以使用 dsh-go。
典型用法¶
在終端中啓動：
dsh-go
停止方式是關閉終端窗口，或按 Ctrl+C。
需要修改啓動命令、URL、路徑或瀏覽器行爲時，編輯 profile patch 文件：
~/.dsh/profiles/<profile>/cordis.patch.yml
後層覆蓋前層。示例如下：
- id: dsh-launcher
config:
command: dsh-go
url: "<Web UI 地址>"
sourceDir: "<harness 源碼目錄>"
startCommand: ""
# autoOpenBrowser: true/false
# ensurePath: true/false
這裏只列出可配置項，實際值按自己的 Web UI 地址、源碼目錄和 shell 配置填寫。
command 是終端命令名，默認是 dsh-go，不佔用 harness CLI 的 dsh 命令名。
適用場景與注意¶
適合需要在終端裏一鍵啓動 DSH Web UI，並且不想要桌面應用的場景。
注意：
- 不支持 Windows：不會安裝任何文件，只打一條警告。
- 該插件以當前 dsh 進程權限運行；它會生成本地文件，安裝前應檢查倉庫源碼和 MIT 許可證。
- 狀態哈希保存在
~/.dsh-launcher/state.json。
資料給出的卸載命令如下：
dsh plugin --profile web remove dsh-launcher
rm -rf ~/.dsh-launcher ~/.local/bin/dsh
其中 rm -rf ~/.local/bin/dsh 與默認命令 dsh-go 的對應關係未進一步說明。
短結尾¶
dsh-launcher 的作用是把 harness 啓動收斂爲一個 dsh-go 命令，同時保持零依賴和約 9 KB 的包體積。
GitHub 倉庫：https://github.com/LvienOeria/dsh-launcher
已覈實資料未提供目錄頁 URL，本文不列出不確定的鏈接。
