DeepSeek Harness (DSH) 採用“一切皆插件”的理念,但內置的插件列表僅展示已安裝的內容。此插件在 DSH 的設置 -> 插件頁面中新增了一個“Community plugins”標籤頁,通過本地 SQLite 目錄發現、搜索、瀏覽、過濾和安裝 GitHub dsh-plugin 話題下的社區插件。
安裝¶
在終端中執行以下命令安裝插件:
dsh plugin --profile <profile> add github:dujar/dsh-community-plugins
核心功能¶
瀏覽與發現
* 視圖切換:支持列表(豐富卡片)和網格(緊湊卡片)兩種視圖,偏好設置在瀏覽器中持久保存。
* 本地緩存:插件元數據緩存在本地 SQLite 數據庫中,瀏覽、搜索和排序均基於本地文件,響應即時且支持離線。
* 分類標籤:話題標籤按類別分組(DSH、AI、語言、Web、數據、工具、交易、安全等),支持點擊過濾。
* 狀態過濾:支持查看“全部”、“已安裝”或“僅本地”插件。
搜索與排序
* 多維搜索:支持按名稱、所有者、描述或話題搜索。
* 排序選項:可按星星數、分叉數、最近創建、最近更新或名稱排序。
Fork 瀏覽器
* 查看分叉列表及其元數據。
* 與上游倉庫進行代碼比較。
* 直接安裝特定的分叉版本。
安裝流程
* 一鍵安裝:點擊安裝按鈕即可執行安裝命令。
* Manifest 檢查:安裝前會檢查包內是否包含 dsh.bundle 聲明,確保包的有效性。
* 命令複製:提供一鍵複製安裝命令的功能。
本地插件支持
* 路徑驗證:通過粘貼路徑或文件夾選擇器添加本地插件。
* 無上傳設計:文件夾選擇器通過服務器端讀取磁盤路徑,無需文件上傳。
* 試運行:在正式安裝前支持 Dry run(試運行),驗證包的元數據。
插件管理
* 狀態標識:已安裝的插件顯示綠色“Installed”徽章。
* 啓用/禁用:支持對已安裝插件進行啓用或禁用操作(需重啓 dsh web)。
* 卸載:支持一鍵卸載。
* 國際化與主題:支持中英文切換,並根據 DSH 設計令牌自動適配主題。
典型用法¶
- 打開 DSH Web 界面,進入 Settings -> Plugins。
- 點擊 Community plugins 標籤頁。
- 使用搜索框或分類標籤篩選感興趣的插件,點擊 Install 進行安裝。
- 點擊卡片上的分叉數量查看 Fork 列表,點擊 Compare with upstream 查看差異,或點擊 Install 安裝 Fork 版本。
- 點擊 Add local plugin,選擇本地目錄或粘貼路徑,點擊 Validate 和 Dry run 確認無誤後安裝。
適用場景與注意事項¶
- 環境要求:需安裝 Node.js >= 22.19。
- 重啓機制:啓用或禁用插件後,必須重啓
dsh web才能生效。 - 本地插件規範:添加本地插件時,其
package.json必須聲明dsh.bundlemanifest,否則無法通過驗證。 - 權限與安全:插件以當前 DSH 進程的權限運行。在安裝未知來源的社區插件前,建議檢查源碼與許可證。
總結¶
該插件爲 DSH 用戶提供了集中式的社區插件發現與管理入口,結合本地緩存與本地插件支持,降低了插件維護與集成的門檻。