前言¶
DeepSeek Harness 提倡“一切皆插件”的理念,這使得開發者可以靈活擴展應用能力。然而,隨着插件生態的擴張,社區中混雜了半成品、隨機 Fork 以及各種未經驗證的項目。在充斥噪音的搜索結果中尋找可用插件容易浪費時間且存在安全隱患。
dsh-plugin-market 旨在 DeepSeek Harness Web 客戶端內提供一個經過驗證的插件目錄。它通過本地化的驗證機制和瀏覽界面,幫助用戶在不需要離開 DSH 界面的情況下,安全地發現和安裝插件。
插件定位¶
這是一個運行在 DSH Web 客戶端內部的插件市場。它不作爲獨立的 Web 服務運行,而是直接嵌入到 DeepSeek Harness 的瀏覽器界面中。
該插件由用戶 2160039878-cyber 開發,採用 MIT 許可證。其核心設計原則是“驗證優先”:內置的目錄條目經過人工或腳本檢查,確保具備基本的可安裝性。
安裝與啓用¶
安裝過程分爲兩步:首先將插件添加到 DSH 的 Web 配置中,然後啓動 Web 客戶端。
- 執行以下命令安裝插件:
dsh plugin --profile web add github:2160039878-cyber/dsh-plugin-market
- 啓動 DeepSeek Harness Web 客戶端:
dsh web
- 在瀏覽器中打開
http://127.0.0.1:3080/,在頁面右上角找到“插件市場”按鈕並打開。
核心功能¶
該插件提供了瀏覽、搜索和驗證插件的能力,同時嚴格遵循安全原則。
1. 驗證目錄瀏覽¶
插件內置了一個本地化的驗證目錄。打開面板後,無需發起網絡請求即可查看已驗證的插件列表。目錄中包含市場、管理器、皮膚、工作流、運行時和開發者等類別的條目。
2. 搜索與發現¶
- 多語言搜索:支持中文和英文搜索。
- 中文映射:插件內置了中文搜索擴展,例如搜索“皮膚”、“市場”、“沙箱”、“會話”或“模板”時,會自動映射到對應的英文標籤進行檢索。
- GitHub 發現:本地目錄有限,用戶可以點擊“搜 GitHub”按鈕,顯式地通過 GitHub 搜索發現潛在的插件源。
- 手動索引:當搜索索引較慢時,用戶可以手動粘貼精確的
owner/repo或 GitHub 倉庫 URL 來觸發查詢。
3. 信息展示與操作¶
- 概覽信息:列表中直接顯示中文摘要、星標數、編程語言、最後更新時間及描述。
- 安裝命令複製:對於內置的已驗證條目,插件會生成並顯示帶有特定 Git 提交哈希的安裝命令,用戶可直接複製使用。
- 倉庫操作:支持直接在 GitHub 上打開匹配的倉庫,並檢查倉庫是否符合 DSH 插件的規範。
4. 安全機制¶
- 無自動遠程安裝:插件不會自動安裝遠程代碼。
- 無密鑰訪問:不讀取用戶的 DSH API 密鑰或 GitHub 私有 API。
- 無隱藏寫入:不會向用戶的 DSH 配置文件進行自動寫入操作。
- 安裝性檢查:在嘗試安裝前,插件會快速檢查
package.json、dsh.bundle.patch、補丁文件以及 Web 客戶端入口點,判斷倉庫是否像是一個真實的 DSH 插件。
5. 性能與穩定性¶
- 本地優先:內置的可用插件列表完全由本地數據提供,避免了因網絡問題導致面板無法打開。
- 防阻塞設計:面板打開時不會自動搜索,這防止了在
api.github.com被阻斷或限流時出現錯誤提示。 - 版本鎖定:內置的條目被鎖定到特定的 Git 提交,確保版本一致性。
典型用法¶
在實際使用中,該插件主要解決兩個問題:查找經過驗證的插件,以及檢查 GitHub 上的陌生倉庫是否適合安裝。
-
查找內置插件:
打開插件市場面板,瀏覽內置的 12 個已驗證條目。如果需要安裝某個條目,複製面板中生成的安裝命令並執行。 -
GitHub 發現與驗證:
點擊“搜 GitHub”按鈕,輸入關鍵詞或直接粘貼倉庫 URL。在搜索結果中,插件會顯示該倉庫是否看起來像真實的 DSH 插件。對於 GitHub 發現的條目,雖然可以顯示爲可安裝,但它們不會被標記爲已鎖定到提交。
適用場景與注意事項¶
該插件適合需要在 DSH 環境中管理插件生態、尋求穩定插件來源的開發者或高級用戶。
注意事項:
- 該插件僅作爲瀏覽器端的輔助工具,它通過 GitHub 公開的搜索結果進行渲染。
- 它不存儲任何本地數據或 Token。
- 雖然內置目錄經過驗證,但在安裝任何插件(尤其是通過 GitHub 搜索發現的插件)前,建議查看源碼和許可證。