AlexanderLuzDH/busleyden-guard-live-proof
GitHub: AlexanderLuzDH/busleyden-guard-live-proof
Busleyden Guard 是一个为 GitHub pull request 提供基于证据的自动化质量门禁工具,通过映射变更差异、测试覆盖、所有者审批与扫描结果来决定是否放行合并。
Stars: 0 | Forks: 0
# Busleyden Guard 实时证明
Busleyden Guard 为每个 pull request 提供一个基于证据的答案:**在正常的人工审查后合并,或者等待确切的缺失证明**。
本仓库是公开、可复现的产品测试用例(fixture)。它不是一个模拟的控制面板。
## 查看从红到绿的结果
在 [PR #3](https://github.com/AlexanderLuzDH/busleyden-guard-live-proof/pull/3) 中,一项关于身份验证会话处理的更改具备:
- 已验证的 Git diff;
- 匹配的 CODEOWNER 和所有者批准;
- 一个映射的测试;
- 限定于已更改文件的 Semgrep 结果;以及
- 与无关的依赖项历史记录区分开的 OSV 扫描结果。
Guard 仅仅因为一个原因拦截了该更改:
- [打开拦截该请求的 GitHub Check](https://github.com/AlexanderLuzDH/busleyden-guard-live-proof/runs/86260113501)
- [查询单一拦截项证书](https://www.busleyden.com/live-auth-proof-required-certificate.json)
在添加了映射的重放测试后,下一次由 App 触发的运行实现了零拦截项:
- [打开通过的 GitHub Check](https://github.com/AlexanderLuzDH/busleyden-guard-live-proof/runs/86260496674)
- [查询零拦截项证书](https://www.busleyden.com/live-auth-evidence-satisfied-certificate.json)
这两次决策均使用了引擎 SHA-256 `9fb8b150812efa7e25cc90e974b1596ab7b5c38b99143da7d88aa92eaba071cc`。仓库所有者保留了最终的合并决定权。
## 每个 PR 的运行流程
1. GitHub App 接收 pull-request webhook。
2. 它会调度仓库专属的、版本锁定的 workflow。
3. 该 workflow 会验证确切的 base/head diff 和引擎哈希值。
4. Guard 会映射所有者、受影响的测试、风险面以及扫描器证据。
5. 最终的 GitHub Check 和内容寻址证书会记录该决策。
已安装的 workflow 位于 [`.github/workflows/change-consequence-certificate.yml`](.github/workflows/change-consequence-certificate.yml)。
## 在安装前进行试用
- [打开此证明 PR 的免安装预览](https://www.busleyden.com/?pr_url=https%3A%2F%2Fgithub.com%2FAlexanderLuzDH%2Fbusleyden-guard-live-proof%2Fpull%2F3#preview)
- [在公共仓库上免费安装](https://www.busleyden.com/#pricing)
- [为私有仓库开启 Guard Pro](https://www.busleyden.com/#pricing)
- [阅读安全边界说明](https://www.busleyden.com/security-review.json)
公共仓库免费使用。Guard Pro 的价格为每月 $19.90,适用于同一个 GitHub 账户下数量不限的指定私有仓库。无需进行任何销售沟通,并且可以通过 Stripe 管理账单,而无需联系支持人员。
## Guard 不保证的事项
Guard 仅验证可用的证据和策略条件。它不证明代码没有 bug,不取代人工审查,也不确认每个仓库都使用相同的测试和所有权约定。
## 测试用例来源
本仓库使用来自 [Pallets Click 项目](https://github.com/pallets/click) 的源代码作为真实的 Python fixture。Click 保留其原始的 BSD 许可证。Busleyden 专属的 workflow、身份验证 fixture、证书以及证明 PR 的存在仅是为了演示 Guard 的行为;本仓库并不是 Click 的另一个分发渠道。
标签:代码审查, 质量保障, 逆向工具