插件榜单nanami-0713/dsh-plugin-rankings

@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