前言¶
DeepSeek Harness(DSH)採用「一切皆插件」的設計理念,插件來源分散在 npm 註冊表和 GitHub 倉庫中,查找和選擇合適插件的過程較爲依賴搜索。dsh-plugin-market 插件在 DSH 內部增加了「Market」頁面,通過自動發現、展示和模型審查,簡化了插件的發現與決策流程。
插件介紹¶
這是 DeepSeek Harness 的一個內置插件,由 duxingxiake3 維護。
核心價值:
1. 自動發現:從 npm registry 和 GitHub 自動發現 DSH 插件。
2. 可視化展示:顯示插件的功能描述和作者提供的截圖。
3. 安全審查:在安裝任何插件前,會通過模型對插件進行審查。
核心功能¶
- Market 頁面:在 DSH 客戶端中增加一個專門的插件市場入口。
- 信息聚合:展示插件名稱、開發者、許可證、主頁以及摘要信息。
- 預安裝審查:在用戶批准安裝前,利用模型對插件內容進行風險評估。
- 安裝後管理:插件安裝完成後,由內置的 Plugins 頁面統一負責啓用、配置和卸載,Market 頁面僅提供鏈接跳轉。
安裝與啓用¶
插件支持通過 DSH 界面、命令行或手動配置三種方式安裝。
1. 通過 DSH 界面安裝¶
- 打開 Plugins → Add plugin。
- 輸入包名
dsh-plugin-market並批准安裝。
2. 通過命令行或鏈接安裝¶
在 Add plugin 界面直接輸入以下內容:
dsh-plugin-market
或指向倉庫(適用於未發佈 npm 包的情況):
github:duxingxiake3/dsh-plugin-market
3. 手動安裝¶
在用戶配置的 package.json 中添加依賴和插件入口:
{
"dsh": { "profile": { "bundles": ["…", "dsh-plugin-market"] } },
"dependencies": { "dsh-plugin-market": "link:/path/to/dsh-plugin-market" }
}
配置完成後需要重啓 DSH。
訪問方式¶
安裝完成後,可以通過以下任一方式打開插件市場:
* 側邊欄中的 Plugin Market 圖標(位於內置 Plugins 按鈕旁)。
* Settings → Built-in plugins → Market 標籤頁。
插件作者指南¶
插件作者無需額外操作即可在市場中被自動發現,但爲了展示效果,需遵循特定的目錄結構。
目錄結構¶
在插件倉庫根目錄下創建 dsh-market 文件夾,並將展示內容放入其中:
your-plugin/
├─ package.json # "icon" 字段指向此文件夾內的 logo
├─ README.md
└─ dsh-market/
├─ market.json # 描述、開發者、截圖列表
├─ logo.svg # 插件圖標
└─ screenshots/ # 截圖目錄
├─ dashboard.png
└─ settings.png
字段說明¶
market.json:包含displayName(顯示名稱)、summary(摘要)、description(描述)、homepage、license以及screenshots數組。logo.svg:用於 Market 列表中的圖標。package.json:icon字段用於 Plugins 頁面,指向./dsh-market/logo.svg。
路徑規則(重要)¶
package.json中的路徑是相對於package.json文件的,用於本地文件解析。market.json中的路徑(如logo或screenshots[].url)是相對於倉庫根目錄的,用於從 GitHub 讀取。- Package 相對路徑(如
./dsh-market/logo.svg)在market.json中不能作爲倉庫路徑使用,會導致 404 錯誤並回退到默認圖標。
注意事項¶
- 重啓要求:手動安裝後必須重啓 DSH。
- 自動重載:DSH 運行時,瀏覽器組件會自動重載,無需手動刷新。
- 截圖域名限制:
market.json中的截圖 URL 僅允許指向允許的主機(如raw.githubusercontent.com等),拒絕其他域名以保護用戶隱私。 - 權限運行:插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證。