Skip to main content
Version: DEV

贡献指南

RAGFlow 社区贡献者的一般指南。

本文档提供了向 RAGFlow 提交贡献的指南和主要考虑事项。

  • 要报告错误，请向我们提交 GitHub issue。
  • 如有其他问题，您可以在 Discussions 中探索现有讨论或发起新讨论。

您可以贡献什么​

以下列表提到了一些您可以做的贡献，但这不是一个完整的列表。

  • 提议或实现新功能
  • 修复错误
  • 添加测试用例或演示
  • 发布博客或教程
  • 更新现有文档、代码或注释
  • 建议更用户友好的错误代码

提交拉取请求（PR）​

一般工作流程​

  1. Fork 我们的 GitHub 仓库。
  2. 将您的 fork 克隆到本地机器： git clone git@github.com:<yourname>/ragflow.git
  3. 创建本地分支： git checkout -b my-branch
  4. 在提交消息中提供充分的信息 git commit -m '在提交消息中提供充分的信息'
  5. 将更改提交到您的本地分支，并推送到 GitHub：（包含必要的提交消息） git push origin my-branch.
  6. 提交拉取请求以供审查。

提交 PR 之前​

  • 考虑将大型 PR 拆分为多个较小的独立 PR，以保持可追溯的开发历史。
  • 确保您的 PR 只解决一个问题，或将任何不相关的更改保持在较小范围内。
  • 在贡献新功能时添加测试用例。它们证明您的代码功能正确，并防止未来更改可能带来的潜在问题。

描述您的 PR​

  • 确保您的 PR 标题简洁明了，提供所有必需的信息。
  • 如果适用，在您的 PR 描述中引用相应的 GitHub issue。
  • 在您的描述中包含破坏性更改或API 更改的充分设计细节。

审查和合并 PR​

确保您的 PR 在合并之前通过所有持续集成（CI）测试。