前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構。社區存在多個插件市場（精選目錄、GitHub、npm），但它們分散且對 DSH Desktop（EAC）存在兼容性問題，例如錯誤的 Profile 識別（web-desktop 對比 web）。dsh-unified-market 將這三個來源合併爲一個單一入口，並專門解決了 EAC Profile 適配問題，提供一站式的安裝、更新和管理體驗。
核心功能¶
該插件整合了以下能力：
- 三源聚合：合併精選目錄（awesome-dsh-plugin）、GitHub dsh-plugin 生態和 npm registry。支持分類篩選、搜索與分頁。
- 安裝安全機制：安裝前進行衝突預檢與來源白名單校驗；支持試裝驗證（在臨時環境啓動插件）；提供安裝前快照與熱掛載功能，實現簡單插件的免重啓安裝。
- 更新管理：提供已下載插件的更新面板，支持一鍵全部更新、逐個更新以及自動更新（後臺檢測）。更新進度窗口會保留失敗或排隊原因，不再自動消失。
- 功能包管理：支持
.dshpack功能包的安裝、卸載、更新、導出與回滾。 - Profile 適配與同步：
- 適配：統一解析爲
DSH_DESKTOP_PROFILE→DSH_PROFILE→web，修復舊市場在 EAC 中識別錯誤的根因。 - 同步：採用 CAS 校驗與原子寫入，實現配置的雙邊同步（保留外部手動修改、防止整文件重寫丟失變更）。
- 適配：統一解析爲
- 本地開發支持：支持
link:/file:指向本地開發目錄的插件更新。
安裝與啓用¶
方式一：命令行安裝
dsh plugin --profile web-desktop add dsh-unified-market
或者直接從 GitHub 源安裝：
dsh plugin --profile web-desktop add github:jing-hy/dsh-unified-market
安裝後重啓 Web 服務，進入 設置 → 插件 → 🛒 統一市場 即可使用。
典型用法¶
- 市場瀏覽與安裝：在市場頁面切換來源（精選目錄、GitHub、npm），使用下拉框篩選分類或“已安裝”狀態，點擊插件進行安裝。
- 功能包管理：切換到 「📦 功能包」 tab，選擇本地
.dshpack文件進行導入安裝，或瀏覽功能包市場進行一鍵安裝（支持 SHA-256 校驗）。 - 批量更新：在已下載插件更新面板中，點擊頂部 「⬆ 全部更新 (N)」 批量升級，或逐個點擊更新按鈕。點擊 「檢查更新」 強制刷新版本列表。
環境與兼容性¶
- Node.js 版本：需要 Node.js >= 18.18。
- 推薦運行環境：DSH Desktop（EAC）5.1 或 dsh 0.1.1-rc.2。
- 功能包邏輯：功能包的核心邏輯在 L2（
dsh-desktop框架層），本插件僅做交互編排與配置管理。 - 依賴變量：功能包管理依賴環境變量
DSH_DESKTOP_RESOURCE_ROOT。 - 更新保護：上游新版本發佈不足 24 小時不會顯示“可更新”狀態。
結語¶
dsh-unified-market 旨在解決 DSH 生態中插件分發分散、EAC 適配不一致的問題，通過統一入口和精細化的配置管理，爲桌面端用戶提供更穩定、可控的插件使用體驗。
