插件下载榜 flysusdjd/dsh-rank-board

dsh-rank-board

在 DeepSeek Harness 里直接看 DSH 插件榜单：按 npm 真实下载量排名，日榜 / 周榜 / 月榜随时切换。

dsh-rank-board 是一个 Cordis 插件（宿主端 + Web 客户端两半）：宿主拉取社区插件目录 awesome-dsh-plugin，向 npm 官方 API 查询下载量并缓存，客户端把结果渲染在「设置 → 插件榜单」里。

插件榜单截图

_「设置 → 插件榜单」的实际界面：日榜 / 周榜 / 月榜切换，顶部显示抓取进度与限流提示。_

功能

- 日榜 / 周榜 / 月榜：同一批候选，按 last-day、last-week、last-month 三个口径分别排名。
- 本机直连 npm：抓取在宿主进程里完成，绕开浏览器 CORS，也不让页面等待几百个请求。
- 进度可见：抓取时显示进度条与百分比，结果分批落地，不必等全部完成才看到榜单。
- 限流降级：npm 返回 429 时先展示社区目录自带的 30 天下载量，并在页面顶部明确标注「不是实时数据」。
- 落盘缓存：榜单缓存 6 小时，单包下载量缓存 24 小时。重启 DSH 后榜单仍在，第二次刷新通常几秒完成。
- 一键复制安装命令：点击任意一行，复制该插件在目录里的安装命令（含正确的 profile 参数）。
- 空窗口自动抓取：第一次切到某个窗口时自动开抓，不用手动点「刷新」。

安装

前置条件：使用 DSH 的 Web / Desktop 界面（插件挂在 Web 设置页），宿主 Node.js ≥ 20。

插件通过 GitHub Release 分发（暂未发布到 npm）。

也可以在 DSH 的「设置 → 插件市场」中搜索 dsh-rank-board 一键安装。

方式一：GitHub Release（推荐）

从 Releases 复制对应版本的 .tgz 链接：

dsh plugin --profile desktop add "https://github.com/flysusdjd/dsh-rank-board/releases/download/v0.1.0/dsh-rank-board-0.1.0.tgz"

--profile 换成你实际使用的 profile（desktop 或 web）。社区目录同样支持这种 tarball 安装方式，不需要 npm 账号。

方式二：本地源码

git clone https://github.com/flysusdjd/dsh-rank-board.git
dsh plugin --profile desktop add "link:$PWD/dsh-rank-board"

安装后重启 DSH（或重新加载 profile），打开「设置 → 插件榜单」。首次打开会自动开抓，也可以点「刷新」。

数据口径与已知限制

- 下载量 ≠ 用户数：数字是 npm 统计的 tarball 下载次数，包含 CI、镜像同步、批量安装等，不等于真实使用者数量。
- 只覆盖有 npm 包名的插件：目录里 5,700+ 个条目中约 2,600 个带 npm 包名；另外 3,000+ 个只提供 tarball 的插件不会上这个榜。
- 候选池是前 400 名：npm 批量接口一次最多 128 个包，且拒绝 @scope/name。为控制请求量，只对「目录自带 30 天下载量」最高的 400 个候选做实时查询；scoped 包逐个查，整体受 120 秒截止时间约束。
- 部分数据是正常的：截止时间或限流会留下 partial: true，页面会提示再刷新补齐；已抓到的单包计数会复用，所以多次刷新会逐步收敛。
- 社区目录是唯一数据源：未收录进 awesome-dsh-plugin 的插件不会出现。

工作原理

┌────────────────────────────┐ ┌──────────────────────────────┐
│ 浏览器（client.js） │ GET │ 宿主（lib/index.js） │ │ 设置 → 插件榜单 │ ─────► │ GET /.dsh-rank-board/board │ │ 轮询进度 / 点击刷新 │ ◄───── │ POST /.dsh-rank-board/refresh│ └────────────────────────────┘ JSON └──────────────┬───────────────┘ │ 每 6 小时 / 手动 ▼ ┌──────────────────────────────┐ │ awesome-dsh-plugin 目录 │ │ npm downloads point API │ └──────────────────────────────┘ │ ▼ <profile>/.dsh-rank-board/.json

宿主端负责目录抓取、批量 / 逐个查询、限流重试、截止时间控制、结果合并与缓存；客户端只读本机接口，不直接访问 npm，也不持有任何密钥。

HTTP 接口（仅监听本机 Web 端口）

| 方法 | 路径 | 说明 |
| GET | /.dsh-rank-board/board?window=last-day\|last-week\|last-month | 返回当前榜单与抓取进度 |
| POST | /.dsh-rank-board/refresh?window=... | 触发一次后台抓取，立即返回 202 |

响应形如：

{
"ok": true,
"window": "last-week",
"updatedAt": "2026-10-17T11:51:19.138Z",
"candidates": 2607,
"shortlist": 400,
"resolved": 346,
"unresolved": 54,
"basis": "live",
"partial": true,
"rows": [{ "name": "billion-context", "owner": "ranxianglei", "downloads": 619804, "install": "…" }],
"progress": { "running": false, "phase": "done", "done": 346, "total": 400, "error": "" }
}

basis 取值为 live（实时下载量）、catalog（限流降级，目录自带 30 天数据）或 none（尚无缓存）。

配置

默认开启「冷启动 / 过期时后台自动补抓」。关闭方式：在 profile 的 cordis.patch.yml 里覆盖该条目：

- id: dsh-rank-board
name: dsh-rank-board
config:
autoRefresh: false

关闭后只能通过界面的「刷新」按钮触发抓取。

开发

git clone https://github.com/flysusdjd/dsh-rank-board.git
cd dsh-rank-board
npm test # node:test：宿主契约、HTTP 路由、目录抓取（mock fetch）、客户端注册
npm run check # 两个入口的语法检查

把源码挂进一个 profile 调试：

dsh plugin --profile desktop add "link:/absolute/path/to/dsh-rank-board"

缓存目录：<profile>/.dsh-rank-board/（board-.json 是榜单，counts-.json 是单包计数）。删掉即可强制冷启动。

目录结构

dsh-rank-board/
├── lib/index.js # 宿主端：目录 / npm 抓取、缓存、HTTP 路由 ├── client.js # Web 客户端：设置页里的榜单组件（无构建步骤） ├── cordis.patch.yml # 把插件插入 profile 的 bundle patch ├── test/plugin.test.js # 冒烟与抓取流程测试 ├── package.json └── .github/workflows/ci.yml

客户端是 DSH 的模块加载脚本（window.__ModuleLoader__.load），不是 ES module，也不经过打包器；改动后重新加载页面即可。宿主端与客户端通过 /.dsh-rank-board/ 通信。

许可证

MIT。与 DeepSeek、npm、awesome-dsh-plugin 均无官方关联。

English: dsh-rank-board 是 DeepSeek Harness 的 Cordis 插件，按 npm 真实下载量给社区插件排名（日榜 / 周榜 / 月榜），在设置页里渲染成一个区块。宿主进程抓取 awesome-dsh-plugin 目录和 npm，把榜单缓存到磁盘，再通过本地 Web 端口提供；浏览器从不直接调用 npm。从插件市场、发布 tarball 或源码安装，重启 DSH，然后打开 设置 → 插件榜单。