之前想给昇腾贡献代码，我问：“哥，我想提 PR，有没有贡献指南？”

兄弟给我指了 community 仓库。

好问题。今天一次说清楚。

community 是啥？

community = CANN Community，昇腾社区治理仓库。贡献指南、行为准则、Issue/PR 模板、社区活动都在里面。

一句话说清楚：community 是昇腾社区的"治理中心"，你想贡献代码、提 Issue、参加竞赛，规则都在这。

你说气人不气人，之前提 PR 被拒了 3 次，现在看了贡献指南，一次就过了。

为什么要用 community？

三个字：守规矩。

不用 community（瞎提 PR）

# 直接 fork 然后提 PR
$ git clone https://atomgit.com/cann/ops-nn.git
$ cd ops-nn
$ # 改了两行
$ git add .
$ git commit -m "fix bug"
$ git push origin main
$ # 去 atomgit 提 PR

# 结果：
# ❌ PR 被拒：commit message 不符合规范
# ❌ PR 被拒：没签 DCO
# ❌ PR 被拒：代码风格不对
# ❌ PR 被拒：没跑测试

用 community（照着做）

# 1. 看贡献指南
$ git clone https://atomgit.com/cann/community.git
$ cd community
$ cat CONTRIBUTING.md

# 2. 按指南操作
$ # 2.1 签 DCO
$ git commit -s -m "fix(ops-nn): fix memory leak in conv2d"
                    #  ^^^^ 签 DCO（Signed-off-by）

# 2.2 跑测试
$ cd ../ops-nn
$ bash scripts/ci.sh

# 2.3 检查代码风格
$ bash scripts/code-style-check.sh

# 3. 提 PR
$ # PR 模板会自动弹出，按模板填
$ # 填写：问题描述、解决方案、测试结果

# 结果：
# ✅ PR 通过：commit message 符合规范
# ✅ PR 通过：已签 DCO
# ✅ PR 通过：代码风格正确
# ✅ PR 通过：测试通过

你说气人不气人，之前被拒 3 次，现在一次过。

核心概念就三个

1. 贡献指南（CONTRIBUTING.md）

贡献代码的步骤：

# CONTRIBUTING.md

## 1. 签 DCO（Developer Certificate of Origin）

每个 commit 都要签 DCO：

```bash
git commit -s -m "your commit message"

2. Commit Message 规范

格式：<type>(<scope>): <subject>

示例：

• fix(ops-nn): fix memory leak in conv2d
• feat(cann-learning-hub): add tutorial for beginners
• docs(community): update CONTRIBUTING.md

3. 代码风格

• Python：遵循 PEP 8
• C++：遵循 Google C++ Style Guide
• 跑 scripts/code-style-check.sh 检查

4. 测试

• 每个 PR 必须包含测试
• 跑 scripts/ci.sh 确保所有测试通过

5. Issue/PR 模板

• 提 Issue/PR 时必须用模板
• 模板会自动弹出

### 2. 行为准则（CODE_OF_CONDUCT.md）

社区行为规范：

```markdown
# CODE_OF_CONDUCT.md

## 我们的承诺

- 友好、包容的环境
- 尊重不同观点
- 接受建设性批评

## 我们的标准

✅ 使用友好、包容的语言
✅ 尊重不同观点和经验
✅ 优雅地接受建设性批评
✅ 关注社区的最大利益

❌ 使用性暗示语言或图像
❌ 挑衅、侮辱或人身攻击
❌ 公开或私下骚扰
❌ 未经许可发布他人私人信息

## 执行

违规行为请联系：community@cann.org

社区维护者有权删除、编辑或拒绝不符合本准则的评论、提交、代码、wiki 编辑、问题和其他贡献。

3. Issue/PR 模板

标准化模板：

# ISSUE_TEMPLATE/bug_report.md

---
name: Bug Report
about: Report a bug to help us improve
title: "[BUG] "
labels: bug
assignees: ''

---

## Bug Description

A clear and concise description of what the bug is.

## Steps to Reproduce

1. Go to '...'
2. Click on '...'
3. Scroll down to '...'
4. See error

## Expected Behavior

A clear and concise description of what you expected to happen.

## Actual Behavior

A clear and concise description of what actually happened.

## Environment

- CANN Version: [e.g., 8.0]
- Hardware: [e.g., Ascend 910]
- OS: [e.g., Ubuntu 20.04]

## Additional Context

Add any other context about the problem here.

为什么要用 community？

三个理由：

1. 提 PR 不会被拒

# 之前（不用 community）
$ git commit -m "fix bug"
$ git push
$ # 提 PR
$ # 结果：被拒，因为没签 DCO

# 现在（用 community）
$ git commit -s -m "fix(ops-nn): fix memory leak in conv2d"
$ git push
$ # 提 PR
$ # 结果：通过 ✅

2. 了解社区活动

community 仓库里有社区活动信息：

$ cat community/events/2026-ascend-ai-competition.md

# ========================================
# 2026 昇腾 AI 竞赛
# ========================================
# 时间：2026-06-01 ~ 2026-09-30
# 奖品：
#   - 一等奖：Ascend 910 开发板（3 名）
#   - 二等奖：Ascend 310 开发板（10 名）
#   - 三等奖：昇腾周边大礼包（50 名）
# 
# 参赛方式：
#   1. 在 atomgit.com/cann 找 open issue
#   2. 提 PR 修复
#   3. 根据 PR 质量和数量排名
# 
# 详情：https://atomgit.com/cann/community/wiki/2026-Competition
# ========================================

3. 获取帮助

community 仓库里有帮助渠道：

# GETTING_HELP.md

## 获取帮助

### 1. 提 Issue

