RepoPicks Radar 如何评估 GitHub 项目

在你下载任何东西之前，RepoPicks Radar 会针对每个 GitHub 项目尝试回答三个问题：它是做什么的、在你的电脑上安装有多容易，以及有没有出现值得留意的情况。答案都放在一张资料卡里，评级、标签和标记几秒钟就能看懂。

本指南解释它们各自代表什么，以及资料卡是怎么做出来的，让你知道每条信息有多大参考价值，又该在哪里多看一眼。

每天运行的例行流程

每天，一个自动流程会读取 GitHub 上的公开数据，找出增长最快的开源项目：星标涨得最快的、下载最多的，以及刚刚开始受到关注的。GitHub 上的星标就像“收藏”：很多人在短时间内收藏同一个项目，说明它正在被更多人发现。

每个新项目都要经过自动检查。这些检查会查找已知的风险信号，并把发现的一切证据保存下来。然后，一个 AI 阅读项目自己在 GitHub 上发布的内容，比如项目介绍、已发布的版本、许可证和安装说明，并按照 Radar 的规则，用通俗的语言写出资料卡。

接着，另一个独立于撰写者的 AI 会审核这张资料卡，把每一项说法和证据逐一对照。资料卡通过这次审核之后，才会出现在网站上。GitHub 的数字，如星标、下载量和增长，每天更新；已经发布的资料卡也会经常重新接受检查。

资料卡以英文撰写，再翻译成西班牙文、葡萄牙文和中文。证据，比如 README 的片段，以原文显示，让你能原样看到项目自己写了什么。

安装难易度：从 A 到 E

易用度说明在你的电脑上让程序运行起来要花多少功夫，依据的是安装包，以及项目自己写明的步骤。越接近 A，你需要懂的技术就越少。

• A · 下载即用。项目提供安装包或现成的程序。你下载、打开就能用，和普通程序一样。
• B · 安装程序加一个简单步骤。像普通程序一样安装，但第一次使用之前要多做一步，比如在应用里下载一个 AI 模型，或者填入访问密钥。
• C · 需要安装 1–2 个工具。在安装程序之前，你要先装一两个工具，比如 Python，并按说明输入几条命令。
• D · 终端、多个工具或特定显卡。需要用到终端和多个工具，或者 Docker，或者某一种特定的显卡。
• E · 仅适合程序员。需要自己编译代码、配置服务，或者项目根本没有面向普通使用者的安装说明。

如果你不会编程，A 级项目最省心，B 级项目通常只要有点耐心也能顺利用起来。从 C 级起，开始之前最好先读一遍说明。指南《不会编程，如何从 GitHub 下载并安装程序》一步步演示了整个过程。

评级因系统而异

同一个程序，在 Mac 上可能很简单，在 Windows 上却很麻烦。所以易用度是分别针对 Windows、macOS、Linux 和 Web 给出的，其中 Web 指的是有可以直接在浏览器里运行的版本。某个系统没有评级，表示项目不能在该系统上运行；这不会拉低其他系统的评级。

在程序列表里，标签显示的是项目最容易安装的那个系统的评级。如果你在“系统”筛选里选了某个系统，标签就会改为显示该系统的评级。在资料卡里，“安装难易度”一节把各系统的评级并排列出，并附上一句话说明原因。

风险信号

风险信号是在项目里发现的、安装之前值得留意的情况。每个信号都附有证据，比如 README 的一段话、一个文件或一项 GitHub 数据，让你亲眼核对，而不是只相信评级。

信号分为三个级别：

• 信息：一个有用的事实，一般不妨碍使用，但值得知道。
• 注意：安装之前，值得读一读证据，弄明白它是什么意思。
• 高：很强的信号，需要格外小心。

可能出现的例子有：项目没有许可证；仓库已被归档，不再更新；安装命令会运行一个从网上下载的脚本；依赖项存在已知漏洞；或者下载链接指向 GitHub 之外的文件网站。信号本身会说明发现了什么。

在首页，“只看风险信号少的”选项只显示没有“注意”或“高”级信号的项目。资料卡上没有信号，只表示检查没有发现任何问题，并不表示这个程序没有问题。

处于警示状态的项目

当出现很强的风险信号时，项目会被标上“警示”。它仍然可见，资料卡顶部有一条提示，并列出全部证据，供你阅读后自己决定，但它会退出排行榜和推荐。在首页，只有当你在“显示”中选择“全部”时，处于警示状态的项目才会出现。

当一个项目的主要用途是绕开另一家公司的保护措施、许可证或使用条款时，资料卡会在风险信号里明确写出，并附上仓库本身的证据。

项目类型：现成的、差一点就绪的，以及其他

GitHub 上什么都有：现成的程序、给程序员用的工具、程序库，甚至链接清单。每张资料卡都会注明项目类型：

• 现成应用：日常使用的程序。就是“开箱即用”里显示的那些。
• 需要配置：能当程序用，但要多做几步安装。就是“差一点就绪”里显示的那些。
• 开发者工具、框架和内容：给程序员用的项目，或资料合集。出现在“全部”里。

费用，以及它可以替代的付费软件

费用说明使用这个程序要花多少钱：

• 免费：程序的全部功能都可以免费使用。
• 免费，API 另行收费：程序本身免费，但部分功能依赖付费服务，比如某个 AI 的密钥。
• 免费增值：有免费版本，也有功能更多的付费套餐。
• 付费：需要付费才能使用。

当一个项目做的事情和某个知名的付费软件相近时，资料卡会在“可以替代”里写出来。意思是它能解决同一类任务，并不是说它是复制品，或拥有付费软件的全部功能。付费软件的名称只是方便你认出这类任务；没有任何厂商出钱进入或退出这些对比。指南《如何把付费软件换成免费软件》介绍了如何在不丢失文件的前提下试用替换。

审核标记

每张已发布的资料卡都经过 AI 审核，带有“AI 已审核”标记。当 Radar 的负责人亲自核对资料卡时，它会得到“Radar 已核对”标记。这两个标记说明的是谁核对了文字，而不是说这个程序值得推荐。

Radar 无法验证的内容

不是所有事情都能只靠 GitHub 上公布的内容来确认。如果有某件事没能确认，比如安装包能不能在某个特定版本的系统上运行，资料卡会在“Radar 无法验证的内容”一节里说明。做决定之前请读一读这一节：它显示了这张资料卡的局限。

GitHub 数据

资料卡还显示项目的公开数据，每天更新：

• 星标：在 GitHub 上收藏这个项目的人数，历史记录见“星标变化”。
• 增长：最近几天获得了多少星标。
• 下载量：GitHub 上已发布版本的文件被下载了多少次。通过应用商店或项目自己的网站分发的项目，显示的下载量会比实际少。
• 最近更新：代码上一次改动的时间。长期没有更新的项目，可能无法在新版本的系统上运行。

“热门”里的排行榜就来自这些数字：“增长最快”、“本周下载最多”和“Radar 新收录”。

资料卡不是什么

资料卡是帮你做决定的参考，不是保证，也不是要你安装的指令。它把数据和证据所显示的内容汇总成容易读的形式，但决定永远在你。没有人付费出现在 Radar 上，排行榜里也不存在买来的位置。

发现数据有误？每张资料卡末尾都有“这张资料卡有误？申请更正”的链接，它会带你到更正申请页面。想进一步了解运营这个网站的人，请看关于 Radar页面。