前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構：能力通過插件擴展，而不是改主倉庫源碼。實際開發裏，社區插件分散在 GitHub 各倉庫，帶 dsh-plugin topic 的項目數量不少，但缺少統一入口時，找插件、覈對安裝方式、判斷某個 commit 是否真能裝，都要自己翻 README 和倉庫結構。
DSH Plugin Marketplace 是一個可獨立安裝的 DSH bundle，把插件市場嵌進 DSH 自帶的 Settings UI。下面介紹它是什麼、能做什麼，以及如何安裝和使用。
這是什麼¶
DSH Plugin Marketplace（npm 包名 @w2112515/dsh-plugin-marketplace，當前版本 0.2.4）由 w2112515 維護，MIT 許可。它不是 DSH 官方倉庫的一部分，也不是獨立 Web 產品；安裝到 web profile 後，Host Loader 掛載市場 Host 插件，瀏覽器端入口註冊在 Settings → Plugins → Marketplace。界面隨 DSH 顯示語言自動切換（中文 / English）。
SkillHub 社區目錄頁：https://www.skillhub.cn/plugins/w2112515/dsh-plugin-marketplace
GitHub 倉庫：https://github.com/w2112515/dsh-plugin-marketplace（12 stars，分類：客戶端）
核心功能¶
插件目錄與檢索¶
市場通過每日掃描 GitHub 上帶 dsh-plugin topic 的倉庫構建目錄，README 稱可發現 2,200+ 個插件。目錄以靜態 JSON 託管在本倉庫 GitHub Pages，瀏覽不需要 GitHub 賬號或 token。Settings 裏可按分類檢索、查看 freshness 等信息。
基於證據的安裝資格判定¶
掃描器會在每個插件 pinned commit 上證明安裝目標是否存在，安裝行爲分三類：
| 目錄條目 | 掃描器已證明的內容 | 安裝時發生什麼 |
|---|---|---|
| Automatic install | pinned commit 的 git tree 中存在全部安裝目標（入口文件、patch 等） | pnpm add --ignore-scripts，第三方 lifecycle 腳本不執行 |
| Needs script review | 目標缺失但包聲明瞭 lifecycle 腳本 | 審查步驟中原樣展示腳本；你明確同意後，Host 單次以 --allow-build=<name> 安裝，同意不持久化 |
| Manual install | 以上均不滿足 | 僅提供倉庫鏈接，市場不執行任何操作 |
自動安裝會 pin 不可變的 40 字符 commit，經 capability preflight → 短期 review plan → 確認執行；失敗時回滾 profile manifest、lockfile 和 workspace 配置。
方案包（Solution packs）¶
帶 dsh-plugin 與 dsh-plugin-pack 兩個 topic、幷包含 dsh.pack.json 清單的倉庫可成爲方案包。清單示例：
{
"schemaVersion": 1,
"name": "My Essentials",
"description": "A curated starter set",
"items": ["owner/plugin-a", "owner/plugin-b"]
}
items 爲 1–50 個 owner/repo 字符串。市場會展示每個條目的明確狀態（will auto-install、needs script review、manual install、not in catalog、already installed），以及誠實的 install N of M 計數。安裝方案包時按單插件 plan→execute 路徑串行執行，首個失敗即停止且不整體回滾。
社區評分¶
評分借用 GitHub 原生 reactions：每個目錄插件在 ratings issue 下有一條 ballot comment，👍/👎 即一票，每 GitHub 賬號一票。詳情頁展示總體窗口與近 90 天窗口；低於 10 票不顯示結論。客戶端只讀，投票在 GitHub 完成，市場不持有憑證。
Agent 工具¶
Host 插件向 DSH agent 註冊四個工具：marketplace_search、marketplace_detail、marketplace_install、marketplace_manual_guide。搜索與詳情只讀；安裝走與 WebUI 相同的 plan→execute 管道，每次調用需一次性人工批准。腳本審查類條目由設計拒絕通過 agent 安裝（須在 Settings → Plugins → Marketplace 中審查腳本）；手動安裝類僅通過 guide 工具拉取倉庫說明。可在 bundle 配置中設 agentTools: false 關閉 agent 面。
隱私與遙測¶
README 明確：無 telemetry、無安裝計數、無服務端；目錄爲 GitHub Pages 上的靜態 JSON。
安裝與啓用¶
常規用戶從 npm 安裝：
dsh plugin --profile web add @w2112515/dsh-plugin-marketplace
也可 pin 不可變 commit（倉庫已提交構建產物 lib/，本地不跑 prepare）：
dsh plugin --profile web add github:w2112515/dsh-plugin-marketplace#<40-char-commit>
自動安裝需要 Host 能運行 pnpm 11（插件也會嘗試 corepack pnpm）；需腳本審查的安裝要求 pnpm ≥ 11.7。無包管理器時 WebUI 仍可瀏覽，並顯示恢復提示而非假成功。
卸載：
dsh plugin --profile web remove @w2112515/dsh-plugin-marketplace
安裝完成後啓動 Web UI：
dsh web
插件激活在 dsh web 重啓之後。開發時可覆蓋目錄 URL：
$env:DSH_PLUGIN_MARKETPLACE_CATALOG_URL = 'https://w2112515.github.io/dsh-plugin-marketplace/plugin-marketplace/catalog-v1.json'
dsh plugin --profile web add D:\Work\dsh-plugin-marketplace
dsh --profile web --dump-config
dsh web
典型用法¶
在 Settings 裏瀏覽並一鍵安裝¶
- 按上文命令安裝 marketplace bundle 並啓動
dsh web。 - 打開 Settings → Plugins → Marketplace。
- 搜索或按分類瀏覽；點開插件詳情查看 freshness、活動證據與社區評分鏈接。
- 對標記爲 automatic 的插件確認安裝計劃後執行；needs script review 的條目需先閱讀完整腳本再同意；manual 條目按倉庫鏈接自行處理。
Agent 會話中搜索與安裝¶
Agent 可調用 marketplace_search 查找插件、marketplace_detail 查看詳情。安裝需經 marketplace_install 且每次獲得人工批准；腳本審查類須回到 Settings UI。Agent 也可用普通 shell 工具自行安裝 marketplace：
dsh plugin --profile web add github:w2112515/dsh-plugin-marketplace#<40-char-commit>
dsh --profile web --dump-config
dsh web
安裝方案包¶
在 Marketplace 的 Solution packs 視圖選擇方案包，查看 upfront 披露的安裝構成（例如 7 one-click · 1 script-review · 1 manual），確認後安裝；腳本類條目仍須逐項審查與同意。
適用場景與注意¶
適合誰： 已在用 DSH web profile、希望從 DSH 內部發現、審查並安裝社區插件的開發者；需要 curated 方案包一次性拉齊能力基線的團隊；希望 agent 在會話中檢索插件但安裝仍受人工門禁約束的場景。
注意事項：
- 本插件與 SkillHub 社區目錄均爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係，不是官方應用商店。
- 插件以當前 DSH 進程權限運行；通過市場安裝的第三方插件同樣在該權限下生效。安裝前應閱讀目標倉庫源碼與許可證，對 needs script review 條目務必完整閱讀腳本後再同意。
- 自動安裝 pin commit 並忽略第三方 lifecycle 腳本，但不能替代你對插件作者與倉庫內容的信任判斷。
package.json要求 Node^22.19.0 || >=24.0.0，包管理器爲pnpm@11.7.0。
結尾¶
DSH Plugin Marketplace 把分散在 GitHub 的 dsh-plugin 生態收進 DSH Settings：目錄可瀏覽、安裝資格有 commit 級證據、腳本安裝需逐次同意、方案包誠實披露構成，且無遙測。若你已在用 DSH web 端擴展能力，可按官方命令安裝後在 Settings → Plugins → Marketplace 試用。
- 社區目錄：https://www.skillhub.cn/plugins/w2112515/dsh-plugin-marketplace
- GitHub：https://github.com/w2112515/dsh-plugin-marketplace
- 中文 README：https://github.com/w2112515/dsh-plugin-marketplace/blob/main/README.zh-CN.md