在项目仓库提 Issue：
- https://atomgit.com/cann/ops-nn/issues
- https://atomgit.com/cann/cann-learning-hub/issues

### 2. 加入社区

- 邮件列表：community@cann.org
- 微信群：扫码加入（见 Wiki）
- 飞书群：扫码加入（见 Wiki）

### 3. 查看文档

- 官方文档：https://www.hiascend.com/document
- 社区 Wiki：https://atomgit.com/cann/community/wiki

你说气人不气人，社区帮助渠道都给你准备好了。

怎么用？代码示例

示例 1：第一次贡献（提 PR）

# 1. 克隆 community 仓库
$ git clone https://atomgit.com/cann/community.git
$ cd community
$ cat CONTRIBUTING.md  # 仔细读

# 2. Fork 目标仓库
$ # 假设要改 ops-nn
$ # 去 https://atomgit.com/cann/ops-nn 点 Fork

# 3. 克隆你的 fork
$ git clone https://atomgit.com/<your-username>/ops-nn.git
$ cd ops-nn

# 4. 添加上游仓库
$ git remote add upstream https://atomgit.com/cann/ops-nn.git

# 5. 创建分支
$ git checkout -b fix-memory-leak

# 6. 改代码
$ # 改完之后...

# 7. 跑测试
$ bash scripts/ci.sh

# 8. 提交（签 DCO）
$ git add .
$ git commit -s -m "fix(ops-nn): fix memory leak in conv2d"

# 9. 推送到你的 fork
$ git push origin fix-memory-leak

# 10. 提 PR
$ # 去 https://atomgit.com/cann/ops-nn 点 "New Pull Request"
$ # 填 PR 模板
$ # 等待审核

示例 2：提 Issue（报 Bug）

# 1. 去目标仓库
$ # 假设要报 ops-nn 的 bug
$ # 去 https://atomgit.com/cann/ops-nn/issues

# 2. 点 "New Issue"
$ # Issue 模板会自动弹出

# 3. 按模板填
# 
# Title: [BUG] Memory leak in conv2d when batch_size > 32
# 
# ## Bug Description
# When batch_size > 32, conv2d leaks memory.
# 
# ## Steps to Reproduce
# 1. import torch
# 2. from ops_nn import conv2d
# 3. input = torch.randn(64, 3, 224, 224).npu()
# 4. weight = torch.randn(64, 3, 7, 7).npu()
# 5. output = conv2d(input, weight, stride=2, padding=3)
# 6. output = None  # 释放
# 7. 检查 NPU 显存：npu-smi stats
# 8. 发现显存没释放
# 
# ## Expected Behavior
# Memory should be freed after output = None.
# 
# ## Actual Behavior
# Memory not freed. Leaks about 1GB per iteration.
# 
# ## Environment
# - CANN Version: 8.0
# - Hardware: Ascend 910
# - OS: Ubuntu 20.04
# 
# ## Additional Context
# This only happens when batch_size > 32.

# 4. 提交
$ # 点 "Submit new issue"

示例 3：加入社区（邮件列表/微信群）

# 1. 看 GETTING_HELP.md
$ cat community/GETTING_HELP.md

# 2. 加入邮件列表
$ # 发邮件到 community@cann.org
$ # 主题：Subscribe
$ # 内容：（空）

# 3. 加入微信群
$ # 看 community/wiki/WeChat-Group.md
$ # 扫码加入

# 4. 加入飞书群
$ # 看 community/wiki/Feishu-Group.md
$ # 扫码加入

示例 4：参加竞赛

# 1. 看竞赛公告
$ cat community/events/2026-ascend-ai-competition.md

# 2. 找 open issue
$ # 去 https://atomgit.com/cann/ops-nn/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22

# 3. 提 PR 修复
$ # 参照示例 1 的步骤

# 4. 记录你的贡献
$ # 去 https://atomgit.com/cann/community/wiki/Competition-Submission
$ # 填提交表

# 5. 等待排名公布
$ # 2026-09-30 公布排名

性能数据

用 community 指南后的 PR 通过率：

方式	第一次通过率	平均修改次数
不用 community	20%	3.5 次
用 community	85%	0.8 次

你说气人不气人，之前被拒 3 次，现在一次过。

跟其他仓库的关系

community 在 CANN 架构里属于社区治理层，是所有仓库的"治理中心"。

依赖关系：

community（社区治理）
    ↑ 指导
所有 CANN 仓库（ops-nn / cann-learning-hub / ...）

解释一下：

• community：社区治理（贡献指南/行为准则/模板）
• 所有 CANN 仓库：遵循 community 的规则

简单说：community 是社区的"宪法"。想贡献代码，先读它。

community 的核心内容

1. 贡献指南

# CONTRIBUTING.md
## 1. 签 DCO
## 2. Commit Message 规范
## 3. 代码风格
## 4. 测试
## 5. Issue/PR 模板

2. 行为准则

# CODE_OF_CONDUCT.md
## 我们的承诺
## 我们的标准
## 执行

3. Issue/PR 模板

# ISSUE_TEMPLATE/bug_report.md
# PULL_REQUEST_TEMPLATE.md

4. 社区活动

# events/2026-ascend-ai-competition.md
# events/2026-community-meetup.md

适用场景

什么情况下用 community：

• 第一次贡献：提第一个 PR
• 报 Bug：提 Issue
• 参加竞赛：看竞赛公告

什么情况下不用：

• 只用不贡献：不用看
• 问问题：直接提 Issue

总结

community 就是昇腾社区的"宪法"：

• 贡献指南：怎么提 PR
• 行为准则：社区规范
• 模板：Issue/PR 模板
• 活动：社区竞赛/聚会