CANN启航营提交规范详解：从Fork到PR的完整流程-拓冰建站

CANN启航营提交规范详解：从Fork到PR的完整流程

【免费下载链接】cann-launch-camp用户可借助此项目规范管理 CANN 开源社区启航营高校活动的课程作业、课设、毕设等实践作品，其核心功能是统一标准化目录层级与提交规范，保障作品提交规整、可追溯、可评审。项目地址: https://gitcode.com/cann/cann-launch-camp

欢迎来到CANN开源社区启航营！🎯 作为面向高校学生的AI开发实践平台，CANN启航营为同学们提供了宝贵的昇腾AI处理器开发经验。本文将为您详细解析从Fork仓库到提交PR的完整流程，帮助您顺利完成课程作业、课设或毕设的规范提交。无论您是初次接触开源社区的新手，还是有一定经验的开发者，这篇终极指南都将为您提供清晰的操作步骤和实用技巧。

📋 项目概述与核心价值

CANN启航营项目是一个专门用于管理高校活动课程作业、课设、毕设等实践作品的规范化平台。其核心功能是统一标准化目录层级与提交规范，确保所有作品提交规整、可追溯、可评审。通过这个平台，学生可以在真实的开源环境中学习昇腾AI处理器的开发技能，同时培养规范的代码提交习惯。

项目核心价值：

🏗️标准化管理：统一的目录结构和命名规范
🔍可追溯性：清晰的提交历史和评审记录
📊可评审性：规范的提交流程便于导师评审
🤝开源协作：体验真实开源社区的工作流程

🚀 前置准备：环境配置与账号设置

在开始提交之前，您需要完成以下准备工作：

1. GitCode账号注册与认证

首先需要注册GitCode账号并完成实名认证。GitCode是国内知名的开源代码托管平台，为CANN社区提供代码托管服务。

2. CLA签署（贡献者许可协议）

参与CANN社区贡献前，必须签署贡献者许可协议。这是开源社区的通行证，确保您的贡献符合开源规范。

3. Git环境配置

安装Git客户端并配置用户信息，确保与GitCode账号保持一致：

git config --global user.name "您的GitCode用户名" git config --global user.email "您的GitCode注册邮箱"

🍴 第一步：Fork项目仓库

Fork操作相当于在您的个人空间创建项目副本，这是开源贡献的标准起点：

访问主仓库：https://link.gitcode.com/i/b27fa788e3bb68e3a1a9c75fd38f8576
点击右上角的Fork按钮
选择Fork到您的个人账号空间
等待Fork完成，系统会自动跳转到您的个人仓库副本

小贴士：Fork后您将拥有独立的代码仓库，可以自由修改而不会影响主项目。

📦 第二步：克隆仓库到本地

将个人仓库克隆到本地开发环境：

git clone https://gitcode.com/您的用户名/cann-launch-camp.git cd cann-launch-camp

克隆完成后，您将在本地看到完整的项目结构。Windows用户可以直接进入文件夹，Linux/macOS用户使用终端操作。

📁 第三步：理解目录结构规范

CANN启航营采用严格的目录层级管理，确保所有提交规整有序：

cann-launch-camp/ ├── 2026/ # 年度根目录 │ └── University/ # 高校总目录 │ ├── UESTC/ # 电子科技大学 │ │ ├── First-session/ # 第一期课程 │ │ │ └── Industrial-Task/ # 产业课题目录 │ │ │ ├── README.md # 课题说明文档 │ │ │ └── 学生提交目录/ │ ├── SJTU/ # 上海交通大学 │ └── BIT/ # 北京理工大学

命名规范要点：

📅 年度目录：四位数字年份（如2026）
🏫 高校目录：官方英文大写缩写（如UESTC、SJTU）
📚 期数目录：英文连字符格式（如First-session）
🎯 产业课题目录：固定名称Industrial-Task
👤 个人目录：姓名_gitcode账号_任务名称

🛠️ 第四步：创建个人提交目录

在正确的路径下创建个人目录，这是提交作业的关键步骤：

