前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的扩展方式，社区插件数量一多，新人往往不知道先装什么：目录站能搜到包，但缺少「大家最近在关注、在装什么」的参照。手动翻 GitHub 星标、再对照 npm 下载，既费时间，两类指标还常常对不齐——老插件下载高但星标被新包冲淡，新插件批量安装却还没攒够 star。
下面介绍的 dsh-plugin-star-radar（插件热度榜）在 DSH 里提供一块可搜索、可排序的「插件雷达」页面：用 GitHub 收藏数做主排序，同时展示近 30 天 npm 下载量，并按统一收录规则决定哪些插件出现在榜上。维护者为 Moon-Cold-Sir，当前 npm 包版本 3.2.0，许可证 MIT。
这是什么¶
dsh-plugin-star-radar 面向刚接触 DSH、需要「该装哪些插件」参考清单的开发者。它只回答一个问题：哪些 DSH 插件正在被关注和安装？
收录条件是两条指标的并集（满足其一即收录）：
- GitHub stars ≥ 3,000；或
- 近 30 天 npm 下载量 ≥ 100,000。
一旦收录，即使之后两项都低于阈值，插件仍会在 已跌出 · 保留 分组中保留一段时间（默认 180 天），并保留最后一次测到的数字，便于几个月后仍能搜到。
与仅看下载或仅看 star 相比，插件 README 说明：收录取并集、排序以 star 为先；降温后的插件仍留在页面上，更适合做长期参考列表。
核心功能¶
安装并在 Web 配置侧启用后，插件在 DSH 中注册区块 id plugin-radar（与旧版 dsh-plugin-radar / dsh-plugin-download-radar 相同，三者只能启用其一）。
页面能力（均来自官方 README）：
- 分组展示：按 star 档位（如 ★ 5k+、★ 3k+、仅下载达标等）分组，层级一目了然。
- 搜索：支持按名称、包名、描述、分类检索。
- 分类筛选：分类数据来自市场索引。
- 排序：可按 stars、近 30 天下载量、名称排序。
- 卡片详情：stars、下载量、收录原因、收录日期、Node/DSH 版本范围、OS/CPU、包体积、权限说明、手动安装命令、仓库链接等。
- 一键安装：优先走官方
pluginManager.installBundle；失败时回退到 profile 的 pnpm，并提供可复制的手动命令。
数据来源设计要点：
| 数据 | 来源 |
|---|---|
| 插件列表、GitHub stars、30 天下载、分类、描述、图标 | 单次请求 https://awesome-dsh-plugin.com/plugins.json |
| Node/DSH 范围、os/cpu、安装脚本、包大小 | 仅对已收录插件请求 https://registry.npmjs.org/<pkg>/latest |
为避免刷新时 npm 下载历史接口触发 HTTP 429 导致卡住，插件不对每个包单独调用 api.npmjs.org/downloads/range；manifest 读取有预算，缺失环境说明不会阻塞榜单渲染。
安装与启用¶
DSH 要求 Node ≥ 20，插件声明的 dsh 兼容范围为 >=0.2.0-rc.1 <0.3.0-0 或 >=0.2.1-0 <0.3.0-0（具体见 package.json 的 engines 与 dsh.compatibility）。
桌面端（推荐）¶
打开 Settings → Plugins → Install，粘贴：
dsh-plugin-star-radar
也可在本插件热度榜任意卡片上点击 安装 / Install。
CLI¶
dsh plugin --profile web add dsh-plugin-star-radar
本地路径安装¶
若使用本地 checkout，README 示例为：
pnpm add "file:D:/path/to/dsh-plugin-star-radar"
并在 profile 的 package.json 里把 "dsh-plugin-star-radar" 加入 dsh.profile.bundles，然后重启 DSH。
从旧雷达迁移¶
若曾使用 dsh-plugin-radar 或 dsh-plugin-download-radar，需先禁用并移除旧插件——三者共用 section id plugin-radar，不能同时启用。
配置¶
在 profile 的 cordis.patch.yml 中可覆盖默认阈值与刷新行为，示例：
- id: plugin-radar
config:
minStars: 3000
minDownloads: 100000
intervalHours: 6
常用配置项（默认值以 README 为准）：
| 键 | 默认 | 含义 |
|---|---|---|
minStars |
3000 |
达到该 star 数即收录 |
minDownloads |
100000 |
近 30 天下载达到该值即收录 |
retainDays |
180 |
跌出双阈值后仍展示的天数 |
intervalHours |
6 |
后台刷新间隔（1–168 小时） |
catalogTtlHours |
12 |
市场索引缓存 |
metaTtlHours |
24 |
npm manifest 缓存 |
maxManifest |
80 |
参与环境说明的 manifest 数量上限 |
manifestBudgetMs |
90000 |
manifest 阶段时间预算，超时跳过 |
catalogUrl / npmRegistry |
官方 | 可改为镜像 |
dataDir |
<profile>/.dsh-plugin-radar |
缓存目录 |
典型用法¶
- 安装并重启 DSH 后，在 Web 设置侧打开插件热度榜页面。
- 用搜索或分类筛缩小范围，再按 stars 或 近 30 天下载 排序，对比卡片上的收录原因与环境信息。
- 对目标插件使用一键安装；若环境限制一键安装，复制卡片上的手动安装命令在 CLI 或 pnpm 中执行。
- 需要更严或更松的收录标准时，修改
cordis.patch.yml中的minStars/minDownloads，按需调整intervalHours控制刷新频率。
维护者提供的离线自检命令（开发或排查时可参考）：
node scripts/live-check.mjs
该脚本会请求真实市场索引并打印榜单，需在插件源码目录下执行。
适用场景与注意¶
适合：刚搭建 DSH、希望按社区关注度选插件的开发者；需要同时看 GitHub 星标与近期安装热度的场景；希望「曾经上过榜」的插件在降温后仍能在保留组里找到的情况。
注意：
- 社区目录与索引（如 awesome-dsh-plugin.com）为独立站点，并非 DeepSeek / 幻方官方应用商店；榜单反映索引与 npm/GitHub 公开数据，不构成安全或质量背书。
- DSH 插件以当前 DSH 进程权限运行；一键安装或执行 README 中的命令前，应自行查看目标插件源码与许可证。
- 勿与旧版 radar 插件并存，避免
plugin-radar冲突。 - 若使用镜像或内网 registry，可通过
catalogUrl、npmRegistry指向可用端点。
结尾¶
dsh-plugin-star-radar 把「该装什么 DSH 插件」收敛成一块可配置阈值、可搜索排序的热度榜，并用 sticky 收录规则避免优质插件一旦跌出阈值就从视野里消失。需要进一步了解时可查看 SkillHub 目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/Moon-Cold-Sir/dsh-plugin-star-radar
- GitHub：https://github.com/Moon-Cold-Sir/dsh-plugin-star-radar
