前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。隨着插件生態的擴展，通過命令行逐個安裝、管理依賴、檢查版本變得越來越繁瑣，且容易出現配置錯誤。dsh-plugin-hub 是一個爲 DSH Web UI 設計的圖形化插件商店，它允許用戶在瀏覽器中直接瀏覽、搜索並一鍵安裝 GitHub 上的 dsh-plugin 主題倉庫。除了作爲通用的插件分發渠道，該插件本身包含 21 個內建功能模塊，並預置了 16 個常用插件，旨在簡化 DSH 插件的生命週期管理。
核心功能¶
圖形化管理與發現
在 DSH Web UI 的側邊欄底部會出現「插件商店」入口。商店支持 12 個分類篩選、7 種排序方式（隨機、健康度、Stars、評分、下載量、更新、名稱），並提供搜索與已安裝過濾功能。用戶可以查看插件的信任徽章、下載來源，並通過點擊「安裝」按鈕將插件寫入 cordis.patch.yml，實現配置的實時生效。
21 個內建插件與離線預置
dsh-plugin-hub 本體是一個包含 22 行配置的包（1 個核心 + 21 個子插件），涵蓋基礎內核、安全與質量、發佈流水線、洞察與內容、運維五大類。所有內建插件在設置頁「插件商店」下均可單獨開關。
此外，爲了解決新用戶同步延遲導致的「空白商店」問題，插件內置了 16 個離線預置插件（如 dsh-cost-meter、dsh-notification 等）。這些插件通過 hub-ext-seed-catalog 寫入本地目錄，遵循「只插不覆蓋」原則，即一旦包被真實同步寫入，預置目錄將不再覆蓋其內容。
健康度與安全
商店提供 Top 20 健康度排行榜，展示插件的信任等級與動態趨勢。詳情頁包含評分構成、版本發佈線以及基於 npm 真實下載量的趨勢圖。安裝前，插件會通過安全掃描檢測危險腳本、敏感文件讀取、動態執行及可疑外聯，並通過沖突檢測與質量門禁攔截不合規的安裝。
發佈與審計
支持一鍵發佈功能，通過填寫 Markdown 介紹，同時向 GitHub 倉庫推送代碼與 npm 包發佈。發佈流程包含安全掃描、版本一致性守衛（檢查 package.json、README、exports 等是否同步更新）以及質量門禁檢查。所有操作（安裝、卸載、啓停、評分、發佈）都會記錄在審計日誌中，並持久化到本地 SQLite 數據庫。
安裝與啓用¶
通過命令行安裝該插件：
dsh plugin --profile web add dsh-plugin-hub
安裝完成後，側邊欄會出現「插件商店」入口，設置頁會增加「插件商店」配置區塊。首次使用建議在設置頁點擊「立即同步」，以加載本地鏡像緩存。
設計與實現¶
聲明式依賴與解耦
爲了避免硬依賴導致的死鎖問題（即「提供者被停用 → 消費者永久 Pending」），dsh-plugin-hub 採用聲明式依賴管理。插件間的依賴關係寫在配置清單中，而非通過 Cordis 的 inject 硬注入。當用戶關閉某個插件（如「商店數據庫」）時，其他依賴該插件的模塊會主動上報「依賴阻塞」並讓位，不再提供服務或註冊界面；重新開啓該插件後，依賴鏈自動恢復。
兩級開關機制
插件支持兩級控制：
1. 安裝級：在 cordis.patch.yml 中配置 disabled: true，控制插件是否被加載。
2. 日常級：在 DSH 設置頁的「內建插件」中按分組管理，修改 storages/plugin-store/plugins.json 並重啓 DSH 生效。
注意：默認關閉的四個插件（changelog / baike / skill-store / diagnostics）在 patch.yml 中不寫 disabled: true。這是因爲如果 loader 未加載該模塊，模塊內的代碼將無法讀取設置頁的開關，導致無法生效。默認關閉由模塊自身的啓動邏輯實現，確保開關可逆。
內建插件詳解¶
用量與費用
hub-ext-usage 提供帶日期的價格表，支持回溯歷史價格。它會記錄會話中每個請求的 Token 與緩存命中率，並展示當時價與現價的差額。價格表按版本管理，調價時僅追加新版本，歷史不可變。
運維與診斷
hub-ext-backup 支持 VACUUM INTO 導出數據庫與插件狀態快照，僅保留最近 10 個備份，且支持回滾前的二次備份。hub-ext-diagnostics（默認關閉）可導出包含環境、插件狀態、依賴統計與審計日誌的診斷報告（Markdown 格式）。
注意事項¶
- 版本適配：該插件適配 DSH
0.1.5-rc.1（基於 cordis 4.0.2）。 - 權限要求：插件以當前 DSH 進程權限運行，發佈功能需要配置有效的 GitHub Token。
- 生態說明：DSH 是開源項目，dsh-plugin-hub 是社區維護的插件，與 DeepSeek / 幻方無官方從屬關係。
