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

Harness Registry — DeepSeek Harness 插件注册表

Harness Registry 是给 DSH 用户和插件作者用的可搜索 DeepSeek Harness 插件注册表。它把社区维护的目录和 GitHub 发现结果合在一起，校验可安装的 dsh.bundle 清单契约，并给出可比较的插件元数据和可直接复制的安装命令。

状态：预发布。注册表地址是 plugin.dshdesk.com，源码以 MIT License 发布。见上线就绪情况。

Harness Registry 浏览已验证、已收录和候选的 DSH 仓库

快速开始

环境要求：Node.js 22 和 npm。

git clone https://github.com/majiayu000/dsh-plugin-registry.git
cd dsh-plugin-registry
npm ci
npm run dev

打开 <http://localhost:5173> 即可浏览、搜索、筛选和查看注册表。

提供什么

- 可搜索的网页目录，带分类、信任标签、Stars、Forks 和安装命令。
- 从社区目录收录进来的条目，存放在 sources/curated.json。
- 从 GitHub dsh-plugin topic 自动发现。
- 清单校验：发现到的仓库必须在 package.json 里声明合法的 dsh.bundle 对象，且它引用的补丁文件必须存在。
- 供应链锁定：每个已验证插件都记录校验清单时对应的确切 verifiedCommit HEAD。
- 公开 JSON 快照，带 schema 校验、健康门禁和单独的审计队列。
- 每个页面都显示快照新鲜度，超过 24 小时给出过期警告，定时同步失败时自动开 GitHub issue。
- 严格的逐页 Content-Security-Policy，图标仅限 GitHub 托管的域名。
- 仓库检查器，说明某个插件是否符合自动发现条件。
- 可选的站内评审表单，通过受保护的 Cloudflare Pages Function 创建已指派、公开的 GitHub Issue。

查询注册表数据

生成的快照位于 public/data/plugins.json，遵循 schema/registry.schema.json。

jq '.stats | {published, curated, automaticallyDiscovered, pendingReview}' public/data/plugins.json

查看单个插件：

jq '.plugins[] | select(.id == "omdsh-dev/dsh-at-file") | {id, trustLevel, install}' public/data/plugins.json

校验快照并运行治理测试：

npm run validate:registry
npm test

回填 GitHub 主要语言元数据，无需重跑完整发现流程：

GH_TOKEN=... npm run backfill:languages

发现流程如何运作

Vendored curated catalog (sources/curated.json) ─┐
├─ normalize ─ verify ─ governance ─ public registry
GitHub topic ────────────────────────────────────┘ └──── audit queue
精选仓库会获得 curated 信任级别。自动发现的仓库只有在根目录 package.json 里含有有效的 dsh.bundle 时才能安装，这些仓库会获得 manifest_verified。待定仓库仍会作为 GitHub 候选显示，但不提供安装命令；已屏蔽和已隔离的仓库则保持隐藏。完整策略见 registry governance。

定时 GitHub Actions 工作流每两小时刷新一次快照。仓库注册表发生变化时，同一个工作流会提交快照，并把验证过的构建产物部署到 Cloudflare Pages，因此用 GITHUB_TOKEN 创建的同步提交不依赖第二次 push 事件。健康门禁会阻止以下情况替换健康数据：未认证的部分发现运行、完整快照意外变小、GitHub GraphQL 批次只返回部分结果。如果定时同步失败，工作流会开一个带标题的跟踪 issue，并在后续某次同步成功部署后关闭它。

Cloudflare Pages 上的详情投递

首页和仪表盘是预渲染的。插件详情 URL 由 Pages Function 提供，返回完整 HTML（包括 canonical URL、结构化数据和内联水合数据）。GET /api/plugins/{owner}/{repo}/{qualifier...}/ 返回同样的详情记录，格式为 JSON，供安装按钮使用；两条路由都支持 HEAD。插件不存在返回 404，路径格式错误返回 400，快照资源损坏返回 500。错误不会被缓存。

