插件信息核对与活跃度评分方法

使用指南更新于 2026-08-18 · 约 3 分钟阅读

基础信息核对#

DSHub 的基础信息核对覆盖三个字段：中文简介、安装命令和项目分类。每个字段独立处理，因此同一个项目可能出现“安装命令一致、中文简介待补充”的状态。

基础信息一致只代表页面内容与仓库公开材料相符，不包含代码安全审计，不代表插件不存在恶意行为、漏洞或兼容性问题，也不保证插件当前可用。安装前仍应检查源码、仓库归属和依赖变更。

信息来源#

核对优先使用项目的 GitHub README、仓库 description 与 topics、根目录 package.json、可识别的 DSH manifest，以及 npm Registry 的公开信息。详情页只展示核对结果，不展示内部缓存路径、内容哈希、重试记录或处理方式。

项目活跃度#

项目活跃度是 0 到 100 的行为指标，只反映 GitHub 上可观察的维护与协作活动。它不评价插件质量、安全性、兼容性或实际可用性。

当前 activity-score-v1 由六个维度组成：

  • 最近代码活动 35 分：最近 push 时间 20 分，近 90 天人类提交频率 15 分。
  • Issue 响应 20 分：首次人类响应、关闭比例和关闭时长中位数。
  • PR 协作 20 分：首次人类评审或响应、关闭或合并比例和处理时长中位数。
  • 贡献持续性 10 分：近 90 天活跃贡献者数量与贡献集中度。
  • Release 交付 5 分：最近 GitHub Release 时间。
  • 社区关注度 10 分：Stars 与 Forks，使用封顶档位，避免高关注项目支配总分。

Issue 和 PR 的原始数量主要作为样本量，不能直接加分。少于 3 个样本时显示 N/A，不按 0 分处理。

数据覆盖与观察期#

总分旁同时展示数据覆盖率和数据截至日期。覆盖率低于 60% 时不显示总分；60% 到 79% 标记为有限数据。接口返回数量达到抽样上限时标记为抽样数据。

创建不足 90 天的仓库统一标记为“观察期”。此时可以显示暂定分数，但不把短期集中提交描述为长期稳定维护。已归档仓库则明确显示“已归档”。

评分不要求 DSHub 先积累本地历史快照。近 90 天或 180 天窗口直接依据 GitHub 当前公开事件计算；本地快照仅用于后续展示趋势与复查公式变化。

状态说明#

  • 基础信息已核对：中文简介、安装命令和分类已有经公开材料复核的结论。
  • 自动核对：结论通过已达到质量门槛的程序规则生成。
  • 待复核：至少一个字段仍待补充或确认。
  • 资料已更新：上游仓库在最近一次来源检查后发生变化，需要重新核验。

评分版本#

评分结果保存算法版本和数据截至日期。权重或阈值调整时发布新的算法版本，不用新公式静默覆盖旧结果。当前页面只展示首批真实仓库试算，完成样本校准后再扩大覆盖范围。