前言¶
DeepSeek Harness 的核心設計理念是「一切皆插件」。在開發過程中,開發者需要從社區索引中尋找可用的插件工具。目前沒有原生的 Web UI 界面來瀏覽 dshplugin.org 的社區目錄。dsh-client-plugin-store 插件在設置頁面中提供了一個獨立的「插件商店」分區,用於瀏覽、搜索以及安裝社區插件。
是什麼¶
這是一個社區插件商店面板,允許用戶在 DeepSeek Harness Web UI 的設置中直接訪問 dshplugin.org 索引。它支持按 star 排序,並提供可複製的、釘死 commit 的安裝命令。
核心功能¶
- 瀏覽與搜索:直接在設置面板中瀏覽和搜索 dshplugin.org 社區索引(包含 4000+ 插件)。
- 排序:支持按 star 數量進行排序。
- 命令複製:提供可複製的、釘死 commit 的安裝命令。
- 獨立分區:在設置導航中註冊獨立的「插件商店」分區。
- 直接操作:通過面板內的雙擊確認,直接進行插件的安裝或卸載。
- 端點保護:安裝接口包含三層防護(自定義請求頭、Origin 同源校驗、白名單機制)。
安裝¶
執行以下命令添加插件:
dsh plugin --profile web add github:shiyi-0x7f/dsh-client-plugin-store
使用方法¶
- 安裝完成後,重啓
dsh --profile web(或 dsh-shell)。 - 打開設置頁面,左側導航會出現獨立的「插件商店」分區。
- 在面板中瀏覽、搜索插件,或點擊安裝命令進行復制。
- 雙擊面板內的條目進行確認,可直接安裝或卸載插件(重啓後生效)。
技術細節與注意事項¶
- Host 端:通過
ctx.webServer註冊同源路由/plugin-store/catalog,用於代理社區目錄(端點無 CORS 頭,瀏覽器不能直連)。 - 緩存與配置:目錄數據採用內存緩存,緩存時長爲 1 小時;
config.catalogUrl可用於更換源地址。 - 瀏覽器端:通過
ctx.slots註冊settings.section。 - 樣式兼容:使用
--dsw-alias-*令牌,跟隨任意主題或皮膚。 - 安全限制:安裝規格僅接受目錄中定義的
github:owner/repo#完整sha,屬於白名單機制。 - 權限與安全:插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。