前言¶
DeepSeek Harness（DSH）的理念是「一切皆插件」。在 dsh Web UI 裏瀏覽 GitHub dsh-plugin topic 插件、搜索並安裝第三方插件時，通常需要手動找倉庫、執行安裝、處理進度。
dsh-plugin-market 由 TheYoungChen 維護，是一個 DSH bundle 插件：在 Web UI 左側「設置」上方新增「插件市場」入口，也集成到「設置 → 插件 → 插件市場」標籤頁，支持分頁瀏覽、關鍵字搜索、一鍵安裝和即時進度。
它不是 DeepSeek / 幻方官方應用商店，與 DeepSeek / 幻方無官方從屬關係，只提供插件發現與安裝入口。
這是什麼¶
一句話定位：dsh-plugin-market 是 DSH Web UI 的插件市場 bundle 插件，用於瀏覽 GitHub dsh-plugin topic 下的插件並輔助安裝。
它主要做三件事：
- 在 Web UI 提供瀏覽和搜索入口。
- 用靜態索引減少前端直接調用 GitHub API，索引不可用時回退搜索 API。
- 在安裝時調用
pnpm add github:<owner/repo>，並把聲明dsh.bundle的依賴 reconcile 進dsh.profile.bundles層棧。
核心功能¶
瀏覽與搜索¶
市場瀏覽 GitHub dsh-plugin topic 插件，支持關鍵字搜索、刷新和按 star 排序。
數據優先使用 GitHub Action 生成的 registry.json，並通過 jsDelivr CDN 分發。索引不可用時，自動回退搜索 API。
已安裝識別與更新¶
市場會識別已安裝插件，並在列表中置頂；檢測到新版時會顯示更新提示。
一鍵安裝與進度¶
點擊安裝後，插件市場執行：
pnpm add github:<owner/repo>
安裝過程中提供即時日誌、已用時長，可終止任務，也可轉後臺下載。後臺任務會在右上角顯示狀態條，可展開查看日誌，完成後提供「立即重啓」按鈕，手動關閉。
類型識別¶
市場按倉庫根文件識別插件、Skill、預設、腳本類型，並採用對應安裝方式。
統計與引導¶
頁面提供插件總數統計，以及「如何發佈插件」引導鏈接。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add github:TheYoungChen/dsh-plugin-market && dsh web
安裝源固定爲 github:<owner/repo>，插件裝進 web profile，重啓 dsh 後生效。dsh-plugin-market 無 prepare 構建腳本，lib/ 已預編譯，git 安裝不需要額外構建。
典型用法¶
下面介紹幾個可復現的使用步驟。
1、打開市場：通過側邊欄「設置」上方入口，或「設置 → 插件 → 插件市場」標籤頁瀏覽插件。
2、搜索與排序：輸入關鍵字搜索，使用刷新按鈕重新拉取列表，按 star 排序查看插件。
3、安裝插件：選擇目標插件後確認安裝。安裝過程會即時顯示日誌和已用時長，可按需終止或轉後臺下載。
4、處理構建許可：如果 pnpm 進度中報 allowBuilds，按提示把對應 key 加進：
~/.dsh/profiles/web/pnpm-workspace.yaml
然後重新安裝。
5、從源碼構建：
cd dsh-plugin-market
pnpm install
pnpm build
適用場景與注意¶
適合已經使用 dsh Web UI、希望在界面內快速發現 GitHub dsh-plugin topic 插件的人。
需要注意：
- 安裝第三方插件前，先檢查其源碼、權限與許可證。插件以當前 dsh 進程權限運行。
- 本市場只提供發現與安裝入口，不做安全背書。
- 靜態索引每 2 小時由 CI 更新一次，新發布的插件最遲 2 小時進索引。
- 版本檢測按需讀取 GitHub
package.json，受未鑑權速率限制，約 60 次/小時。 - 安裝進度爲輪詢式，約 600ms 一次，非逐字節流式。
dsh-plugin-market 的許可證爲 MIT，Copyright (c) 2025 TheYoungChen。
鏈接¶
GitHub 倉庫：https://github.com/TheYoungChen/dsh-plugin-market
