前言¶
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
