插件索引数据接口

一次请求返回全部收录插件的轻量摘要——验证等级、安全状态、风险等级与计数。面向 agent 与工具链(dsh-plugin-finder 等)。

接口地址
URL说明更新
/plugins-index.json注册表轻量摘要——全部插件的状态 / 风险等级 / 计数(不含逐条 findings 明细)。单请求覆盖全注册表。随站点部署重建(索引与站点一同生成)

JSON 接口支持跨域读取:Access-Control-Allow-Origin: *,无需 API Key 或注册。

响应字段
字段类型语义
generatedstring (YYYY-MM-DD)索引构建日期
generatedAtstring (ISO)构建时间戳——缓存该数据时应一并保留
sourcestring索引来源页面
countnumber插件条目数量
plugins[]array每个收录插件一条(字段如下)
plugins[].idstring插件 id(与 plugins.json 的 id、artifact slug 一致)
plugins[].namestring展示名
plugins[].descriptionstring仓库描述,截断至 300 字符
plugins[].starsnumberGitHub star 数(未知为 0)
plugins[].topicsstring[]命中的用例 / 能力主题标签
plugins[].installstring安装命令(注册表 spec,或 profile-web 默认命令)
plugins[].urlstring插件详情页绝对地址
plugins[].verificationobjectlevel(1–5)、label(人类可读)、lastVerifiedAt——与注册表 UI 共享同一推导层,索引永远与站点展示一致
plugins[].securityobjectstatusriskLevelscannedAt,有则附 countsfilesScanned。不含 findings 明细——完整扫描记录用 /artifact/<id>.json
plugins[].repoHealthobject(可选)仓库健康标记:status(renamed / deleted / 摘话题)与 renamedTo(如适用)——机器消费者可据此感知插件迁移
licenseobject数据来源与复用条款——聚合自公开来源,需注明来源

诚实原则:验证与安全字段由与注册表 UI 相同的共享推导层(src/data/artifacts.ts)计算——索引永远与站点展示一致。UI 隐藏的条目(repoHealth 打标)仍保留在索引中并附带标记。

使用方式

获取全量索引(或在浏览器打开 /plugins-index.json):

curl https://www.dsh.so/plugins-index.json

消费建议:按 verification.level 过滤、按 stars 排序、关注 security.riskLevel,并遵循 repoHealth.renamedTo 的跳转。

索引随每次部署从只追加的验证记录与公开注册表数据重建。字段只增不删:既有字段不会移除或改名。JSON 可免费引用,需注明来源 dsh.so;新增字段见 更新日志

这页有帮助吗?