插件注册表 vbarter/dsh-plugin-registry

DeepSeek Harness 社区注册表

生产站点 / Live site: https://dsplugin.app/ 社区 DeepSeek Harness 插件目录（非官方）· Community dsh plugin directory (unofficial)

社区插件注册表静态站。浏览、详情、发布、统计、收录规范五页，无构建步骤。站点数据就是提交在仓库里的 data/plugins.json（schemaVersion 2）。GitHub Actions 是官方后端：定时扫描 dsh-plugin topic，用户发布走 Issue → 预检 → 审核 PR。

所有目录写入都走 GitHub PR，不会直接推 main：用户提交（submission/<n>）、自动发现（discover/sync）、社区目录 Manifest 复核（review/curated-manifest）。维护者在 Pull Requests 合并后，站点数据才更新。

仓库：vbarter/dsh-plugin-registry

自动发现怎么工作

1. .github/workflows/discover.yml 每 2 小时（20 /2 * ）或手动 workflow_dispatch 运行。
2. scripts/discover.mjs 调用 GitHub Search：topic:dsh-plugin，跟随 Link 分页。
3. 对每个仓库读取根目录 package.json。同时满足 topic 含 dsh-plugin，并且具备下列之一，即视为 DSH 插件：
- dsh.bundle（patch 为不含 ..、非绝对路径的相对路径 → Manifest shape_validated）
- dsh.plugin
- 名称/简介明显与 DSH 相关
4. 写入站点存储 data/plugins.json：
- source: "discovered"
- 已有 source: "curated" 的条目会保留，只更新 stars / forks / pushedAt / icon
- 新发现的插件追加
- 已消失且确认归档/404 的 discovered 条目会删除；不会清掉 curated
- 不会改动 data/submissions.json
- 若新快照 published 数量比上一版下降超过 40%，中止写入
5. 仅当 plugins.json 有变化时，推到分支 discover/sync 并开（或更新）一条 PR：Review: discovered dsh plugins。不再直接推 main。
6. 社区目录 Manifest 复核：手动跑 .github/workflows/review-curated.yml（node scripts/discover.mjs --review-curated），有改动则开/更新 review/curated-manifest PR。

本地也可跑同一脚本：

建议设置 PAT，否则未认证搜索很容易 60 次/小时限流
export GITHUB_TOKEN=ghp_...
node scripts/discover.mjs

只处理一个仓库
node scripts/discover.mjs --repo owner/repo

复核社区目录里尚未检查的 Manifest（不删行）
node scripts/discover.mjs --review-curated

Actions 里 GITHUB_TOKEN 会自动注入，公开搜索不需要额外 secret。未认证限额很低；仓库级 token 的 Search 限额大约 30 次/分钟。若要扫得更全，可在仓库 Settings → Secrets 放入个人 PAT，并在 workflow 里改用该 secret（仍可命名为覆盖 GITHUB_TOKEN 的自定义 secret）。

用户如何发布

正式通道是本仓库的 GitHub Issue，没有单独账号。

1. 打开 publish.html，输入 owner/repo 或 GitHub URL，先跑浏览器预检。
2. 点「提交」会打开预填 Issue（模板：.github/ISSUE_TEMPLATE/plugin_submission.yml，字段：仓库 URL、owner/repo、备注）。
3. .github/workflows/ingest-submission.yml 在 Issue 打开或打上 submission 标签后运行：
- 从正文解析 GitHub 仓库
- 单仓发现：Manifest 通过 → 写入 data/plugins.json（source: "curated"）；否则写入 data/submissions.json 待审
- 在 Issue 下评论结果
- 提交到分支 submission/<issue-number> 并 gh pr create
4. 维护者合并 PR 后，站点数据才更新。

流程一句话：用户提交 Issue → Action 预检 → 开 PR → 维护者合并 → 站点数据更新。

本地预览

python3 -m http.server 8787

打开 http://127.0.0.1:8787/。前端一次加载 /data/plugins.json。语言：顶栏 中文 / EN，写入 localStorage 键 dsh-registry.locale（默认 zh），也可用 ?lang=en / ?lang=zh。

页面

| 文件 | 路由 |
| index.html | 浏览、搜索、筛选 |
| plugin-detail.html?plugin=<id> | 详情 + 安装弹层 |
| publish.html | 仓库预检 → GitHub Issue |
| dashboard.html | KPI 与榜单 |
| policy.html | 收录规范（中英全文） |
浏览页查询串：?q=&category=&source=&manifest=&language=&sort=&lang=。

配置：data/config.json → { "repo": "vbarter/dsh-plugin-registry", "topic": "dsh-plugin", "discoverEvery": "2h" }。

Cloudflare 部署

静态输出目录是仓库根目录。把 Cloudflare Pages 接到本仓库、生产分支 main 即可；GitHub Actions 不需要 Cloudflare secret。.github/workflows/pages.yml 只是提醒，不会调用 wrangler。

可选：本机用 wrangler 推一次（未要求不要跑）
npx --yes wrangler@3 pages deploy . --project-name=dsh-plugin-registry --branch=main

部署到生产后，可把 10 条 P0 URL 提交给 IndexNow（api.indexnow.org 与 Bing）：

node scripts/indexnow.mjs

密钥文件是仓库根目录的 {key}.txt（内容即 key），线上地址 https://dsplugin.app/{key}.txt。合并进 main 并完成部署后再跑；不要编造 Bing Webmaster 验证码。

线上站点： https://dsplugin.app/

DeepSeek Harness 插件的静态社区注册表。提交进仓库的 data/plugins.json 就是站点数据存储；GitHub Actions 是后端。

所有目录写入都走 GitHub PR —— 绝不直接 push 到 main。维护者在 Pull Requests 合并：

- 用户提交 → submission/<n>
- 发现同步 → discover/sync
- 精选 Manifest 审核 → review/curated-manifest

发现。 scripts/discover.mjs 搜索 topic:dsh-plugin，读取每个根目录的 package.json，把插件合并进快照。精选行保留。已消失且*归档或缺失的发现行会被丢弃。published 下降超过 40% 就中止写入。Cron：每 2 小时一次；如果 plugins.json 有变化，工作流会在 discover/sync 上开启或更新一个 PR，而不是 push main。在 Actions 里做公开搜索，GITHUB_TOKEN 就够了；未认证运行很快会撞上速率限制。

精选 Manifest 审核。 node scripts/discover.mjs --review-curated（手动 workflow_dispatch）重新检查 Manifest 缺失或为 not_checked 的精选行。行永远不会被丢弃；404 或未分类的仓库标记为 not_validated。改动进入 review/curated-manifest。

发布。 用户在 vbarter/dsh-plugin-registry 上开一个预填好的 Issue。摄取工作流预检仓库，写入 plugins.json（精选）或 submissions.json（待定），在 Issue 上评论，并开启 PR submission/<n>。维护者合并后站点更新。

本地。 node scripts/discover.mjs 或 --review-curated（能设就设 GITHUB_TOKEN）。用任意静态服务器托管。语言：中文 / EN，持久化为 dsh-registry.locale，可用 ?lang= 覆盖。