前言¶
DeepSeek Harness（DSH）桌面端採用插件化架構，但官方的「插件」面板只負責管理，不會主動發現插件。社區現有的插件市場大多繞開了官方的安裝管線，自行處理依賴和構建。dsh-compat-market 專注於解決「發現」與「官方管線」之間的斷層：它提供側欄界面瀏覽官方與社區插件，在點擊安裝前給出兼容性結論，並將社區信息注入到原生插件詳情頁中，最後委託官方的 pluginManager 完成安裝。
核心功能¶
dsh-compat-market 交付以下能力：
- 發現社區插件：聚合 npm 註冊表與 GitHub Topic，列出可安裝的 DSH 插件。
- 兼容性預檢：在安裝前給出兼容性結論，避免安裝後因版本衝突報錯。
- 官方管線安裝：不自建安裝管線，所有安裝、啓用、卸載操作均委託給
pluginManager。 - 原生詳情頁注入：將社區插件信息展示在 DSH 原生的插件詳情頁中。
- 官方與社區同屏：側欄統一展示官方包與社區包，便於對比。
安裝與啓用¶
安裝時走官方的註冊表回退與構建腳本授權流程。在 DSH 的「插件」面板中添加，或直接使用 plugin_manager 工具：
plugin_manager { action: "install_bundle", target: "dsh-compat-market" }
安裝完成後即時生效，無需重啓。若需從本地目錄安裝（開發調試用），可傳入絕對路徑：
plugin_manager { action: "install_bundle", target: "D:\\path\\to\\dsh-compat-market" }
配置與注意事項¶
源管理¶
側欄「插件市場」→ 右上角「設置」→ 可以調整「來源開關」。將開關切到「已關閉」即可停止 GitHub Topic 的滴灌掃描，此時插件不會發出任何請求。
熱重載¶
安裝後，插件瀏覽器半邊（lib/client.js）會通過 HMR 熱替換即時生效；但 Host 半邊（lib/index.js）不會熱重載，修改代碼後需重啓 DSH 才能生效。
Windows 與 pnpm¶
在 Windows 上，pnpm 建立的 node_modules 鏈接使用絕對路徑。因此不要移動或重命名本地檢出目錄，否則會導致鏈接懸空，引發模塊加載失敗。
GitHub 源與 Token¶
GitHub 源的條目結論是臨時的，不做版本固定。開啓 GitHub Token 會顯著提升掃描速度（配額增加），但會消耗該 token 的配額。卸載插件不會撤銷已消耗的配額。插件默認不引入憑據，開啓 token 後會將 token 發送給 GitHub。
總結¶
dsh-compat-market 是爲 DeepSeek Harness 桌面端打造的插件市場插件。它不替代官方管理器，而是補齊了「發現」與「官方安裝管線」之間的縫隙，通過兼容性預檢和統一側欄，讓社區插件的接入更加安全、可控。
- 倉庫：https://github.com/lpf0404/dsh-compat-market
- 目錄頁：https://www.skillhub.cn/plugins/lpf0404/dsh-compat-market
