GitHub Pull Request 里的 AI 安全检测怎么验收：CodeQL 之外的覆盖范围与计费边界

团队哪怕把 Pull Request 合并前的检查链路搭得再完善，仍可能在 CodeQL 没有覆盖的语言或框架里留下盲区。GitHub 现在把 AI 安全检测结果直接嵌入到 Pull Request 流程中，适合拿来做多一层风险提醒，不过这套能力目前还处于公开预览阶段，不能直接当成自动拦截门禁使用。

这项能力解决的是哪一块缺口

GitHub 官方更新日志对这项能力的定位很明确：AI 检测会补充 CodeQL 内建分析尚未覆盖的语言和框架场景。它不是把现有 CodeQL 查询引擎替换成另一套，也不会给每条扫出来的发现直接判定成“必然存在漏洞”。

这个定位差异非常关键。CodeQL 更适合稳定、可完全解释的规则类分析；AI 检测更像 Pull Request 评审阶段的第二双校验眼睛，帮团队先挖出过去没有原生扫描覆盖的可疑代码路径。工程侧验收的核心标准，应该是“有没有多找到一些值得人工复核的问题”，而不是“能不能自动挡住所有潜在问题”。

先把四个前置条件对齐

第一次配置的时候，很多人容易犯的错是只在仓库页面找开关。官方公开说明给出的启用链路有四层，缺任意一层，Pull Request 里都可能看不到对应的 AI 检测结果。

这里的依赖关系也解释了一个很多人觉得奇怪的现象：AI 检测本身不是由 CodeQL 执行，但官方说明它仍要依赖 CodeQL 默认设置才能正常工作。所以仓库只开通了代码安全套餐、没完成默认分析配置，不能直接判定是 AI 能力本身出了故障。

用一条测试 Pull Request 验收结果

配置完成之后，不要直接拿生产仓库的大体积 PR 来判断功能是否正常。先准备一个改动范围小、支持快速回滚的测试分支，提交一段团队已知存在边界风险的代码，先把整个检查链路跑通验证。

1. 新建一个测试用的 Pull Request，确认 GitHub Actions 和 CodeQL 默认分析可以正常触发启动。
2. 等待代码扫描结果返回，查看是否有单独标注 AI 来源的发现项，同步记录它对应的文件位置、行号和风险说明。
3. 把 AI 产出的发现和 CodeQL 产出的发现分开登记，人工核验这些问题是否能复现风险，或者至少值得补充后续测试。
4. 关闭或者修正测试分支，确认团队现有的审查模板不会把这类提示性发现误设为合并阻断条件。

官方说明里提到 AI 结果会随着分析进程逐步返回，不需要等所有分析源全部跑完。对日常值班流程来说，这意味着安全相关的评论可能先到、后续还会补充新内容；机器人评论的首次出现时间不能直接当成整个扫描任务的结束时间。

基线指标应该看什么

这类新功能信息落到团队实际落地环节，最怕最后只剩一句“又多了个 AI 相关功能”的空泛结论。更有实用价值的做法是给试运行阶段设三个可落地的基线：

• 覆盖基线：梳理出当前 CodeQL 不覆盖的语言、框架或者存储路径，记录 AI 检测能不能针对这些场景给出新的风险线索。
• 复核基线：抽查 AI 标记出的文件和行号，按真实问题、误报、无法判断三类分别统计数量。
• 流程基线：统计从 AI 评论发出到人工介入处理的耗时，确认这类提示不会被淹没在普通代码评论里没人跟进。

不建议把告警总数当成唯一考核目标。AI 检测在公开预览阶段产出的结果属于提示性质，不会阻止 Pull Request 合并；团队仍然需要把核验过的高风险问题转成自定义审查规则、测试用例或者强制人工确认项。

公开预览的边界：能用，但别误读

当前能力的产品定位决定了它更适合小范围灰度试用。第一，它要求 GitHub Code Security 和 CodeQL 默认配置两项基础能力前置；第二，企业管理员、组织管理员和仓库维护者对应的操作权限和职责边界各不相同；第三，AI 产出的结果不会自动成为合并门禁。

成本侧也需要单独登记清楚。GitHub 公开说明里明确标注，预览期间需要绑定 GitHub Copilot 许可，检测任务实际运行时会消耗组织名下的 AI credits 额度。启用前先和组织的额度负责人确认试点仓库范围、运行频率和预算记录，别把“不会阻断合并”误判成“没有资源消耗”。

常见问题

AI 安全检测会替代 CodeQL 吗？

不会。它的作用是扩展原有安全扫描的覆盖范围，CodeQL 默认分析反而是它的启用前置条件之一，两类产出的结果需要分开理解、分开复核。

AI 发现会自动阻止 Pull Request 合并吗？

不会。公开预览说明把它定义为 informational 类发现，团队如果需要加合并阻断规则，仍要自行搭建对应的门禁和人工确认流程。

为什么开了 GitHub Code Security 仍看不到 AI 检测结果？

先逐层检查企业策略是否允许、组织层面是否启用，以及仓库是否完成了 CodeQL default setup 配置；四层条件缺任意一层都无法正常触发。

预览阶段运行 AI 检测会消耗 AI credits 吗？

会。GitHub 说明检测任务运行时会消耗组织名下的 AI credits，同时要求账号持有对应 GitHub Copilot 许可，试点启动前应当提前核对组织的额度使用规则。

这项更新真正值得关注的点，不是“AI”这个噱头，而是它把原本可能停留在传统工具盲区里的风险线索，直接放到了大家日常用的 Pull Request 工作流里。先用小范围测试分支验证覆盖能力、复核效率和处理耗时，再决定要不要推广到更多仓库，更容易把预览阶段的新能力变成可控的安全补充项。