DSH Plugin Marketplace

DSH Plugin Marketplace 是一个 仓外可安装的 DeepSeek Harness bundle。它不属于 DSH 官方仓库，不要求修改或合并 DSH 源码，也不是独立 Web 产品。

用户把本包安装进 web profile 后，DSH 的 Host Loader 会挂载市场 Host 插件；同一个包声明的 dsh.client 浏览器入口会自动注册到 设置 → 插件 → 插件市场。

当前定义

• 分发单元：一个 npm/Git/tarball package，声明 dsh.bundle.patch。
• Host：下载并严格校验中央静态目录，维护 last-known-good 缓存，并拥有当前 profile 的安装审核与写入。
• Client：通过现有 settings.plugins.tab Slot 提供检索、筛选、详情、风险判断和审核确认界面。
• Host/Client 通道：包私有、同源的 /api/plugin-marketplace JSON API；不修改 DSH 的静态 Typert Remote 清单。
• 目录生产：本仓库 GitHub Actions 每日扫描带 dsh-plugin topic 的候选仓库，只有静态校验通过且未归档的 Bundle 才进入用户目录；拒绝项只保存在 workflow artifact。遇到 GitHub Search 1,000 条上限时按创建时间窗口递归拆分。
• 用户侧 GitHub：普通用户不需要 GitHub 账号、Token 或 VPS；只有中央扫描 workflow 使用仓库自带的 GITHUB_TOKEN。
• 安装安全：只允许目录中固定到 40 位 commit、静态校验与预构建入口证据通过、且不含 lifecycle/build scripts 的 bundle 进入自动安装；执行前先生成短期审核 plan，安装阶段强制 --ignore-scripts，失败恢复 profile manifest、lockfile 和 workspace 配置。

原先的 workspace 集成方案已失效，完整历史保存在 docs/legacy-workspace-plan.md，不能再作为实现或发布依据。

目录结构

dsh-plugin-marketplace/
├── package.json
├── cordis.patch.yml
├── src/
│   ├── index.ts                 # Host 插件与同源 API
│   ├── catalog*.ts             # schema、网络与 LKG 缓存
│   ├── profile-operations.ts   # plan/confirm/rollback
│   └── client/                 # WebUI Slot 插件
├── scripts/                    # GitHub scanner
├── website/public/             # workflow 生成的静态目录
└── .github/workflows/          # CI 与每日 Pages 发布

本地构建

要求 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

安装到本机 DSH

普通用户不需要 GitHub Token。自动安装需要 Host 能调用 pnpm；插件也会自动尝试 corepack pnpm。两者都不可用时，WebUI 会保持浏览能力并给出恢复提示，不会显示假成功。

默认目录由本仓库的 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

从 GitHub 安装时必须固定 commit：

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

本仓库提交构建后的 lib/，因此 Git 安装不需要在用户机器上执行 prepare。发布 npm 后可改为：

dsh plugin --profile web add dsh-plugin-marketplace

卸载：

dsh plugin --profile web remove dsh-plugin-marketplace

配置

bundle 插入的 row id 是 plugin-marketplace。用户可在 $DSH_HOME/profiles/web/cordis.patch.yml 覆盖完整配置：

- id: plugin-marketplace
  config:
    catalogUrl: https://w2112515.github.io/dsh-plugin-marketplace/plugin-marketplace/catalog-v1.json
    maxAgeMs: 172800000
    timeoutMs: 15000
    maxBytes: 5000000

patch 对 config 是整体替换，不是深度合并，因此覆盖时必须写全所有字段。

使用插件市场

• 第一次打开且没有缓存时，页面会等待首次目录抓取，不需要再手动点击刷新。
• 页面只显示静态校验通过的 DSH Bundle；GitHub topic 只是候选发现信号，普通仓库和 DSH 平台仓库不会进入用户列表。
• 列表按 50 条分页，并在 Host 侧完成搜索、筛选和排序；浏览器不会下载或渲染整份目录。
• “自动安装”会把固定 commit 安装到当前 Web profile 并加入 Bundle 层，成功后必须重启 DSH 才会启用。
• “需手动安装”表示现有静态证据不足以安全执行；市场只展示来源和说明，不绕过构建脚本授权。

MVP 完成条件

只有同时满足以下证据才称为仓外 MVP 完成：

1. package.json/cordis.patch.yml 静态 bundle preflight 通过。
2. 构建产物包含 Host、Client、类型和 patch，且不包含密钥、本地缓存或 DSH 源码副本。
3. 精确 tarball 安装进隔离 web profile 后，--dump-config 能看到 plugin-marketplace layer 与 row。
4. 从已安装产物启动 WebUI，插件市场 tab 可见；无缓存首开自动加载，缓存、离线和刷新失败路径可恢复。
5. 用户目录只包含有效且未归档 Bundle，DSH root 等非 Bundle 候选只进入拒绝 artifact。
6. 安装操作必须经过 capability preflight、plan/review/execute；成功明确要求重启，失败回滚和卸载路径得到验证。

非目标

• 不向 deepseek-ai/deepseek-harness 提交代码或要求官方发布。
• 不修改 DSH 的 Web bundle、Settings Slot、API Remote 或 CLI 源码。
• 不让浏览器直接访问 GitHub API，不要求每个用户配置 GitHub Token。
• 不执行未审核仓库的 lifecycle/build scripts。
• Solution Pack 属于后续里程碑，不进入当前 bundle MVP。