前言¶
DeepSeek Harness（DSH）把能力拆成可插拔的插件，社區目錄也在持續擴充。若只靠手動查文檔、記倉庫地址、在終端裏一條條 add，換機器或給同事復現同一套環境時成本會明顯上去。下面介紹維護者 Sun-0306 的客戶端插件 dshmarket：在宿主界面裏瀏覽、搜索社區目錄，確認來源後一鍵安裝，並順帶承擔已裝插件的分組、更新與備份等管理工作。
這是什麼¶
dshmarket（npm 包名 dshmarket）是跑在 DSH 宿主內的可視化插件市場。簡介可概括爲：在 Harness 裏逛社區插件、點一下裝好。它對接社區目錄（README 稱全量目錄在 4200+ 條目且仍在增長），與 dshmarket.com、awesome-dsh-plugin.com 等站點同屬社區生態，並非 DeepSeek / 幻方官方應用商店。
同一套列表也以 format-1 索引形式對外提供：在 dsh 0.2.1+ 可在 Plugins → Discover → Index sources 添加 https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json，供 Discover 與 plugin_market 等能力檢索；README 說明該索引經 npm CDN 分發，相對部分 GitHub Pages 鏡像更易在超時限制內加載。
源碼與說明見 GitHub：Sun-0306/dshmarket，SkillHub 目錄頁：skillhub.cn/plugins/Sun-0306/dshmarket。package.json 中當前版本爲 1.71.1，許可證 MIT。
核心功能¶
以下均來自項目 README 與元數據，按使用路徑歸納。
瀏覽與安裝¶
- 分類篩選、星標展示、熱門/最新排序；描述可隨界面語言中英切換。
- Host-aware discovery：卡片展示插件聲明的
engines.dsh或與宿主鎖步的@deepseek-ai/dsh-*要求；可選過濾僅隱藏「已確認與當前宿主不匹配」的條目，未聲明或無法判定的仍可見。 - 一鍵安裝：確認來源後可看實時進度；多數插件刷新頁面即可生效，無需重啓宿主。
- 主題：獨立 Themes 標籤，安裝後即時切換，互斥生效，卸載可還原。
討論、收藏與本地整理¶
- Comments：在卡片內嵌打開與 dshmarket.com / catalog 同一討論串（giscus + GitHub Discussions）；閱讀可內嵌，發帖需 GitHub 賬號。
- Favorites：從 Discover 或 Themes 收藏，獨立 Favorites 標籤支持搜索、排序與安裝；狀態寫在 profile 的
state.json。 - Groups：給已裝插件建命名分組，組級開關可整組啓停；每組最多一個主題；狀態本地保存在
state.json。 - Notes：爲已裝插件寫一行自用說明，僅本地展示，覆蓋該行作者描述。
更新、備份與卸載¶
- 按插件檢查 npm 版本或 pinned commit 相對 HEAD；支持單條更新或批量更新；市場自身也可用同樣方式更新。歸檔鏈接安裝的插件只沿原來源更新，不會被同名目錄項靜默替換。
- Backup & restore：導出/導入可讀 JSON，可選 WebDAV 日備或私有 GitHub Gist；恢復爲 merge，校驗失敗可回滾。
- Hot disable / enable：通過 profile 的
cordis.patch.yml寫入disabled開關（機制自 dsh-plugin-hub 移植）。 - 卸載兩步確認；本會話新裝的插件可即時移除。
網絡與其它¶
- 中國區等對 Git ref、README、頭像維護多路 GitHub 回退，並記住上次可用路由；可在 Settings → Plugins → Plugin configuration → GitHub acceleration 配置自定義 HTTPS 前綴；環境變量
DSHM_GITHUB_PROXY爲運維側覆蓋。 - 插件自有設置頁可使用文檔中的 update API v1（beta），避免複製市場內部邏輯。
安裝與啓用¶
宿主要求：README 寫明需 dsh web 0.1.0-rc.6 或更新；過舊宿主會自行禁用並在瀏覽器控制台提示。Plugin Market 入口在 dsh 0.2.1+ 爲 Plugins 頁與 Installed 並列的 Plugin Market 標籤；0.2.0 及更早僅 Settings → Plugin Market。也可在市場卡片下開啓側欄 Plugin Market 一行快捷入口。
DSH Desktop（官方桌面版）：在應用內 Settings → Plugins 搜索 dshmarket 安裝。不要在 Desktop 機器上誤以爲下面 CLI 會裝進桌面所用 profile——README 明確：在 Desktop 環境執行 dsh plugin --profile web add dshmarket 可能成功但只寫入 profiles/web，界面不會出現。
常規 dsh web：執行後重啓 dsh web：
dsh plugin --profile web add dshmarket
自定義 profile：將 web 換成宿主實際 profile 名：
dsh plugin --profile <profile> add dshmarket
安裝完成後打開 Plugins → Plugin Market（或 Settings 中的入口，視版本而定）即可使用。
典型用法¶
- 打開 Plugin Market，用分類或搜索定位插件，查看卡片上的宿主要求與截圖（有作者截圖則直接展示；否則可在安裝對話框中從 README 提取）。
- 需要與 Discover 共用目錄時，在 Plugins → Discover → Index sources 添加索引 URL（見上文
cdn.jsdelivr.net地址）。 - 安裝主題後在 Themes 標籤一鍵切換；對常用插件 Favorites bookmark，對工作集用 Groups 整組開關。
- 遷移環境：Backup & restore 導出 JSON，在另一臺機器 import；或配置 WebDAV / Gist 自動備份。
- 批量維護：使用「全部更新」前閱讀各條 What changed（release notes 或 commit 列表）。
適用場景與注意¶
適合：日常用 DSH web 或 Desktop、希望少碰命令行即可完成社區插件發現、安裝、更新與 profile 級整理的用戶；需要與 Discover 索引同源目錄的開發者也可按 README 添加 index source。
務必注意：
- 插件在 當前 dsh 進程權限 下運行，一鍵安裝會從網絡拉取第三方源碼；安裝前應查看目標插件倉庫、許可證與
engines.dsh聲明。 - 討論區加載會聯繫 giscus.app 與 GitHub；企業或離線環境需自行評估。
- 社區目錄與 SkillHub 條目獨立維護；安裝命令以 README 爲準，應使用
dsh plugin --profile … add dshmarket，不要臆造github:owner/repo形式。
結尾¶
dshmarket 把社區插件目錄收進 DSH 界面：瀏覽、搜索、安裝、主題與更新在一處完成，本地分組、備註與備份則方便長期維護同一套 profile。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
