插件市场 w2112515/dsh-plugin-marketplace

DSH 插件市场

为 DeepSeek Harness（DSH）打造的插件市场：直接在 DSH 自己的设置界面里浏览、查看、安装 DSH 插件——安装安全性有据可查，安装脚本需逐次授权，精选解决方案包，零遥测。

中文文档：README.zh-CN.md（界面语言跟随 DSH 自动切换）

DSH 插件市场是什么？

DSH 插件市场是一个独立于源码树、可安装的 DSH 包，为 DeepSeek Harness 加上完整的插件市场。它不属于 DSH 官方仓库，不需要改动 DSH 源码，也不是独立的网页产品。装进 web 配置档后，DSH 的 Host Loader 会挂载市场的 Host 插件，包内声明的 dsh.client 浏览器入口会在 Settings → Plugins → Marketplace 下注册自己。界面支持双语，自动跟随 DSH 的显示语言（中文 / English）。

概览：

- 2,200+ 插件，来自每天扫描所有带 dsh-plugin topic 的 GitHub 仓库——浏览不需要 GitHub 账号或 token。
- 安装资格有据可查：扫描器会验证每个插件在锁定 commit 上究竟存在哪些安装目标，所以「一键安装」意味着已证实可安装，而不是大概没问题。
- 脚本需授权：安装脚本原样展示，只有你针对这一次安装明确同意后才会运行——绝不持久化，绝不批量批准。
- 精选解决方案包，一次审核过的操作就能装好一套完整的能力基线。
- 无遥测、无安装计数、无服务器——目录就是 GitHub Pages 上的静态 JSON。

DSH 设置界面打开 Marketplace 标签页：九个分类下共 2,211 个插件，每行都有搜索、新鲜度指示和评分链接

装进你的 DSH

从 npm 安装：

dsh plugin --profile web add @w2112515/dsh-plugin-marketplace

或者从 GitHub 锁定一个不可变的 commit（本仓库把构建产物 lib/ 一并提交，所以你机器上不会跑 prepare）：

dsh plugin --profile web add github:w2112515/dsh-plugin-marketplace#<40-char-commit>

普通用户不需要 GitHub token。自动安装要求 Host 能运行 pnpm 11（插件也会尝试 corepack pnpm）；需授权的脚本安装要求 pnpm ≥ 11.7。没有包管理器时，WebUI 仍可继续浏览，并给出修复提示，而不是假装安装成功。卸载：dsh plugin --profile web remove @w2112515/dsh-plugin-marketplace。

默认目录由本仓库的 GitHub Pages 提供。开发期间可以覆盖：

$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

安装安全性

自动安装会锁定一个不可变的 40 位 commit，并且始终走「能力预检 → 短时效审核计划 → 确认后执行」这条路径；失败时回滚配置档清单、lockfile 和工作区配置。是否具备自动安装资格，由锁定 commit 上的证据决定：

| 目录条目 | 扫描器证明了什么 | 安装时会发生什么 |
| 自动安装 | 每个安装目标（入口文件、补丁）都存在于锁定 commit 的 git tree 中 | pnpm add --ignore-scripts —— 第三方生命周期脚本永不执行 |
| 需要审核脚本 | 目标缺失（构建产物未随包发布），但包声明了生命周期脚本 | 审核步骤会逐字展示脚本；你明确同意后，Host 改用 --allow-build=<name> 安装一次，而不是 --ignore-scripts，把脚本执行范围精确限定在被审核的那个包，且仅限这一次调用。不会写入 allowBuilds；同意永不被持久化 |
| 手动安装 | 以上两种情况都不满足 | 只给出仓库链接；市场从不运行任何东西 |

插件详情页：描述、新鲜度与活跃度证据、社区评分，以及经过能力检查的安装面板

解决方案包

包就是一份精选的插件仓库列表 —— 仅此而已。仓库只要同时带上 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 字符串；解析成稳定仓库 id 的动作发生在扫描时，对照目录本身完成，所以改名永远不会悄悄改写身份。
- 市场会展示每个条目的明确状态 —— 将自动安装、需要审核脚本、手动安装、不在目录中、已安装 —— 以及一个诚实的 install N of M 计数。包卡片还会提前披露安装构成（7 one-click · 1 script-review · 1 manual），这些数字在扫描时根据目录的真实情况算出。
- 安装一个包会串行执行常规的单插件「计划 → 执行」路径，遇到第一个失败就停止，不回滚任何东西，并报告每个条目的结果。
- 包不授予任何特权：受脚本门控的条目仍需各自走一遍插件级审核与同意；手动条目依然是手动。
- 包永不按 star 排名。 按 star 排名会奖励往包里塞最多 star 的插件 —— 那是伪装成策展的 star 排序分类视图，不是策展。顺序先看编辑判断（包由市场维护者审核其连贯性与诚实度，列在 FEATURED_MARKETPLACE_PACKS 中），再看新鲜度。策展遵循宁缺毋滥：能力槽位缺失就让它空着，而不是拿一个未经检验的插件去填。
如果你用 Codex、Claude Code 或 Cursor 来编写包，请安装可移植的 dsh-marketplace-publish 技能。本页内容和扫描器仍然是准入规则。

解决方案包视图，展示精选的 DSH Category Star Leaders 包及其公开的安装组成

包详情页：逐项安装状态，诚实地显示 9 项中自动安装 3 项，且不会替你做出同意

社区评分

评分沿用 GitHub 原生 reaction：每个目录插件都会在评分 issue 下获得一条投票评论，对它点 👍/👎 就是投票——每个真实 GitHub 账号一票。详情页会显示整体窗口和最近 90 天窗口，票数低于 10 时不显示任何结论。客户端只读；投票完全在 GitHub 上进行，因此 marketplace 从不保存你的凭据。

