开源选型别只看排名：一次 README 核对记录

本文由 AI 工作站开发者根据 2026 年 10 月 25 日的实际页面核对整理，AI 辅助编辑。没有逐个安装或跑性能测试，项目归各自作者所有。

刷到一个排在前三的开源项目，你通常会先收藏、安装，还是打开 README？

今天核对 AI 开源项目雷达日榜时，我遇到了一个很具体的例子：Gemini CLI 排在第 3，但上游仓库首页已经有面向部分用户的迁移说明。排名能帮我们发现候选，却不能直接回答“我现在该不该装它”。

同样在榜单里，解决的任务可能完全不同

今天的前三项分别是 Hallmark、Claude Howto、Gemini CLI。把三者放在同一个“热门 AI 工具”标题下很容易，真正选型时却必须拆开。

Hallmark 面向编码助手的界面设计流程。它值得研究的地方是如何约束页面结构、视觉与实际操作，而不是用一个设计 Skill 代替产品验收。要做预约页面，就实际检查能否完成预约；要做表单，就检查错误提示、键盘操作和提交结果。本文没有验证它在具体项目中的实现效果。

Claude Howto 是教程与示例资源，适合已经在使用 Claude Code、想系统理解命令、hooks 与工作流的人。教程仓库的获取条件，与 Claude Code 本身的账号、服务和计费条件是两回事。不要因为教程可以下载，就推导出相关服务都免费可用。

Gemini CLI 是终端代理。今天读取的 README 在显眼位置说明：免费层和 Google One 用户应关注 Antigravity CLI 的迁移信息；对于新的 Gemini 4 Argon，也提示使用 Antigravity。这是选择安装路径前需要先读的条件，不能仅根据目录卡片里“终端 AI 代理”的一句介绍做决定。适用账号与最新说明仍请以维护方页面为准。

先写一个任务，再筛项目

我更建议先写一句能验收的话。例如：

“我想把现有后台的一页表单做清楚，并保留正常的键盘操作和错误提示。”

这时先研究界面设计流程比较合理，而不是把教程、终端代理、界面工具全部安装一遍。换成“团队已经使用 Claude Code，想把代码审查流程整理成可学习的模板”，教程项目就更接近需求。

排名属于发现入口；任务、环境与验收条件决定候选是否值得继续。

一张选型记录，只留五个问题

1. 要交付什么？ 写一个具体结果，避免只写“提高效率”。
2. 在哪里运行？ 本机、浏览器、服务器，以及是否依赖外部模型服务。
3. 需要什么条件？ 账号、硬件、模型访问、网络和预算分别列出。
4. 依据在哪里？ 保存实际阅读的 README、许可证文件、维护方说明和核对日期。
5. 还没有验证什么？ 比如没有安装、没有跑相同输入、没有确认兼容性，就直接保留未知。

许可证尤其要单独处理。目录里的 MIT、Apache 等标签只能帮助定位，采用前应阅读对应版本的许可证及依赖条件；模型权重、外部服务和素材授权还需要另外核对。没有证据时，不把“可能可以”改写成“可以放心商用”。

不想手动翻列表，也可以从 Skill 发起同样的核对

AI 开源项目雷达同时有网页和 Skill 入口。网页适合先看排行与项目卡；Skill 适合在当前工作里提出明确需求，再继续查项目事实、许可证证据或候选差异。

一个可复用的提问方式是：“我需要完成什么任务，运行环境是什么；请先给候选及来源，把已核事实、建议、未知和风险分开。”如果没有符合条件的候选，就保留没有匹配；如果许可证证据不足，就保留未知。工具返回结果不是实际安装成功，更不是性能测评。

今天这次核对中，我使用了项目事实和许可证证据查询：三个项目的许可证检查没有给出足够的直接证据，因此没有据此下商用许可结论。这比在排行榜下直接加“免费、全能、开箱即用”更能帮助后续采用。

查看 AI 开源项目雷达的排行与项目卡

日榜顺序、项目说明与维护方文档都会变化。本文记录的是 10 月 25 日读取时的差异，不是长期排名，也不承诺项目适合所有人。