DSH(DeepSeek Harness)採用插件化架構,管理一套插件組合通常需要複製粘貼多條命令。在團隊協作或遷移環境時,手動逐個安裝既繁瑣也容易出錯。DSH Plugin Share 解決了這個痛點,它把一套插件清單轉換成一段可粘貼的離線分享碼,接收方只需粘貼或掃碼即可逐個安裝。
它是什麼¶
這是一個由 HGT158 維護的 DSH 客戶端插件,核心功能是離線分享。它將你當前的插件狀態(來源、版本、啓用狀態)編碼爲一段文本,發送給他人。接收方通過解析這段碼,可以批量安裝、升級或切換插件的啓用狀態。該插件本身也是純 JS、零依賴,安裝過程不會觸發構建腳本。
核心功能¶
根據已覈實的事實,該插件具備以下能力:
- 生成離線分享碼:將當前 profile 中的插件清單轉換爲文本。
- 二維碼導出與導入:支持導出 SVG 矢量圖或 PNG 位圖,也支持通過圖片或手機掃碼直接導入。
- 完整的插件操作:支持安裝、升級、啓用、停用操作。
- 離線自包含:編解碼、校驗、二維碼生成均在本地完成,不依賴外部服務。
- 僅清單模式:分享碼只包含插件來源和版本信息,不包含配置文件、API Key 等敏感數據。
- 逐條預覽與確認:導入前會逐行列出插件詳情,用戶可確認每個動作後再執行。
- 拒絕構建腳本:默認拒絕需要構建腳本的包,需要時才顯式批准。
- CRC32 校驗:碼包含校驗信息,防止傳輸過程中的損壞,但不是簽名,無法防篡改。
安裝與啓用¶
在 Web profile 環境下安裝此插件:
dsh plugin --profile web add 'github:HGT158/dsh-plugin-share#main'
dsh --profile web
安裝完成後,打開 Harness Web,進入 設置 → 內置插件 → 插件分享。安裝後需要重啓 dsh 才能生效(瀏覽器建議按 Ctrl+F5 強制刷新)。
典型用法¶
1. 導出分享碼
在插件分享面板中,點擊「從當前 profile 導出」。文本框會出現以 D1 開頭的碼,點擊「複製」即可發送。也可以點擊「展示二維碼」生成圖片,支持保存爲 SVG 或 PNG。
2. 解析並導入
將碼粘貼到文本框,點擊「解析組合碼」。下方會逐行列出插件信息。每一行右側有對應的按鈕:
- 安裝:本機沒有該插件。
- 升級:本機已有舊版本。
- 啓用 / 停用:插件已存在但狀態不一致。
- 已是當前版本:無需操作。
3. 掃碼導入
直接點擊「掃碼導入」,選擇一張二維碼圖片或直接拖入圖片,識別出的碼會自動填入並解析。
4. 更新
使用 update 命令升級到最新版:
dsh plugin --profile web update dsh-plugin-share
適用場景與注意¶
- 接收方環境:接收方必須已經安裝了 DSH Plugin Share 插件,才能使用導入功能。
- Profile 限制:僅支持 Web profile。桌面 profile 無法通過 CLI 安裝此插件。
- 安全性:分享碼不包含配置信息,也不會傳播構建腳本。碼僅通過 CRC32 校驗,不具備防篡改能力,接收方需自行覈對預覽列表中的插件來源。
- 重啓生效:安裝或修改插件狀態後,必須重啓 dsh 進程才能生效。
總結¶
DSH Plugin Share 將插件分享從繁瑣的命令行操作轉化爲簡單的文本交互。通過離線碼和二維碼,它實現了環境配置的快速遷移與復現。對於需要在多臺設備或團隊間同步插件棧的開發者,這是一個高效的工具。