用 Rust 打造 PR 守门员analysis-tools.dev 贡献审查机器人完整实现解析【免费下载链接】static-analysis⚙️ A curated list of static analysis (SAST) tools and linters for all programming languages, config files, build tools, and more. The focus is on tools which improve code quality.项目地址: https://gitcode.com/gh_mirrors/st/static-analysis静态分析工具目录站 analysis-tools.dev 靠一个用 Rust 编写的 PR 审查机器人自动把关每一条社区贡献。它读取data/tools/下的 YAML 工具条目调用 GitHub API 核验星标数、人类贡献者与项目年龄不合格就自动关闭 PR无法核验的则转人工审查。本文将带你完整看懂这套审查机器人的实现。项目背景一个收录千余种静态分析工具的目录该项目static-analysis收录了覆盖各编程语言、配置文件和构建工具的 SAST静态应用安全测试工具与 Linter是静态分析工具领域的权威黄页。每个工具在 data/tools/ 目录中对应一个 YAML 文件例如 black.ymlname工具名称source源码仓库地址tags语言与类别标签description不超过 500 字符的简介为了让目录保持高质量CONTRIBUTING.md 规定每个被收录的工具必须同时满足三条门槛准入条件阈值GitHub 星标数≥ 20 stars人类贡献者≥ 2 人项目历史≥ 6 个月整体架构一个 Cargo 工作区两个核心组件所有自动化逻辑集中在 ci/ 目录下由 ci/Cargo.toml 定义的工作区管理包含两个 cratepr-checkci/pr-check/PR 守门员本文主角renderci/render/目录渲染器把 YAML 数据渲染成主 README 和 JSON API依赖极简全部来自工作区统一声明tokio异步运行时、reqwestHTTP 客户端、serde-saphyrYAML 解析、askama模板渲染、chrono日期计算。这套组合足以支撑一个健壮的 CI 机器人。守门员工作流程从 YAML 到审查报告入口在 ci/pr-check/src/main.rs整个流程可以概括为五步第一步接收待审文件CI 触发时把 PR 新增或修改的 YAML 路径作为命令行参数传入。机器人只接受data/tools下、扩展名为yml或yaml的路径main.rs#L487-L499其余参数一律忽略——这是一种防御性设计。第二步解析工具条目read_tool 函数用serde-saphyr把 YAML 反序列化为ToolEntry结构只提取检查所需的三个字段name、source、homepage不关心完整 schema。第三步调用 GitHub API 核验三项指标check_tool 函数是核心逻辑。对带 GitHub 源码地址的工具星标检查GET /repos/{owner}/{repo}获取stargazers_count与常量MIN_STARS 20比较年龄检查用chrono的月份算术计算创建时间 6 个月是否早于当前时间不合格时还会贴心地算出还差几天贡献者检查GET /repos/{owner}/{repo}/contributors?per_page100拉取贡献者列表这里有个值得学习的细节——如何区分人类贡献者。counts_as_human 方法排除三类账号非User类型账号、以[bot]结尾的登录名、以及一张精确的自动化账号名单claude、dependabot、renovate-bot。注释特别说明之所以用精确名单而非宽泛正则是为了避免误伤名为claude-smith的真实人类见 单元测试。第四步无源码地址时的 RDAP 域名年龄检查商业闭源工具往往没有 GitHub 仓库。此时机器人退而求其次从homepage提取域名homepage_domain 函数注意它刻意不回退到父域防止把托管商域名算成服务年龄再通过 RDAP 协议查询域名注册日期fetch_domain_registration 函数。设计上非常克制RDAP 专用一个不带 GitHub Token 的独立 HTTP 客户端且域名年龄永远只作为需人工审查的证据不会触发自动关闭——因为域名注册时间不等于服务上线时间。第五步渲染报告并决定退出码三项检查的结果被封装为Pass/Fail/Skip三态CheckResult 枚举最终由 askama 模板 渲染成 Markdown 评论其中包含一个隐藏标记!-- pr-check-bot --供 CI 识别与更新自己的评论。退出码语义清晰直接驱动 CI 行为退出码含义CI 动作0全部通过正常结束1存在无法自动核验的项转人工审查2确认不达标自动关闭 PR三种审查结果PASS、REVIEW、FAILToolReport::status 方法实现了证据不足不判死刑的审查哲学FAIL有确认失败的硬性指标如星标不足 20→ 自动关闭REVIEW检查无法完成仓库 404、API 故障、RDAP 无数据→ 保留 PR 等待人工PASS全部指标达标即使某一项检查失败、另一项无法核验只要失败是已证实的机器人依然会关闭 PRverified_failure_still_closes 测试 覆盖了该边界。工程质量一位 Rust 工程师的自律这个不到 600 行的 CLI 工具在工程细节上相当讲究零 panicCargo.toml 中 clippy 配置将unwrap_used和panic直接设为deny文档齐全missing_errors_doc要求所有返回Result的函数写# Errors注释测试充分测试模块 覆盖了机器人 URL 解析、人类/机器人账号区分、6 个月日历月边界、域名提取等 20 余个场景甚至验证了仓库全部通过时评论绝不含关闭字样友好提示报告里每个 FAIL 都附带具体数字例如created 90 days ago, needs 92 more days to meet the 6-month minimum渲染器 render守门员的另一半ci/render/src/lib.rs 负责把 YAML 数据源变成网站可见内容几个关键能力入口校验lints.rs 检查名称长度≤50 字符和至少一个标签目录分组create_catalog 函数 把多语言工具单独归组避免在每个语言区重复出现弃用检测check_deprecated 函数 定期拉取每个 GitHub 仓库的最新提交超过 365 天无更新即标记为 deprecated渲染时折叠到 Show Deprecated 折叠块中API 输出create_api 函数 生成 data/api/ 下的 JSON供站点检索使用日常开发可用 Makefile 中的便捷目标make test跑全部测试make clippy执行严格 lintmake render本地预演渲染效果CONTRIBUTING.md 建议提交前执行一次。写在最后一个 CI 机器人的设计启示这套 Rust 实现的 PR 审查机器人给出了几个可复用的模式状态三分法Pass/Fail/Skip三态比简单的布尔值更能表达证据不足的场景避免误杀社区贡献只读原则机器人只读取元数据并输出报告关闭 PR这类破坏性动作交给工作流按退出码执行职责单一精确优于宽泛排除自动化账号用精确名单而非正则模糊匹配宁可漏排也不误伤退出码即协议0/1/2 三种退出码把通过/人工/关闭的决策逻辑压缩进一个整数工作流配置因此极简单下次看到目录站的 PR 被礼貌地自动关闭时你可以知道背后是一位约 600 行代码、零 panic 的 Rust 守门员在值夜班。【免费下载链接】static-analysis⚙️ A curated list of static analysis (SAST) tools and linters for all programming languages, config files, build tools, and more. The focus is on tools which improve code quality.项目地址: https://gitcode.com/gh_mirrors/st/static-analysis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
用 Rust 打造 PR 守门员：analysis-tools.dev 贡献审查机器人完整实现解析
用 Rust 打造 PR 守门员analysis-tools.dev 贡献审查机器人完整实现解析【免费下载链接】static-analysis⚙️ A curated list of static analysis (SAST) tools and linters for all programming languages, config files, build tools, and more. The focus is on tools which improve code quality.项目地址: https://gitcode.com/gh_mirrors/st/static-analysis静态分析工具目录站 analysis-tools.dev 靠一个用 Rust 编写的 PR 审查机器人自动把关每一条社区贡献。它读取data/tools/下的 YAML 工具条目调用 GitHub API 核验星标数、人类贡献者与项目年龄不合格就自动关闭 PR无法核验的则转人工审查。本文将带你完整看懂这套审查机器人的实现。项目背景一个收录千余种静态分析工具的目录该项目static-analysis收录了覆盖各编程语言、配置文件和构建工具的 SAST静态应用安全测试工具与 Linter是静态分析工具领域的权威黄页。每个工具在 data/tools/ 目录中对应一个 YAML 文件例如 black.ymlname工具名称source源码仓库地址tags语言与类别标签description不超过 500 字符的简介为了让目录保持高质量CONTRIBUTING.md 规定每个被收录的工具必须同时满足三条门槛准入条件阈值GitHub 星标数≥ 20 stars人类贡献者≥ 2 人项目历史≥ 6 个月整体架构一个 Cargo 工作区两个核心组件所有自动化逻辑集中在 ci/ 目录下由 ci/Cargo.toml 定义的工作区管理包含两个 cratepr-checkci/pr-check/PR 守门员本文主角renderci/render/目录渲染器把 YAML 数据渲染成主 README 和 JSON API依赖极简全部来自工作区统一声明tokio异步运行时、reqwestHTTP 客户端、serde-saphyrYAML 解析、askama模板渲染、chrono日期计算。这套组合足以支撑一个健壮的 CI 机器人。守门员工作流程从 YAML 到审查报告入口在 ci/pr-check/src/main.rs整个流程可以概括为五步第一步接收待审文件CI 触发时把 PR 新增或修改的 YAML 路径作为命令行参数传入。机器人只接受data/tools下、扩展名为yml或yaml的路径main.rs#L487-L499其余参数一律忽略——这是一种防御性设计。第二步解析工具条目read_tool 函数用serde-saphyr把 YAML 反序列化为ToolEntry结构只提取检查所需的三个字段name、source、homepage不关心完整 schema。第三步调用 GitHub API 核验三项指标check_tool 函数是核心逻辑。对带 GitHub 源码地址的工具星标检查GET /repos/{owner}/{repo}获取stargazers_count与常量MIN_STARS 20比较年龄检查用chrono的月份算术计算创建时间 6 个月是否早于当前时间不合格时还会贴心地算出还差几天贡献者检查GET /repos/{owner}/{repo}/contributors?per_page100拉取贡献者列表这里有个值得学习的细节——如何区分人类贡献者。counts_as_human 方法排除三类账号非User类型账号、以[bot]结尾的登录名、以及一张精确的自动化账号名单claude、dependabot、renovate-bot。注释特别说明之所以用精确名单而非宽泛正则是为了避免误伤名为claude-smith的真实人类见 单元测试。第四步无源码地址时的 RDAP 域名年龄检查商业闭源工具往往没有 GitHub 仓库。此时机器人退而求其次从homepage提取域名homepage_domain 函数注意它刻意不回退到父域防止把托管商域名算成服务年龄再通过 RDAP 协议查询域名注册日期fetch_domain_registration 函数。设计上非常克制RDAP 专用一个不带 GitHub Token 的独立 HTTP 客户端且域名年龄永远只作为需人工审查的证据不会触发自动关闭——因为域名注册时间不等于服务上线时间。第五步渲染报告并决定退出码三项检查的结果被封装为Pass/Fail/Skip三态CheckResult 枚举最终由 askama 模板 渲染成 Markdown 评论其中包含一个隐藏标记!-- pr-check-bot --供 CI 识别与更新自己的评论。退出码语义清晰直接驱动 CI 行为退出码含义CI 动作0全部通过正常结束1存在无法自动核验的项转人工审查2确认不达标自动关闭 PR三种审查结果PASS、REVIEW、FAILToolReport::status 方法实现了证据不足不判死刑的审查哲学FAIL有确认失败的硬性指标如星标不足 20→ 自动关闭REVIEW检查无法完成仓库 404、API 故障、RDAP 无数据→ 保留 PR 等待人工PASS全部指标达标即使某一项检查失败、另一项无法核验只要失败是已证实的机器人依然会关闭 PRverified_failure_still_closes 测试 覆盖了该边界。工程质量一位 Rust 工程师的自律这个不到 600 行的 CLI 工具在工程细节上相当讲究零 panicCargo.toml 中 clippy 配置将unwrap_used和panic直接设为deny文档齐全missing_errors_doc要求所有返回Result的函数写# Errors注释测试充分测试模块 覆盖了机器人 URL 解析、人类/机器人账号区分、6 个月日历月边界、域名提取等 20 余个场景甚至验证了仓库全部通过时评论绝不含关闭字样友好提示报告里每个 FAIL 都附带具体数字例如created 90 days ago, needs 92 more days to meet the 6-month minimum渲染器 render守门员的另一半ci/render/src/lib.rs 负责把 YAML 数据源变成网站可见内容几个关键能力入口校验lints.rs 检查名称长度≤50 字符和至少一个标签目录分组create_catalog 函数 把多语言工具单独归组避免在每个语言区重复出现弃用检测check_deprecated 函数 定期拉取每个 GitHub 仓库的最新提交超过 365 天无更新即标记为 deprecated渲染时折叠到 Show Deprecated 折叠块中API 输出create_api 函数 生成 data/api/ 下的 JSON供站点检索使用日常开发可用 Makefile 中的便捷目标make test跑全部测试make clippy执行严格 lintmake render本地预演渲染效果CONTRIBUTING.md 建议提交前执行一次。写在最后一个 CI 机器人的设计启示这套 Rust 实现的 PR 审查机器人给出了几个可复用的模式状态三分法Pass/Fail/Skip三态比简单的布尔值更能表达证据不足的场景避免误杀社区贡献只读原则机器人只读取元数据并输出报告关闭 PR这类破坏性动作交给工作流按退出码执行职责单一精确优于宽泛排除自动化账号用精确名单而非正则模糊匹配宁可漏排也不误伤退出码即协议0/1/2 三种退出码把通过/人工/关闭的决策逻辑压缩进一个整数工作流配置因此极简单下次看到目录站的 PR 被礼貌地自动关闭时你可以知道背后是一位约 600 行代码、零 panic 的 Rust 守门员在值夜班。【免费下载链接】static-analysis⚙️ A curated list of static analysis (SAST) tools and linters for all programming languages, config files, build tools, and more. The focus is on tools which improve code quality.项目地址: https://gitcode.com/gh_mirrors/st/static-analysis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考