贡献指南

无论贡献大小，我们都欢迎！这里我们总结了一些关于如何参与 Rolldown 项目的通用指南。

开发开放

所有开发都直接在 GitHub 上进行。核心团队成员和外部贡献者（通过 fork）都会提交 pull request，并经过相同的审核流程。

除了 GitHub 之外，我们还使用一个 Discord 服务器进行实时讨论。

在使用 AI 工具（包括 ChatGPT、Claude、Copilot 等 LLM）为 Rolldown 贡献时：

请披露 AI 的使用，以减少维护者负担
请先开启一个 issue 进行讨论，然后再提交 pull request
你要对你提交的所有 AI 生成 issue 或 PR 负责
低质量或未经审核的 AI 内容会被立即关闭
重复提交低质量（“slop”）PR 的贡献者将被直接封禁，恕不另行通知。 如果你承诺按照此政策为 Rolldown 贡献，封禁可能会被解除。你可以通过我们的 Discord 申请解封。

我们鼓励使用 AI 工具协助开发，但所有贡献在提交前都必须经过贡献者的充分审查和测试。AI 生成的代码应被理解、验证并调整，以满足 Rolldown 的标准。

请仅在你已经搜索过该问题且未找到结果后，再向 GitHub 报告 bug。请务必尽可能详细地描述，并包含所有适用的标签。

修复 bug 的最佳方式是提供一个精简的测试用例。请提供一个包含可运行示例的公共仓库，或一段可用的代码片段。未来，我们还会提供一个可在浏览器中运行的 REPL，以便更容易复现问题。

在请求新功能之前，请先查看未关闭的问题，因为你要请求的内容可能已经存在。如果不存在，请提交一个标题前缀为 [request] 的 issue。请务必尽可能详细地描述，并包含所有适用的标签。

我们接受针对所有 bug、修复、改进和新功能的 pull request。对于任何超出简单修复范围的内容，请先开启一个 issue 进行讨论。在提交 pull request 之前，请确保你已使用上述开发工作流在本地通过构建。

关于项目开发环境的搭建，请参见项目设置。

INFO

在提交 pull request 之前，请先阅读礼仪章节。

请直接向 main 分支提交所有 pull request。我们只为即将发布的版本 / 破坏性变更使用单独的分支，否则所有内容都指向 main。

进入 main 的代码必须与最新稳定版兼容。它可以包含额外功能，但不能有破坏性变更。我们应该能够随时从 main 的最新提交发布一个新的小版本。