构建会从现有仓库注册表快照中派生出 256 个详情分片。每个请求读取体积很小的版本产物 data/detail-build.json。缓存未命中时，HTML 会加载一个分片和编译好的 HTML 模板；JSON 只加载分片。成功的响应使用 Workers Cache API 和 Cache-Control: public, max-age=0, s-maxage=300。浏览器请求会重新验证；边缘缓存键包含每次构建生成到该产物里的新版本号，因此新部署不会复用上一次构建的 HTML 或数据。运行时不需要任何构建环境变量。这样避免了每个请求都解析完整快照，也消除了每个插件一个文件的部署增长。静态资源继续走 Pages 投递。动态请求仍会消耗 Pages Functions 配额，分片体积也会随数据集增长。

这一方案改编自 Astro integrations directory 使用的快照支撑动态路由。每个插件单独生成静态 HTML 会受限于文件数量上限；完全由数据库支撑的注册表则会引入这套只读目录并不需要的基础设施。不需要新的数据库、存储绑定或前端框架。
用 npm run dev:cloudflare 在本地构建并运行真实的详情路由。npm run dev 对前端开发仍然有用，但 Vite 单独跑不起来 Pages Functions。验证：先跑 npm test、npm run build、npm run check:performance，再用 Wrangler Pages dev 跑一遍 HTML/JSON、缓存命中、404 和安装流程。

添加插件

自动发现流程：

1. 发布一个真实、公开、非 fork 的 GitHub 仓库。
2. 在插件的 package.json 里声明可安装的 dsh.bundle 对象（放在根目录，或 dsh.bundles 中列出的某个路径）。
3. 确认引用的补丁文件存在，且是顶层 YAML 数组（空的 [] 也有效）。
4. 加上 dsh-plugin 这个 GitHub topic。
5. 等待下一次注册表同步。

发布前先检查本地检出：

npm run check:plugin -- ./hello-plugin

使用公开的仓库检查器与故障排查指南，本地开发时用 <http://localhost:5173/publish.html>。配置好 Cloudflare 提交渠道后，作者不用离开页面就能提交可跟踪的审核请求；GitHub 仍可作为备选。参见提交审核配置。

已知限制

- Manifest 与补丁文件校验只确认 bundle overlay 存在、且是顶层 YAML 数组；这不是安装测试、安全审计，也不代表认可插件代码。
- 记录过 SHA 时，GitHub 安装命令会锁定到 verifiedCommit。npm 风格的 spec 不锁定 commit。
- Stars、Forks、描述、Topics 和主要语言都是 GitHub 元数据的时间点快照，可能滞后到下一次同步。
- 完整的发现刷新需要 GitHub token；未认证运行只检查近期候选，且无法覆盖完整快照。
- 基于浏览器的仓库检查器使用未认证的 GitHub API，可能触发速率限制。
- Cloudflare Pages 站点跟踪 main；正式版本化发布尚未提供。

开发

npm ci
npm test
npm run validate:registry
npm run build

刷新注册表数据时，提供一个有公开仓库读取权限的 GitHub token：

GITHUB_TOKEN=... npm run sync:plugins

从当前快照重新生成内置的精选目录：

npm run export:curated

不要提交 token 或生成的凭据。变更流程见 CONTRIBUTING.md。

项目结构

- assets/ 存放注册表 UI 模块、样式和翻译。
- public/data/plugins.json 是生成的公开注册表快照。
- scripts/ 存放发现、规范化和校验工具。
- functions/ 存放 Cloudflare Pages 的服务端路由，用于审核提交。
- schema/registry.schema.json 定义已发布快照的契约。
- tests/ 覆盖注册表治理和面向浏览器的行为。

支持与安全

- Bug、数据纠错和功能请求：GitHub Issues
- 敏感漏洞：私密漏洞报告
- 安全策略：SECURITY.md

许可证

Harness Registry 基于 MIT License 发布。