@dsh-external/dsh-plugin-rankings
DSH 插件榜单：每天整理一次 dsh-plugin 生态 Top 10 / Top 100，支持按 热度（GitHub Star）或 下载量（npm 最近一周下载）降序排序，默认按热度。 入口集成在 DSH Web 设置页，与其他插件设置并列。
数据来源
| 来源 | 用途 | 接口 |
|---|---|---|
GitHub dsh-plugin 主题 | 热度主指标（Star/Fork）、仓库元数据 | api.github.com/search/repositories |
| Oh-My-DSH 聚合目录 | 分类、人工备注、活跃度信号、类型 | data/plugins.json（jsDelivr CDN） |
| awesome-dsh-plugin 精选清单 | 精选徽标与补录条目 | README 逐行解析（jsDelivr CDN） |
| npm 关键字搜索 + 周下载量 | 下载量指标、npm 包链接 | registry.npmjs.org / api.npmjs.org |
全部为公开只读接口，无鉴权；host 每天（默认 24 小时，可调 12–72 小时） 自动整理一次，也可在设置页点击「立即整理」手动触发。
功能
- 榜单范围：Top 10 / Top 100 一键切换
- 排序：热度（默认）/ 下载量，均降序；显示排名徽章（前三金银铜）
- 每个条目展示：Star、周下载、分类、活跃度、语言、License、更新时间、
来源徽标（GitHub / Oh-My-DSH / awesome / npm），可点击直达 GitHub 与 npm
- 自动整理开关与间隔设置；采集告警与失败状态可见；旧快照保留，采集失败不影响展示
架构
标准 DSH 双端 bundle 插件：
- host 半（
lib/index.js）：多源聚合管线 + 快照落盘
~/.dsh/plugins/dsh-plugin-rankings/data.json + 每日调度（启动补漏 + 每 6 小时检查） + 同源 HTTP API： - GET /api/dsh-plugin-rankings/data 快照、设置与整理状态 - GET/PUT /api/dsh-plugin-rankings/settings 用户设置 - POST /api/dsh-plugin-rankings/refresh 手动触发整理
- client 半（
lib/client.js）：注册settings.section槽位
「插件榜单」，React 组件渲染榜单与设置控件
开发
npm install
npm run build:all # tsc 编译 host + tsdown 打包 client
npm run typecheck安装
dsh plugin add /path/to/dsh-plugin-rankings
# 或热装配：改 profile package.json（link 依赖 + bundles）后重启License
MIT