Selenium 项目对 AI 辅助代码贡献有哪些要求【免费下载链接】seleniumA browser automation framework and ecosystem.项目地址: https://gitcode.com/GitHub_Trending/se/seleniumSelenium 官方明确允许贡献者使用 AI 工具Copilot、LLM、代码生成器等辅助编写代码、测试和文档但 CONTRIBUTING.md 中的 AI-assisted contributions (Copilot, LLMs, code generators) 一节为这类贡献划定了硬性边界AI 只能作为辅助人类贡献者始终是第一作者并且必须对 AI 产出负责。这篇整理针对打算用 AI 工具给 Selenium 仓库提交 PR 的开发者列出政策原文的五条要求以及提交前需要在本地完成的格式检查与测试步骤。政策参考了 LLVM 项目的 AI 工具使用政策CONTRIBUTING.md 原文注明了这一点以下要求逐条来自该文档不附加项目未说明的额外规定。五条硬性要求1. Human-in-the-loop人类必须在环你是作者。在请求评审之前必须通读、审查并理解所有 AI 辅助产出的内容。必须能够在不回看工具的情况下解释这次变更做了什么、为什么这么做。2. Disclosure披露如果 PR 中有实质性部分是 AI 辅助生成的需要在 PR 描述中披露写清楚工具名称和生成了什么内容。披露的目的是给评审者提供上下文而不是用于评判。3. No autonomous agents禁止自主代理不允许使用 agent/bot 在未经人类直接批准并拥有结果所有权的情况下开 PR、推提交或发评审评论。不要在 commit 中给 AI 工具添加Co-Authored-By标签。CONTRIBUTING.md 原文明确AI 工具不是作者披露应写在 PR 描述里而不是 commit 元数据中。4. 质量门槛不因 AI 而降低Bug 修复和功能改动在可行时必须附带测试。如果 PR 看起来像低成本的生成内容维护者有权要求缩小范围、补测试或说明价值。5. 版权与许可贡献者本人负责确认自己有权按项目许可条款贡献自己的成果。使用 AI 工具并不免除第三方版权被认定违规的内容会被移除。提交前的本地验证步骤政策要求 AI 辅助不能降低质量门槛所以提交前需要在本地把测试和格式检查跑过。Selenium 是 Bazel 构建的 monorepoAGENTS.md 强调工具链是 hermetic 的 Bazel 工具集不要假设语言专属的本地开发环境已经配置好优先使用定向的 Bazel 命令。以 Python 绑定为例CONTRIBUTING.md Running tests locally 给出的命令推荐先跑单元测试再跑浏览器测试# 单元测试 % bazel test //py:unit # 远程测试 % bazel test --jobs 1 //py:test-remote # 浏览器测试browsername 替换为 chrome、firefox 等 % bazel test //py:test-browsernameJavaScript 绑定对应% bazel test //javascript/selenium-webdriver:allJava 绑定的常用命令# Small Tests % bazel test --cache_test_resultsno --test_size_filterssmall grid java/test/... # Browser Tests排除 browser-test 标签 % bazel test --test_size_filterssmall,medium --cache_test_resultsno --test_tag_filters-browser-test //java/...如果改动触碰了用户可见行为AGENTS.md 建议做跨绑定一致性检查例如rg term java/ py/ rb/ dotnet/ javascript/selenium-webdriver/推送之前运行格式检查脚本避免 CI 上的格式化失败# 只检查已提交且相对 trunk 有变更的内容适合 push 前运行 ./scripts/format.sh --pre-pushAGENTS.md 说明如果 pre-commit 或 pre-push git hook 中已经引用了./scripts/format.sh交给 hook 处理即可不要重复跑如果没有配置 hook就在 push 前运行或建议运行./scripts/format.sh --pre-push。提交时怎么体现这些要求PR 描述中写明 AI 参与情况用了哪个工具、哪些部分是它生成的。这是唯一被要求的位置。commit message 遵循 CONTRIBUTING.md 的规范首行约 50 字符内简述变更第二行留空正文按 72 列换行如修复了 issue 则写明Fixes #N。commit 中不出现Co-Authored-ByAI 标签。代码改动附带测试并参考仓库内已有测试的结构来组织。涉及 WebDriver/BiDi 语义、capability 解析、MODULE.bazel依赖、Grid 路由等高风险区域时AGENTS.md 要求改动后明确指出触碰了哪些高风险点以及跨绑定影响.github/pr_review.md 也把这些区域列为评审重点改动这类内容时预期会有更严格的人工审查。评审阶段会发生什么PR 提交后评审以人类 committer 为准。CONTRIBUTING.md 说明评审通常几天内完成有评论需要处理时在新 commit建议用 fixup中修改并 push 到同一分支。代码评审完成后由 committer 将 PR 集成到 trunk因为要保持线性历史通常会 squash 并 rebase 你的分支历史。评审中的标签含义如needs code changes、needs rebase、awaiting merge见 CONTRIBUTING.md 的 Stages of an Issue or PR 一节。对于用 AI 辅助生成的内容现实的风险点在政策里已经写明维护者如果判断 PR 是低努力生成内容可以要求缩小范围、补测试或证明价值AI 产出如果包含侵犯第三方版权的内容会被移除。因此通读并理解 AI 的每一行输出和能独立解释变更这两条不是形式要求而是后续评审中会被检验的实际能力。【免费下载链接】seleniumA browser automation framework and ecosystem.项目地址: https://gitcode.com/GitHub_Trending/se/selenium创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
