DSH (DeepSeek Harness) 的設計理念強調模塊化與插件化。當開發者需要擴展功能時,通常需要在本地手動管理 Git 倉庫。本插件爲 DSH 網頁版添加了一個“插件市場”標籤頁,使其具備在瀏覽器中瀏覽、預覽並一鍵安裝 GitHub 上發佈的 DSH 插件的能力。
它由開發者 Viveksssss 維護,是一個 DSH 客戶端插件。它本身是 DSH 的一個插件,同時又是 DSH 插件的安裝器,起到了連接 DSH 與社區生態的入口作用。
核心功能¶
該插件主要提供以下能力:
- 倉庫瀏覽與檢索:支持按
topic:dsh-plugin、topic:dsh-theme等關鍵詞在 GitHub 上搜索倉庫。 - 元信息查看:顯示倉庫的描述、星標數、Fork 數、編程語言、許可證以及 Topics。
- 一鍵安裝/卸載:通過調用 DSH 官方插件機制,支持一鍵安裝或卸載插件。
- 安裝校驗:安裝後自動檢查插件包入口文件是否存在。如果缺失,系統會自動回滾,避免因安裝無效插件導致 Profile 無法啓動。
- 持久化管理:已啓用的插件列表會持久化保存到本地 JSON 文件中,重啓 DSH 後依然保留。
- 主題適配:界面樣式適配 DSH 的明暗主題。
- 友好反饋:提供錯誤、警告、提示三種狀態的反饋機制。
安裝與使用¶
安裝插件¶
通過命令行安裝該插件到你的 Web Profile:
dsh plugin --profile web add github:Viveksssss/DeepSeek-harness-marketplace
啓動與操作¶
安裝完成後,啓動 DSH 網頁版:
dsh web
進入網頁版「設置 → 插件」,點擊頂部的「插件市場」標籤頁即可開始使用。
基本操作流程¶
- 搜索:在搜索框輸入關鍵詞(如
topic:dsh-plugin)並搜索。 - 預覽:點擊倉庫卡片查看 README、描述及元信息。
- 安裝:點擊「啓用」按鈕進行安裝,系統會自動校驗並處理回滾邏輯。
- 管理:在「已啓用列表」中查看所有已安裝的插件,點擊「停用」進行卸載。
插件識別規則¶
並非所有 GitHub 倉庫都能被正確識別爲 DSH 插件。要被本插件市場(以及 dsh plugin)識別,倉庫需滿足以下條件:
- 聲明 Bundle:
package.json中需聲明dsh.bundle.patch,指向倉庫根目錄的cordis.patch.yml。 - 聲明 Patch:倉庫根目錄需存在
cordis.patch.yml,並在其中定義 entry 以被 Loader 加載。 - 入口文件真實存在:這是最常見的坑。如果倉庫未提交構建產物(如
lib/)且未配置prepare腳本,安裝後入口文件將缺失。插件市場會對入口文件進行校驗,缺失時自動回滾。
注意事項¶
- 運行環境:插件市場的 UI 功能需要運行
dsh web才能使用。 - 狀態文件:啓用列表的狀態文件存儲在
~/.dsh/plugin-marketplace.(注意文件名末尾的點)。 - GitHub API 限制:瀏覽功能依賴 GitHub API,存在速率限制,遇到限流會提示。
- 插件開發:如果你打算開發插件,必須聲明
dsh.bundle和cordis.patch.yml,並確保構建產物或prepare腳本能生成正確的入口文件。
這是一個典型的生態入口工具,旨在簡化 DSH 插件的發現與管理流程,適合需要頻繁集成第三方 DSH 插件的開發者。