目录创建示例：

mkdir -p 2026/University/UESTC/First-session/Industrial-Task/张三_zhangsan_gelu

目录命名规则：

格式：姓名_gitcode账号_任务名称
示例：王欣月_wwwwxxxyy_less_equal
禁止使用中文、空格、特殊字符
单词间使用下划线分隔

📝 第五步：准备提交内容

将您的作业成果复制到个人目录中，确保包含以下内容：

必需文件结构

个人提交目录/ ├── README.md # 项目说明文档 ├── src/ # 源代码目录 │ ├── CMakeLists.txt # 构建配置文件 │ ├── op_host/ # 主机侧算子实现 │ └── op_kernel/ # 设备侧核心逻辑 └── 其他必要文件/

README文档要求

📖 项目名称与课题说明
🏗️ 项目目录结构
⚙️ 运行环境要求
🚀 编译与运行步骤
✅ 精度验证说明
📊 算子功能参数

优秀示例：LessEqual昇腾Ascend C算子开发作业

🔄 第六步：提交代码到Git

首次提交流程

# 1. 查看变更状态 git status # 2. 添加个人目录下的所有文件 git add 2026/University/UESTC/First-session/Industrial-Task/张三_zhangsan_gelu/ # 3. 提交变更 git commit -m "feat(UESTC): 提交 gelu 算子课题成果" # 4. 推送到远程仓库 git push origin master

提交信息规范

格式：feat(高校缩写): 简要描述
示例：feat(SJTU): 完成less_equal算子开发
说明：feat表示功能提交，高校缩写用括号包裹

追加修改（多次提交）

如果需要修改已提交的代码，使用amend参数合并到上次提交：

# 1. 添加修改文件 git add 2026/University/UESTC/First-session/Industrial-Task/张三_zhangsan_gelu/ # 2. 追加到上次提交 git commit --amend -m "feat(UESTC): 提交 gelu 算子课题成果（补充文档）" # 3. 强制推送（修改历史需要force） git push origin master --force

⚠️ 注意事项：强制推送只修改自己的提交记录，确保不会覆盖他人代码。

🔀 第七步：创建Pull Request

PR是向主仓库贡献代码的正式方式：

创建步骤

访问您的个人仓库页面：https://gitcode.com/您的用户名/cann-launch-camp
点击Pull Request标签页
点击"+ 新建Pull Request"按钮
确认源分支（您的master分支）和目标仓库（cann/cann-launch-camp的master分支）
填写PR标题和详细描述
点击"创建"提交PR

PR描述要求

🎯标题：清晰描述提交内容
📋描述：详细说明实现功能、测试结果、注意事项
🔗关联：如有相关Issue，请关联Issue编号
✅检查清单：确认已完成所有必要步骤

📊 第八步：等待审核与响应反馈

提交PR后，CANN社区维护者将进行审核：

审核流程

自动检查：CLA签署状态、代码格式检查
人工审核：功能实现、代码质量、文档完整性
反馈意见：审核人通过PR评论提出修改建议
修改更新：在本地修改后重新提交，PR自动更新

常见审核要点

✅ CLA签署是否完成
✅ 目录结构是否符合规范
✅ 代码功能是否完整实现
✅ 文档说明是否清晰
✅ 测试结果是否准确

🚨 常见问题与解决方案

Q1：CLA校验失败怎么办？

A：请确认已在CANN社区完成CLA签署。签署指南见官方文档，确保使用的邮箱与GitCode注册邮箱一致。

Q2：PR审核不通过如何处理？

A：仔细阅读审核人的反馈意见，在本地进行相应修改，然后重新commit并push。PR会自动更新，无需重新创建。

Q3：如何同步上游仓库的最新代码？

A：如果Fork的仓库落后于主仓库，执行以下命令同步：

# 添加上游仓库源 git remote add upstream https://link.gitcode.com/i/b27fa788e3bb68e3a1a9c75fd38f8576.git # 拉取最新代码 git pull upstream master --rebase # 解决可能的冲突 # 推送到个人仓库 git push origin master