星标飙升榜数据接口
一次请求返回 DSH 插件的 GitHub 星标 1 周增量前 100 名——含基线与当前星数,派生自每日热度快照。(首页 ★ 榜 2026-09-27 起改为 star 排行榜,不再展示增量口径。)
接口地址
| URL | 说明 | 更新 |
|---|---|---|
/data/star-trend.json | 1 周窗口内星标增量前 100 名,每个插件一条,按增量降序。 | 随部署重建;星数取自最近一次每日热度快照 |
/data/star-trend.schema.json | 本接口数据格式对应的 JSON Schema。 | 稳定 |
JSON 接口支持跨域读取:Access-Control-Allow-Origin: *,无需 API Key 或注册。
响应字段
| 字段 | 类型 | 语义 |
|---|---|---|
generatedAt | string (ISO) | 构建时间戳——缓存副本请一并保留 |
snapshotDate | string (YYYY-MM-DD) | null | toStars 数值来自哪一份热度快照;无快照时为 null(此时 items 为空) |
baselineDate | string (YYYY-MM-DD) | null | 基线快照日期(不晚于 snapshotDate − 7 天的最近一份);fromStars 来自它 |
window | object | days = 基线→最新的实际跨度(如实汇报,快照有缺口时可能不是整 7 天)、start / end = 基线 / 最新日期 |
scope | object | 收录口径:listableOnly(仅站内列表口径)、ecosystemAppsExcluded(排除生态应用)、newlyIndexedExcluded(窗口内新入库不上榜)、pulseFiltered(脉冲式涨星剔除) |
limit | number | 100——本接口只提供前 100 名 |
count | number | 榜单条目数(≤ limit) |
items[] | array | 榜单条目,按 deltaStars 降序(字段见下) |
items[].rank | number | 名次(1–100) |
items[].id | string | 插件 id(与 plugins.json 的 id、详情页 slug 一致) |
items[].name | string | 展示名 |
items[].fromStars | number | 基线快照时的星数(窗口起点) |
items[].toStars | number | 最新快照的星数(= 当前 GitHub 星数) |
items[].deltaStars | number | 窗口内星标增量——排序键 |
items[].url | string | 插件详情页绝对地址 |
license | object | 出处与引用条款——聚合自公开 GitHub 仓库,引用需注明来源 |
诚实原则:本接口与首页 ★ 模块读同一份每日热度快照(src/data/trending.ts)。首页 ★ 榜 2026-09-27 起改为 star 排行榜(按当前星数排序);本接口是独立的 1 周增量切片。脉冲式涨星不上榜:窗口内有 ≥2 次真实星数更新时,单日最大增量超过窗口增量一半的条目剔除——一天跳出来的量不代表一周的真实热度。
使用方式
获取星标飙升前 100 名(或在浏览器直接打开 /data/star-trend.json):
接口固定只输出前 100 名。单插件详情(验证等级、安全、安装方式)用 id 关联 /plugins-index.json 或 /plugin/@作者/插件名.json;npm 下载排名在 /data/npm-downloads.json。
榜单随部署重建,数据来自 dsh.so 流水线每日采集的热度快照。字段只增不删:既有字段不会移除或改名。可免费引用,需注明来源 dsh.so;新增字段见 更新日志。