CANN算子平台贡献指南-洪萨配资

了解行为准则

【免费下载链接】ascend-boost-comm算子公共平台，南向对接不同组织开发的算子库，北向支撑不同加速库应用，实现M x N算子能力复用项目地址: https://gitcode.com/cann/ascend-boost-comm

Ascend Boost Comm属于CANN开放项目，在参与贡献前，请了解CANN开放项目行为准则，后续您在Ascend Boost Comm项目的活动（包括但不限于发表评论、提交Issue、发表wiki等）都请遵循此行为准则。

签署CLA

在参与项目贡献前，您需要签署CANN开放项目贡献者许可协议（CLA）。

请根据您的参与身份，选择签署法人CLA、法人贡献者CLA、个人CLA 或企业管理员CLA，请点击这里签署。

法人CLA：以企业身份参与贡献，代表企业签署CLA，一般由企业管理人员进行签署。
法人贡献者CLA：如果您属于签署了法人CAL的企业员工，请申请签署法人贡献者CLA，在申请页面选择您所属的企业，申请后将由企业管理员进行审批，审批完成即可参与贡献。
个人CLA：以非企业员工的个人身份参与贡献，请签署个人CLA。
企业管理员：以企业管理员的身份参与贡献，请签署企业管理员CLA，企业管理员有权对签署法人贡献者CLA的申请进行审批和人员管理。

参与贡献

在签署了CLA协议之后，就可以开始您的贡献之旅啦！贡献的方式有很多种，每一种贡献都将受到欢迎和重视。

所有您发现的问题或想贡献的新想法都可以通过Issue进行反馈、讨论和跟踪，并在后续贡献编码 PR 合入后关闭关联Issue。

📝提示
关于Gitcode工作流的详细操作可参见Gitcode工作流说明。
当您在提交PR过程中遇到问题，常见问题的解决方法可参见FAQs。

贡献分类

代码bug修复
如果您在本仓库中发现了某些Bug，并想对其进行修复，欢迎您在仓库中新建Issue进行反馈和跟踪处理。
您可以按照下方提交Issue/处理Issue任务指引新建Bug-Report|缺陷反馈类Issue对Bug进行描述，然后在评论框中输入“/assign”或“/assign @yourself”将该Issue分配给您进行处理。
文档纠错
如果您在仓库中发现某些算子文档描述错误，欢迎您在仓库中新建Issue进行反馈和修复。
您可以按照下方提交Issue/处理Issue任务指引新建Documentation|文档反馈类Issue指出对应文档中的问题，然后在评论框中输入“/assign”或“/assign @yourself”将该Issue分配给您纠正对应文档描述。
帮助解决他人Issue
如果社区中他人遇到的问题您有合适的解决方法，欢迎您在Issue中发表评论交流，帮助他人解决问题和痛点，共同优化易用性。
如果对应Issue需要进行代码修改，您可以在Issue评论框中输入“/assign”或“/assign @yourself”将该Issue分配给您，跟踪协助解决问题。

提交Issue/处理Issue任务

找到Issue列表：
在Ascend Boost Comm项目Gitcode主页内，点击“Issues”，即可找到 Issue 列表。
提交Issue
如果您准备向社区上报Bug或者提交需求，或者为社区贡献自己的意见或建议，请提交Issue。
提交Issue请参考 Issue 提交指南。
参与Issue讨论
每个Issue下面都支持开发者们交流讨论，如果您感兴趣，可以在评论区中发表自己的意见。
找到愿意处理的Issue
如果您愿意处理其中的一个 Issue，可以将它分配给自己。只需要在评论框内输入“/assign”或 “/assign @yourself”，机器人就会将问题分配给您，您的名字将显示在负责人列表里。

贡献编码

准备CANN开发环境
如果您想参与编码贡献，需要准备CANN开发环境，请参考环境准备。

了解Ascend Boost Comm的开发注意事项

1）请参考工具版本要求与安装，了解编码贡献的一些环境和工具要求。

2）Ascend Boost Comm软件编码遵循许可协议：CANN Open Software License Agreement Version 2.0，详细的协议说明请参见LICENSE文件，如果您贡献代码到Ascend Boost Comm源码仓，请遵循此协议。

请在新建的cpp、cc、h等源码文件头部增加如下声明：

/** * Copyright (c) [Name of the copyright owner]. 2025. All rights reserved. * This program is free software, you can redistribute it and/or modify it under the terms and conditions of * CANN Open Software License Agreement Version 2.0 (the "License"). * Please refer to the License for details. You may not use this file except in compliance with the License. * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. * See LICENSE in the root of the software repository for the full text of the License. */

请在新建的py、sh等文件头部增加如下声明：

# Copyright (c) [Name of the copyright owner]. 2025. All rights reserved. # This program is free software, you can redistribute it and/or modify it under the terms and conditions of # CANN Open Software License Agreement Version 2.0 (the "License"). # Please refer to the License for details. You may not use this file except in compliance with the License. # THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, # INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. # See LICENSE in the root of the software repository for the full text of the License. # ================================================================================================================

如果您仅代表个人贡献，并且您个人拥有贡献内容的版权，请将第一行中的[Name of the copyright owner]替换为您的署名。
如果您代表您的雇主贡献，或者您的雇主拥有您贡献内容的版权，请将第一行中的[Name of the copyright owner]替换为您的雇主的名称。
如果您对于贡献内容的版权归属存在任何疑问，请您咨询法律顾问或您雇主的法律团队。
第一行中2025为您创建或修改该文件的年份，请根据实际时间修改。

代码下载与贡献流程
(1) 进行代码开发前，请先将需要Ascend Boost Comm仓库fork到个人仓，然后将个人仓下载到本地。并在本地分支进行代码修改、构建与验证。
(2) 代码验证满足贡献要求后，提交Pull-Request，将代码贡献到Ascend Boost Comm，在Pull-Request列表，可以找到提交的Pull-Request。
(3) 在提交的Pull-Request的评论区，评论compile触发编译。
(4) 请注意查看门禁测试结果，若未通过，请根据问题提示进行本地代码修改；若通过，此PR会被分配给commiter检视，请关注commiter的检视意见。
(5) 当您的PR检视通过后，代码会合入Ascend Boost Comm源码仓。