DeepSeek Harness(DSH)採用“一切皆插件”的架構,插件生態豐富但也帶來了管理上的複雜性。開發者經常需要在 Web 設置界面中區分官方內置插件與用戶自行安裝的第三方插件,並對它們進行配置。dsh-lightweight-plugin-enhance 是一個爲此場景設計的輕量級管理增強插件。
插件定位¶
本插件由 Feng-jsy 維護,採用 MIT 許可證。它主要解決 DSH 插件列表混亂的問題,在 Web 設置中清晰劃分官方插件與第三方插件,並提供一鍵啓停第三方插件的能力,同時保持核心系統的純淨。
核心功能¶
- 官方與第三方分類:系統會自動識別官方插件(作用域爲
@deepseek-ai、cordis:include根組合條目、cordis:group)與第三方插件(用戶通過dsh plugin add安裝)。 - 分組與篩選:界面提供“全部 / 官方 / 第三方”的篩選標籤,並實時顯示各組的插件計數,配合搜索框使用。
- 一鍵啓停(僅限第三方):對於第三方插件,展開卡片可查看完整模塊名與 Loader 條目 ID。通過卡片上的開關,可以啓用或停用插件。
- 配置生效機制:開關操作不會修改核心配置,而是直接寫入用戶補丁層
cordis.patch.yml。配置變更通過 HMR 約一秒後重組合,無需重啓宿主服務。 - 安全與自保護:官方插件行一律拒絕開關(宿主側判定);本插件自身也禁止開關,防止管理面板隨插件一起消失。插件路由僅允許本地迴環訪問。
安裝與啓用¶
前置要求:DeepSeek Harness (DSH) 版本需 ≥ 0.1.0-rc.6。
執行以下命令安裝插件:
dsh plugin --profile web add dsh-lightweight-plugin-enhance
安裝後,重啓 DSH 服務以加載宿主側代碼,隨後刷新 Web 頁面,進入 設置 -> 插件 -> 輕量插件增強 即可使用。
典型用法¶
- 進入 Web 界面的設置頁面。
- 在插件列表中找到並點擊“輕量插件增強”。
- 使用頂部的篩選器(如“第三方”)查看非官方插件。
- 點擊任意第三方插件卡片上的開關進行啓用或停用,頁面刷新後配置即刻生效。
注意事項¶
- 版本兼容:必須滿足 DSH ≥ 0.1.0-rc.6 才能正常工作。
- 權限與安全:該插件以當前 DSH 進程的權限運行,請確保信任其源碼與許可證。路由
/plugin-enhance/*僅限本地迴環訪問。 - 宿主變更:插件自身的宿主代碼變更需要重啓服務,僅客戶端(HMR)變更可刷新頁面。
生態背景¶
本插件屬於社區插件,與 DeepSeek 或幻方官方無從屬關係。更多細節可參考 GitHub 倉庫。