dsh-rank-board
DeepSeek Harness 内的插件下载排行榜——社区目录中每个插件的实时安装次数。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:flysusdjd/dsh-rank-board#a9e9b690afa2286b0020170fc91ba544e0084594
Rank Board 以 dsh-rank-board 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness 里直接看 DSH 插件榜单：按 npm 真实下载量排名，日榜 / 周榜 / 月榜随时切换。
dsh-rank-board 是一个 Cordis 插件（宿主端 + Web 客户端两半）：宿主拉取社区插件目录 awesome-dsh-plugin，向 npm 官方 API 查询下载量并缓存，客户端把结果渲染在「设置 → 插件榜单」里。
「设置 → 插件榜单」的实际界面：日榜 / 周榜 / 月榜切换，顶部显示抓取进度与限流提示。
last-day、last-week、last-month 三个口径分别排名。前置条件：使用 DSH 的 Web / Desktop 界面（插件挂在 Web 设置页），宿主 Node.js ≥ 20。
插件通过 GitHub Release 分发（暂未发布到 npm）。
从 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），打开「设置 → 插件榜单」。首次打开会自动开抓，也可以点「刷新」。
@scope/name。为控制请求量，只对「目录自带 30 天下载量」最高的 400 个候选做实时查询；scoped 包逐个查，整体受 120 秒截止时间约束。partial: true，页面会提示再刷新补齐；已抓到的单包计数会复用，所以多次刷新会逐步收敛。┌────────────────────────────┐ ┌──────────────────────────────┐
│ 浏览器（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，也不持有任何密钥。
| 方法 | 路径 | 说明 |
|---|---|---|
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 is a Cordis plugin for DeepSeek Harness that ranks community plugins by real npm download counts (daily / weekly / monthly), rendered as a settings section. The host process crawls the awesome-dsh-plugin catalog and npm, caches boards on disk, and serves them on the local web port; the browser never calls npm directly. Install via the release tarball or from source, restart DSH, then open Settings → 插件榜单.