如何贡献

感谢你为 Spring Ai Alibaba 贡献！

Spring Ai Alibaba 从开源建设以来，受到了很多社区同学的关注。社区的每一个 Issue ，每一个 PR，都是对整个项目的帮助，都在为建设更好用的 Spring Ai 添砖加瓦。

我们真心地感谢为这个项目提出过 Issue 和 PR 的开发者。我们希望有更多社区的开发者加入进来，一起把项目做好。

在贡献代码之前，请您稍微花一些时间了解为 Spring Ai Alibaba 贡献代码的流程。

我们随时都欢迎任何贡献，无论是简单的错别字修正，BUG 修复还是增加新功能。请踊跃提出问题或发起 PR。我们同样重视文档以及与其它开源项目的整合，欢迎在这方面做出贡献。

如果是一个比较复杂的修改，建议先在 Issue 中添加一个 Feature 标识，并简单描述一下设计和修改点。

如果您是初次贡献，可以先从 good first issue 和 help wanted 中认领一个比较简单的任务。

点击本项目右上角的 Fork 图标将 alibaba/spring-ai-alibaba fork 到自己的空间。
将自己账号下的 spring-ai-alibaba 仓库 clone 到本地，例如我的账号的 chickenlj，那就是执行 git clone https://github.com/chickenlj/spring-ai-alibaba.git 进行 clone 操作。

在自己的机器执行 git config --list ，查看 git 的全局用户名和邮箱。
检查显示的 user.name 和 user.email 是不是与自己 github 的用户名和邮箱相匹配。
如果公司内部有自己的 gitlab 或者使用了其他商业化的 gitlab，则可能会出现不匹配的情况。这时候，你需要为 spring-ai-alibaba 项目单独设置用户名和邮箱。
设置用户名和邮箱的方式请参考 github 官方文档，设置用户名，设置邮箱。

fork 出来的代码后，原仓库 main 分支可能出现了新的提交，这时候为了避免提交的 PR 和 Master 中的提交出现冲突，需要及时 merge main 分支。

在你本机的 spring-ai-alibaba 目录下，执行 git remote add upstream https://github.com/alibaba/spring-ai-alibaba 将原始仓库地址添加到 remote stream 中。
在你本机的 spring-ai-alibaba 目录下，执行 git fetch upstream 将 remote stream fetch 到本地。
在你本机的 spring-ai-alibaba 目录下，执行 git checkout master 切换到 master 分支。
在你本机的 spring-ai-alibaba 目录下，执行 git rebase upstream/master rebase 最新代码。

Spring Ai Alibaba 作为 Spring Ai 的实现之一，在代码规范方面直接沿用了 Spring Ai 项目规范，在正式开始之前请参考相关代码格式规范说明，提交代码前需要先配置好代码格式规范。

开发自己的功能，开发完毕后建议使用 mvn clean package 命令确保能修改后的代码能在本地编译通过。执行该命令的同时还能以 spring 的方式自动格式化代码。然后再提交代码，提交代码之前请注意创建一个新的有关本特性的分支，用该分支进行代码提交。

同样，提交 PR 前，需要 rebase main 分支的代码（如果您的目标分支不是 main 分支，则需要 rebase 对应目标分支），具体操作步骤请参考之前的章节。
如果出现冲突，需要先解决冲突。

提交 PR，根据 Pull request template 写明修改点和实现的功能，等待 code review 和合并，成为 Spring Ai Alibaba Contributor，为更好用的 Spring Ai Alibaba 做出贡献。