面向智能体

marketplace 是智能体原生的：Host 插件注册了四个工具，DSH 智能体可在任意会话中调用——marketplace_search、marketplace_detail、marketplace_install 和 marketplace_manual_guide。搜索和详情是只读的。安装运行的是与 WebUI 相同的 plan→execute 流水线，每次调用都会请求一次性人工批准，提示词中带有插件名、固定 commit 和风险信号——同意永不持久化，也永不批量授予。脚本门控条目按设计拒绝（逐字脚本审查留在 Settings → Plugins → Marketplace）；手动条目绝不会由 marketplace 执行——guide 工具会抓取仓库自带的安装说明，供智能体用普通 shell 工具照做。插件在 dsh web 重启后激活。在 bundle 配置中设置 agentTools: false 可禁用智能体接口。

智能体也可以用普通 shell 工具安装 marketplace 自身：

dsh plugin --profile web add github:w2112515/dsh-plugin-marketplace#<40-char-commit>
dsh --profile web --dump-config # verify the bundle layer
restart dsh web to activate

隐私立场

marketplace 对静态目录只读，绝不回传数据：没有安装计数，没有遥测，没有分析端点。这里刻意不设服务器来收集这些——目录就是 GitHub Pages 上的纯 JSON，每个安装决定都在你的机器上做出。热度信号只来自 GitHub 自己的公开数据（stars），别无其他。

工作原理

- 分发单元：一个 npm/Git/tarball 包，声明 dsh.bundle.patch。
- Host：下载并严格校验中央静态目录（schema + 完整性摘要），保留 last-known-good 缓存，并负责当前配置档的审查与变更。
- 客户端：贡献一个 settings.plugins.tab Slot，提供搜索、分类筛选、详情页、风险信号、审核确认和解决方案包。
- 宿主 / 客户端通道：包内私有、同源的 /api/plugin-marketplace JSON API。DSH 的静态 Typert Remote manifest 保持不变。
- 目录生成：每天用 GitHub Actions 扫描带 dsh-plugin topic 的仓库。只有通过静态校验、且未归档的 bundle 才能进入公开目录；被拒的保留在工作流 artifact 里。搜索命中 GitHub 的 1,000 条结果上限时，按创建时间窗口二分。只有中央扫描器使用仓库自己的 GITHUB_TOKEN。
- 分类：插件归入九个分类（theme、memory、usage、skill、security、channel、UI、tool、provider），依据是显式的 dsh-category-<slug> topic，或保守的整词匹配。没有可靠信号的插件保持未分类，而不是被错误归类。

写给插件作者

想让别人发现你的插件，仓库需要带 dsh-plugin topic、一个声明了 dsh.bundle.patch 的 package.json，以及有效的 cordis.patch.yml。可选的 dsh-category-theme|memory|usage|skill|security|channel|ui|tool|provider topic 可以显式指定目录分类。

想获得自动安装资格，bundle 加载的文件必须存在于固定 commit 的 git tree 中——把构建产物提交进去（例如 lib/），就像本仓库的做法。如果构建产物有意不提交，而由 prepare/install 脚本生成，用户会看到你的脚本原文，并可以按每次安装逐次同意运行；同意范围绝不超出已审核的 commit。

如果你用 Codex、Claude Code 或 Cursor 上架插件，请安装同一个 dsh-marketplace-publish 技能。它不能替代上面的规则。

配置

bundle 的 patch 行 id 是 plugin-marketplace。在 $DSH_HOME/profiles/web/cordis.patch.yml 中覆盖完整配置（patch 的 config 是整体替换，不做深度合并——每个字段都要写）：

- id: plugin-marketplace
config:
catalogUrl: https://w2112515.github.io/dsh-plugin-marketplace/plugin-marketplace/catalog-v1.json
maxAgeMs: 172800000
timeoutMs: 60000
maxBytes: 15000000
agentTools: true

目录是每天一次的 GitHub Pages 快照。今天刚上到 GitHub 的插件，要等下一次扫描成功后才出现。扫描失败则保留上一份快照。

仓库结构

dsh-plugin-marketplace/
├── package.json
├── cordis.patch.yml
├── src/
│ ├── index.ts # Host plugin & same-origin API
│ ├── catalog*.ts # schema, network, LKG cache, queries
│ ├── profile-operations.ts # plan/confirm/rollback, consent-gated execution
│ └── client/ # WebUI Slot plugin (zh/en)
├── scripts/ # GitHub scanner (plugins + packs)
├── website/public/ # workflow-generated static catalog
└── .github/workflows/ # CI and the daily Pages publication

本地开发

需要 Node.js ^22.19.0 || >=24 和 pnpm 11。

cd D:\Work\dsh-plugin-marketplace
pnpm install --frozen-lockfile
pnpm run build
pnpm run check
pnpm pack --dry-run

非目标

- 不向 deepseek-ai/deepseek-harness 提交代码，也不要求它发版。
- 不修改 DSH 的 Web bundle、Settings Slot、API Remote 或命令行源码。
- 浏览器从不直接访问 GitHub API；用户无需配置 token。
- 未经用户逐次安装、逐次提交的明确同意，生命周期脚本绝不运行。
- 不做任何形式的遥测——包括安装计数。

链接

- DeepSeek Harness —— 宿主项目
- DSH Category Star Leaders —— 方案包，列出每个分类中星标最高的目录条目（机械生成，带快照日期）
- DSH Marketplace Publish —— 可移植的 Agent Skill，用来上架插件、创建方案包
- linux.do —— 新的理想型社区（友链）