可用于昇腾多机集群的训练与推理通信加速，支撑多卡高效数据同步。提供 AllReduce、AllGather 等集合通信与点对点算子，支持 Ring/Mesh/RHD 算法及 HCCS、RoCE、PCIe 链路，适配单算子与图模式。【此简介由AI生成】

文件	最后提交记录	最后更新时间
.agents	[feat]新增仓内AI贡献流程skill（.agents/skills/hccl-contribute） Co-authored-by: yanzhenghang<625612333@qq.com> # message auto-generated for no-merge-commit merge: !2824 merge feat/agents-contribute-skill into master [feat]新增仓内AI贡献流程skill（.agents/skills/hccl-contribute） Created-by: yanzhenghang Commit-by: yanzhenghang Merged-by: cann-robot Description: ## 描述为贡献者（AI Agent 或人工）提供仓内标准的贡献流程工作流。关联需求见 Issue #669。新增 `.agents/skills/hccl-contribute/`（贡献流程 skill，与已合入的 `hccl-review` 检视 skill 配对）： \| 文件 \| 内容 \| \|------\|------\| \| `SKILL.md` \| 贡献流程八步（代码获取与更新→依赖环境确认→本地构建与测试→Issue 查重创建→PR 创建提交并自动触发 CI→CI 监控→CI 失败修复→检视意见处置）+ 清理；每个子流程可独立运行；首次配置引导与执行纪律 \| \| `references/README.md` \| 参考文档索引（按场景加载） \| \| `references/gitcode-api.md` \| GitCode API 端点、认证、PR/Issue 创建语义、CI 标签流转与 saw_running 终态判定、错误码与已验证行为规律 \| \| `references/ci-triage.md` \| CI 失败诊断：常见失败模式表、codecheck G.* 规则与修复模式清单、已知非阻塞判定 \| \| `scripts/contribute.py` \| 贡献辅助脚本（Python 3.7+ 纯标准库）：环境校验 / 仓库同步（clone、fetch、脏工作区自动 worktree 隔离）/ Issue 查重与创建（标题关键词匹配，已有复用）/ PR 提交（git 身份校验 + push fork + 创建或复用 PR + 自动评论 /compile + GET 回查）/ CI 状态轮询（saw_running 状态机防旧标签误判）/ CI 失败日志获取（OBS 直链免登录）/ 未处理检视意见列表 / worktree 与临时文件清理 \| \| `scripts/test_contribute.py` \| 单元测试（55 用例，mock git 仓 + mock API，无网络依赖） \| \| `.agents/README.md` \| 仓内两个 AI skill（contribute/review）的简介与使用指引 \| 另：根 `AGENTS.md` 末尾新增一行——贡献链路操作使用本 skill，本地构建与测试命令以 AGENTS.md 第 4 节与 build.md 为准。设计原则：SKILL.md 只固化通用工作流；构建命令、依赖版本、编码规范不复制进 skill，从仓内 `AGENTS.md` 与 `docs/zh/build/build.md` 动态获取（规范演进自动跟随，无双源漂移）。与 `hccl-review` skill 分工互补：review 管检视，contribute 管贡献链路；检视意见修复后的线程回复复用 review skill 的 `--dispose`。 ## 变更类型 - [x] ✨ 新特性 ## 关联的Issue #807 ## 测试已完成的测试用例和场景： 1. 单元测试 54 用例双平台全绿：Windows（Python 3.14）与 WSL Ubuntu（Python 3.10），运行方式 `python3 -m unittest test_contribute`，无网络依赖（mock git 仓 + mock API，覆盖仓库同步三态、Issue 查重命中/未命中、PR 创建/422 复用、CI 状态机含 stale 标签防误判、检视意见列表、翻页防护、环境校验） 2. 真实只读验证：`--check-env`（token/remote/身份全通过）、`--ci-status`（真实 PR 标签与 GitCode 页面一致）、`--list-review-comments`（真实 PR 14 条未处理检视意见正确识别，含文件路径与行号） 3. 本 PR 自身作为 dogfooding 实测：Issue #669 由本 skill `--issue-ensure` 创建（自动查重无重复 + 自动加 [Requirement\|需求建议]: 前缀）；重复运行验证查重复用生效；本 PR 由本 skill `--submit-pr` 提交（push fork + PR 创建 + 自动 /compile 触发 + GET 回查全链路） 4. 检视意见修复轮（skill 深度自检 10/11 条实证意见全部修复：sync 二次运行/本地提交保护/v5 单条接口补路径/fork 绑定 token 账号/stale 退出/issue 自动关联/force-with-lease 设防等），测试增至 54 用例 5. 按需配置改进：纯 clone 用户（不提交 PR）免 token（check-env 降 WARN）；AGENTS.md 索引移入贡献流程章节；ci-triage 扩充 C++ 场景失败模式 6. 环境坑指引轮：Step 2/3 补充实测环境坑（UT 的 aicpu 前置须 --pkg --full 并安装 CANN、rootinfo 残留排查、WSL source 姿势、CANN 符号落后判别），ci-triage 新增「环境坑」节；本地构建/UT/ST 实测验证 6. 一轮 CI codecheck 失败（8 条告警：G.ERR.09 父子异常同捕 / G.CLS.06 方法排列 ×4 / G.FMT.03 空行 ×3）已全部修复，修复模式同步沉淀进 references/ci-triage.md；修复后单测双平台回归全绿 5. CI `ci-pipeline-passed` 补充的UT用例： scripts/test_contribute.py（54 用例：URL 归一化 / remote 探测 / 布局探测 / sync-repo 三态 / Issue 关键词与查重 / submit-pr 全链路与 422 复用与拒绝条件 / CI 状态机 7 态 / 流水线链接解析 / OBS 日志下载与 404 容忍 / 检视意见列表与过滤 / cleanup / token 优先级 / 翻页防护 5 例） ## 文档更新本 PR 即文档与工具新增；另修改根 `AGENTS.md` 新增一行贡献流程 skill 索引。 ## 合入检查 - [x] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md） - [x] 🏷️ 标题中使用了合适的类型标签（[feat]） - [x] 📄 代码修改内容已简要描述 - [x] 🛠️ 纯新增 `.agents/` 下文档与 python 脚本 + AGENTS.md 一行索引，不触碰 src/include/pkg_inc，无 C++ 代码变更 See merge request: cann/hccl!2824	3 天前
.gitcode	CodeCheck改用公共组件 Co-authored-by: wangchuang616<wangchuang12@huawei.com> # message auto-generated for no-merge-commit merge: !2863 merge master into master CodeCheck改用公共组件 Created-by: wangchuang616 Commit-by: wangchuang616 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2863	3 天前
cmake	[build] unified encoding, line breaks, and license header format Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2756 merge build/format into master [build] unified encoding, line breaks, and license header format Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 文本编码格式统一为 UTF-8 2. 所有文本换行符 CRLF 转为 LF，并在 .gitattributes 添加相应规则 3. OAT 检查涉及额外文件补充 license 头，并在 OAT.xml 更新规则 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> NA ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2756	10 天前
docs	[fix]inconsistent_check describe Co-authored-by: renyumin<renyumin1@huawei.com> # message auto-generated for no-merge-commit merge: !2878 merge master into master [fix]inconsistent_check describe Created-by: renyumin Commit-by: renyumin Merged-by: cann-robot Description: ## 描述当前 docs 内对 HCCL_DFS_CONFIG 配置中的 inconsistent_check 字段描述与实际不符，A5 一致性校验已支持图模式和 BatchSendRecv 场景 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2878	2 天前
examples	[modify docs]一级目录下的README.md与README_en.md增加中英文跳转，优化产品文档中仅存在一级目录的md文件 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !2862 merge master into master [modify docs]一级目录下的README.md与README_en.md增加中英文跳转，优化产品文档中仅存在一级目录的md文件 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、一级目录下的README.md与README_en.md增加中英文跳转。 2、优化产品文档中仅存在一级目录的md文件 3、examples目录下的README统一产品名称写法 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2862	2 天前
experimental	[modify docs]一级目录下的README.md与README_en.md增加中英文跳转，优化产品文档中仅存在一级目录的md文件 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !2862 merge master into master [modify docs]一级目录下的README.md与README_en.md增加中英文跳转，优化产品文档中仅存在一级目录的md文件 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、一级目录下的README.md与README_en.md增加中英文跳转。 2、优化产品文档中仅存在一级目录的md文件 3、examples目录下的README统一产品名称写法 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2862	2 天前
include	Modify the code standards Co-authored-by: unknown<huangjianbo3@h-partners.com> # message auto-generated for no-merge-commit merge: !2627 merge master into master Modify the code standards Created-by: muzhiyu6 Commit-by: unknown Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、修改代码格式规范 2、修复aiv 超时时间被截断的bug ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> https://gitcode.com/cann/hccl/issues/443 https://gitcode.com/cann/hccl/issues/442 https://gitcode.com/cann/hccl/issues/441 https://gitcode.com/cann/hccl/issues/439 https://gitcode.com/cann/hccl/issues/435 https://gitcode.com/cann/hccl/issues/434 https://gitcode.com/cann/hccl/issues/433 https://gitcode.com/cann/hccl/issues/431 https://gitcode.com/cann/hccl/issues/430 https://gitcode.com/cann/hccl/issues/429 https://gitcode.com/cann/hccl/issues/361 https://gitcode.com/cann/hccl/issues/359 https://gitcode.com/cann/hccl/issues/381 https://gitcode.com/cann/hccl/issues/567 https://gitcode.com/cann/hccl/issues/565 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 1、代码review ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：代码规范整改 See merge request: cann/hccl!2627	19 天前
scripts	fix: rename 910_96 to 960 for HCCL Co-authored-by: shirokawa_<jinliuyi@huawei.com> # message auto-generated for no-merge-commit merge: !2701 merge main0820 into master fix: rename 910_96 to 960 for HCCL Created-by: shirokawa_ Commit-by: shirokawa_ Merged-by: cann-robot Description: ## 描述 910_96统一改为960 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 A6功能pass ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2701	2 天前
src	2D场景数据流量切分——pcie Co-authored-by: fengshaoyu_kcaco<fengshaoyu5@huawei.com> # message auto-generated for no-merge-commit merge: !2902 merge data_partial into master 2D场景数据流量切分——pcie Created-by: fengshaoyu_kcaco Commit-by: fengshaoyu_kcaco Merged-by: cann-robot Description: ## 描述 2D场景下，通过设置环境变量，控制数据流量切分比例，适用于pcie ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： ## 合入检查 <!-- 在正式合入前，请做好必要的代码测试，用例补充，软件代码风格检查等。提高合入效率。--> <!-- [x] 表示选中 --> - [ ] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 - [x] 🔍 邀请 committer评论`/lgtm`前的必要检查 - [ ] 🏷️ 标题中使用了合适的类型标签（如：`[feat]`, `[fix]`） - [x] 📄 代码修改内容已简要描述，相关文档已更新 - [x] 📝 代码注释已更新，代码遵循项目整体代码风格 - [x] 🧪 代码UT测试已更新，覆盖率已达标 - [ ] 🔬 验证方法已更新到"测试"部分 - [ ] 🛠️ 代码已通过静态分析工具检查，无错误 - [ ] 👥 代码检视/code review/同行评议和必要的代码串讲，确保代码质量 - [ ] ✅ 代码检视意见已处理或答复，无未处理的检视意见 - [x] 🚀 预约前冒烟用例前的必要检查 - [x] ✔️ 代码已有committer的`/lgtm` 和模块committer的`/lgtm`评论 - [x] 🔧 代码已通过compile，编译无错误，无告警 - [ ] 🖥️ 代码已通过基本功能本地测试或者在线测试，确保基本功能正常 - [ ] 🎯 预约 approver评论`/approve`，正式合入前的必要检查 - [ ] 📊 前冒烟用例已全量通过 - [ ] 📦 新增功能已同步补充基本功能测试用例到前冒烟里 See merge request: cann/hccl!2902	1 天前
test	各个算子切换新 topo match + 带V算子costmodel Co-authored-by: acoolntly<chenjianhui22@h-partners.com> Co-authored-by: shenjiahui_<shenjiahui5@huawei.com> Co-authored-by: zhongyu1<zhongyu37@huawei.com> Co-authored-by: chenyia<chenyi163@huawei.com> Co-authored-by: cokelin<linguoxiong4@huawei.com> # message auto-generated for no-merge-commit merge: !2880 merge topo_match_collab into master 各个算子切换新 topo match + 带V算子costmodel Created-by: shenjiahui_ Commit-by: shenjiahui_;zhongyu1;cokelin;chenyia;acoolntly Merged-by: cann-robot Description: ## 描述各个算子切换新 topo match + 带V算子costmodel ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2880	1 天前
.clang-format	[build] License Header Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2558 merge build/oat into master [build] License Header Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 全仓C/C++、Python、Shell文件规范头部License的使用 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> NA ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2558	23 天前
.gitattributes	[build] unified encoding, line breaks, and license header format Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2756 merge build/format into master [build] unified encoding, line breaks, and license header format Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 文本编码格式统一为 UTF-8 2. 所有文本换行符 CRLF 转为 LF，并在 .gitattributes 添加相应规则 3. OAT 检查涉及额外文件补充 license 头，并在 OAT.xml 更新规则 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> NA ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2756	10 天前
.pre-commit-config.yaml	[build] unified encoding, line breaks, and license header format Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2756 merge build/format into master [build] unified encoding, line breaks, and license header format Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 文本编码格式统一为 UTF-8 2. 所有文本换行符 CRLF 转为 LF，并在 .gitattributes 添加相应规则 3. OAT 检查涉及额外文件补充 license 头，并在 OAT.xml 更新规则 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> NA ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2756	10 天前
AGENTS.md	[feat]新增仓内AI贡献流程skill（.agents/skills/hccl-contribute） Co-authored-by: yanzhenghang<625612333@qq.com> # message auto-generated for no-merge-commit merge: !2824 merge feat/agents-contribute-skill into master [feat]新增仓内AI贡献流程skill（.agents/skills/hccl-contribute） Created-by: yanzhenghang Commit-by: yanzhenghang Merged-by: cann-robot Description: ## 描述为贡献者（AI Agent 或人工）提供仓内标准的贡献流程工作流。关联需求见 Issue #669。新增 `.agents/skills/hccl-contribute/`（贡献流程 skill，与已合入的 `hccl-review` 检视 skill 配对）： \| 文件 \| 内容 \| \|------\|------\| \| `SKILL.md` \| 贡献流程八步（代码获取与更新→依赖环境确认→本地构建与测试→Issue 查重创建→PR 创建提交并自动触发 CI→CI 监控→CI 失败修复→检视意见处置）+ 清理；每个子流程可独立运行；首次配置引导与执行纪律 \| \| `references/README.md` \| 参考文档索引（按场景加载） \| \| `references/gitcode-api.md` \| GitCode API 端点、认证、PR/Issue 创建语义、CI 标签流转与 saw_running 终态判定、错误码与已验证行为规律 \| \| `references/ci-triage.md` \| CI 失败诊断：常见失败模式表、codecheck G.* 规则与修复模式清单、已知非阻塞判定 \| \| `scripts/contribute.py` \| 贡献辅助脚本（Python 3.7+ 纯标准库）：环境校验 / 仓库同步（clone、fetch、脏工作区自动 worktree 隔离）/ Issue 查重与创建（标题关键词匹配，已有复用）/ PR 提交（git 身份校验 + push fork + 创建或复用 PR + 自动评论 /compile + GET 回查）/ CI 状态轮询（saw_running 状态机防旧标签误判）/ CI 失败日志获取（OBS 直链免登录）/ 未处理检视意见列表 / worktree 与临时文件清理 \| \| `scripts/test_contribute.py` \| 单元测试（55 用例，mock git 仓 + mock API，无网络依赖） \| \| `.agents/README.md` \| 仓内两个 AI skill（contribute/review）的简介与使用指引 \| 另：根 `AGENTS.md` 末尾新增一行——贡献链路操作使用本 skill，本地构建与测试命令以 AGENTS.md 第 4 节与 build.md 为准。设计原则：SKILL.md 只固化通用工作流；构建命令、依赖版本、编码规范不复制进 skill，从仓内 `AGENTS.md` 与 `docs/zh/build/build.md` 动态获取（规范演进自动跟随，无双源漂移）。与 `hccl-review` skill 分工互补：review 管检视，contribute 管贡献链路；检视意见修复后的线程回复复用 review skill 的 `--dispose`。 ## 变更类型 - [x] ✨ 新特性 ## 关联的Issue #807 ## 测试已完成的测试用例和场景： 1. 单元测试 54 用例双平台全绿：Windows（Python 3.14）与 WSL Ubuntu（Python 3.10），运行方式 `python3 -m unittest test_contribute`，无网络依赖（mock git 仓 + mock API，覆盖仓库同步三态、Issue 查重命中/未命中、PR 创建/422 复用、CI 状态机含 stale 标签防误判、检视意见列表、翻页防护、环境校验） 2. 真实只读验证：`--check-env`（token/remote/身份全通过）、`--ci-status`（真实 PR 标签与 GitCode 页面一致）、`--list-review-comments`（真实 PR 14 条未处理检视意见正确识别，含文件路径与行号） 3. 本 PR 自身作为 dogfooding 实测：Issue #669 由本 skill `--issue-ensure` 创建（自动查重无重复 + 自动加 [Requirement\|需求建议]: 前缀）；重复运行验证查重复用生效；本 PR 由本 skill `--submit-pr` 提交（push fork + PR 创建 + 自动 /compile 触发 + GET 回查全链路） 4. 检视意见修复轮（skill 深度自检 10/11 条实证意见全部修复：sync 二次运行/本地提交保护/v5 单条接口补路径/fork 绑定 token 账号/stale 退出/issue 自动关联/force-with-lease 设防等），测试增至 54 用例 5. 按需配置改进：纯 clone 用户（不提交 PR）免 token（check-env 降 WARN）；AGENTS.md 索引移入贡献流程章节；ci-triage 扩充 C++ 场景失败模式 6. 环境坑指引轮：Step 2/3 补充实测环境坑（UT 的 aicpu 前置须 --pkg --full 并安装 CANN、rootinfo 残留排查、WSL source 姿势、CANN 符号落后判别），ci-triage 新增「环境坑」节；本地构建/UT/ST 实测验证 6. 一轮 CI codecheck 失败（8 条告警：G.ERR.09 父子异常同捕 / G.CLS.06 方法排列 ×4 / G.FMT.03 空行 ×3）已全部修复，修复模式同步沉淀进 references/ci-triage.md；修复后单测双平台回归全绿 5. CI `ci-pipeline-passed` 补充的UT用例： scripts/test_contribute.py（54 用例：URL 归一化 / remote 探测 / 布局探测 / sync-repo 三态 / Issue 关键词与查重 / submit-pr 全链路与 422 复用与拒绝条件 / CI 状态机 7 态 / 流水线链接解析 / OBS 日志下载与 404 容忍 / 检视意见列表与过滤 / cleanup / token 优先级 / 翻页防护 5 例） ## 文档更新本 PR 即文档与工具新增；另修改根 `AGENTS.md` 新增一行贡献流程 skill 索引。 ## 合入检查 - [x] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md） - [x] 🏷️ 标题中使用了合适的类型标签（[feat]） - [x] 📄 代码修改内容已简要描述 - [x] 🛠️ 纯新增 `.agents/` 下文档与 python 脚本 + AGENTS.md 一行索引，不触碰 src/include/pkg_inc，无 C++ 代码变更 See merge request: cann/hccl!2824	3 天前
CMakeLists.txt	fix: rename 910_96 to 960 for HCCL Co-authored-by: shirokawa_<jinliuyi@huawei.com> # message auto-generated for no-merge-commit merge: !2701 merge main0820 into master fix: rename 910_96 to 960 for HCCL Created-by: shirokawa_ Commit-by: shirokawa_ Merged-by: cann-robot Description: ## 描述 910_96统一改为960 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 A6功能pass ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2701	2 天前
CONTRIBUTING.md	【2026 HCCL通信库创新大赛-西部赛区】【降临派】docs: 修正 CONTRIBUTING.md 中“现在Issue列表中查询”表述 Co-authored-by: 2301_81769094<ziconglu@foxmail.com> # message auto-generated for no-merge-commit merge: !1795 merge docs/fix-contributing-wording-230 into master 【2026 HCCL通信库创新大赛-西部赛区】【降临派】docs: 修正 CONTRIBUTING.md 中“现在Issue列表中查询”表述 Created-by: 2301_81769094 Commit-by: 2301_81769094 Merged-by: cann-robot Description: ## 描述本次修改针对 `CONTRIBUTING.md` 中“简单问题处理”章节的文档表述问题进行修正。原文为： `现在Issue列表中查询该问题是否有对应的Issue；` 结合上下文，该步骤语义应为“先在 Issue 列表中查询该问题是否有对应的 Issue”，当前表述存在歧义，语句不够通顺，可能影响读者对贡献流程的理解。本次将其修正为： `先在Issue列表中查询该问题是否有对应的Issue；` 本次修改仅涉及文档文字调整，不涉及代码逻辑、接口或功能行为变化。补充说明：本PR为“2026 HCCL通信库创新大赛”西部赛区特别贡献奖提交，队名：降临派。 ## 关联的Issue https://gitcode.com/cann/hccl/issues/230 ## 测试本次为纯文档表述修正，未涉及代码逻辑变更，无需执行功能性测试。已结合 `CONTRIBUTING.md` 上下文检查修改前后语义，确认修改后表述更准确、通顺，符合该流程步骤的实际含义。 ## 文档更新更新了 `CONTRIBUTING.md` 文件中“简单问题处理”章节的表述。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!1795	1 个月前
CONTRIBUTING_en.md	修改中英文一致性问题 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !2608 merge master into master 修改中英文一致性问题 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、docs/en/rfcs/0001-add-batch-invariant-reducescatter.md 增加对应的英文文档 2、其他md修正中英文不一致问题。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2608	17 天前
LICENSE	子包适配 Co-authored-by: tianmingL<liutianming2@h-partners.com>	7 个月前
OAT.xml	[build] unified encoding, line breaks, and license header format Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2756 merge build/format into master [build] unified encoding, line breaks, and license header format Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 文本编码格式统一为 UTF-8 2. 所有文本换行符 CRLF 转为 LF，并在 .gitattributes 添加相应规则 3. OAT 检查涉及额外文件补充 license 头，并在 OAT.xml 更新规则 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> NA ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2756	10 天前
README.md	HCCL软件目录与软件架构保持一致 Co-authored-by: miaoziyi1031<miaoziyi3@huawei.com> # message auto-generated for no-merge-commit merge: !2823 merge feature/m00981902_hccl_dir_refactor into master HCCL软件目录与软件架构保持一致 Created-by: miaoziyi1031 Commit-by: miaoziyi1031 Merged-by: cann-robot Description: ## 描述本次修改用于实现 HCCL 仓软件目录与软件架构保持一致，主要针对 `src/ops` 下公共模块及各算子目录进行结构调整、职责归位，并同步完成相关构建和测试适配。主要修改内容如下： 1. op_common 公共算法目录调整 - 在 `src/ops/op_common` 下新增 `algorithm` 目录。 - 将原 `executor`、`template` 迁移至 `algorithm/executor`、`algorithm/template`，统一算法执行相关代码的目录归属。 2. 拓扑相关职责拆分与目录调整 - 将拓扑匹配相关 `topo_match_.cc/h` 归入 `src/ops/op_common/algorithm/topo_match`。 - 将拓扑信息、Rank 信息及拓扑信息初始化相关公共能力`topo.cc/h、topo_host.cc/h`归入 `src/ops/op_common/topo_info`(原topo更名为topo_info)。 - 明确拓扑信息获取与拓扑匹配职责边界，保持现有业务调用关系和功能逻辑不变。 3. 各算子目录结构统一* - 对 `all_reduce`、`all_gather`、`reduce_scatter`、`broadcast`、`reduce`、`scatter`、`all_to_all_v`、`barrier`、`send`、`recv` 等算子目录进行结构对齐。 - 算法执行相关代码统一归入 `algorithm/{executor,template}`。 - 算法选择相关代码保留在 `selector`。 - 同步调整部分算子入口文件命名，去掉`_op`，使目录及文件职责与软件架构保持一致。 4. 工程及引用适配 - 同步修改相关 `CMakeLists.txt`、`.cmake`、头文件引用路径及构建配置。 - 同步适配 ST、AICPU Kernel 等相关构建引用。 - 本次修改以目录迁移、职责归位及工程适配为主，不改变原有集合通信算法功能和算法执行逻辑。 ## 关联的Issue https://gitcode.com/cann/hccl/issues/658 ## 测试 ST全量通过、已完成Checker自验证 ## 文档更新更新了README.md、README_en.md及architecture-brief.md，变更软件目录架构 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ x ] 其他，请描述：HCCL仓目录架构调整 See merge request: cann/hccl!2823	4 天前
README_en.md	HCCL软件目录与软件架构保持一致 Co-authored-by: miaoziyi1031<miaoziyi3@huawei.com> # message auto-generated for no-merge-commit merge: !2823 merge feature/m00981902_hccl_dir_refactor into master HCCL软件目录与软件架构保持一致 Created-by: miaoziyi1031 Commit-by: miaoziyi1031 Merged-by: cann-robot Description: ## 描述本次修改用于实现 HCCL 仓软件目录与软件架构保持一致，主要针对 `src/ops` 下公共模块及各算子目录进行结构调整、职责归位，并同步完成相关构建和测试适配。主要修改内容如下： 1. op_common 公共算法目录调整 - 在 `src/ops/op_common` 下新增 `algorithm` 目录。 - 将原 `executor`、`template` 迁移至 `algorithm/executor`、`algorithm/template`，统一算法执行相关代码的目录归属。 2. 拓扑相关职责拆分与目录调整 - 将拓扑匹配相关 `topo_match_.cc/h` 归入 `src/ops/op_common/algorithm/topo_match`。 - 将拓扑信息、Rank 信息及拓扑信息初始化相关公共能力`topo.cc/h、topo_host.cc/h`归入 `src/ops/op_common/topo_info`(原topo更名为topo_info)。 - 明确拓扑信息获取与拓扑匹配职责边界，保持现有业务调用关系和功能逻辑不变。 3. 各算子目录结构统一* - 对 `all_reduce`、`all_gather`、`reduce_scatter`、`broadcast`、`reduce`、`scatter`、`all_to_all_v`、`barrier`、`send`、`recv` 等算子目录进行结构对齐。 - 算法执行相关代码统一归入 `algorithm/{executor,template}`。 - 算法选择相关代码保留在 `selector`。 - 同步调整部分算子入口文件命名，去掉`_op`，使目录及文件职责与软件架构保持一致。 4. 工程及引用适配 - 同步修改相关 `CMakeLists.txt`、`.cmake`、头文件引用路径及构建配置。 - 同步适配 ST、AICPU Kernel 等相关构建引用。 - 本次修改以目录迁移、职责归位及工程适配为主，不改变原有集合通信算法功能和算法执行逻辑。 ## 关联的Issue https://gitcode.com/cann/hccl/issues/658 ## 测试 ST全量通过、已完成Checker自验证 ## 文档更新更新了README.md、README_en.md及architecture-brief.md，变更软件目录架构 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ x ] 其他，请描述：HCCL仓目录架构调整 See merge request: cann/hccl!2823	4 天前
SECURITY.md	修改中英文一致性问题 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !2608 merge master into master 修改中英文一致性问题 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、docs/en/rfcs/0001-add-batch-invariant-reducescatter.md 增加对应的英文文档 2、其他md修正中英文不一致问题。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2608	17 天前
SECURITY_en.md	【modifiy docs】修改英文文档中的非标准英文字符，统一翻译术语 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !2711 merge master into master 【modifiy docs】修改英文文档中的非标准英文字符，统一翻译术语 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 修改英文文档中非标注英文字符，统一翻译术语 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2711	15 天前
Third_Party_Open_Source_Software_List.yaml	[build] unified encoding, line breaks, and license header format Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2756 merge build/format into master [build] unified encoding, line breaks, and license header format Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 文本编码格式统一为 UTF-8 2. 所有文本换行符 CRLF 转为 LF，并在 .gitattributes 添加相应规则 3. OAT 检查涉及额外文件补充 license 头，并在 OAT.xml 更新规则 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> NA ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2756	10 天前
Third_Party_Open_Source_Software_Notice	modify example c++17 & third party software notice Co-authored-by: Leewis<liwei945@huawei.com> # message auto-generated for no-merge-commit merge: !2588 merge master into master modify example c++17 & third party software notice Created-by: Leewis Commit-by: Leewis Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. example 中保持与主仓一致，c++14--》c++17 2. 修改相关第三方依赖文档 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> [#303](https://gitcode.com/cann/hccl/issues/303) [#597](https://gitcode.com/cann/hccl/issues/597) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2588	11 天前
build.sh	fix: rename 910_96 to 960 for HCCL Co-authored-by: shirokawa_<jinliuyi@huawei.com> # message auto-generated for no-merge-commit merge: !2701 merge main0820 into master fix: rename 910_96 to 960 for HCCL Created-by: shirokawa_ Commit-by: shirokawa_ Merged-by: cann-robot Description: ## 描述 910_96统一改为960 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 A6功能pass ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2701	2 天前
version.cmake	[build] unified encoding, line breaks, and license header format Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2756 merge build/format into master [build] unified encoding, line breaks, and license header format Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 文本编码格式统一为 UTF-8 2. 所有文本换行符 CRLF 转为 LF，并在 .gitattributes 添加相应规则 3. OAT 检查涉及额外文件补充 license 头，并在 OAT.xml 更新规则 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> NA ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2756	10 天前

HCCL

简体中文 | English

🔥Latest News

[2026/05] Ascend950 通信算子支持静态库，详见Issue#90，Issue#105
[2026/04] Ascend950 通信算子支持图模式，详见PR#613, PR#340, PR#296, GE PR#1620
[2026/03] Ascend950 通信算子支持AIV&AICPU通信引擎（单算子）
[2025/11/30] HCCL项目正式开源。

🚀 概述

集合通信库（Huawei Collective Communication Library，简称HCCL）是基于昇腾AI处理器的高性能集合通信库，为计算集群提供高性能、高可靠的通信方案，具备以下核心功能：

提供单机、多机环境中的高性能集合通信和点对点通信。
支持AllReduce、Broadcast、AllGather、ReduceScatter、AlltoAll等集合通信原语。
支持Ring、Mesh、Recursive Halving-Doubling（RHD）等通信算法。
支持HCCS、RoCE、PCIe等高速通信链路。
支持单算子和图模式两种执行模式。

HCCL是CANN的核心组件，对上支持多种AI框架，对下使能多款昇腾AI处理器之间的通信能力，其软件架构如下图所示：

hccl-architecture

HCCL包含HCCL集合通信库与HCOMM（Huawei Communication）通信基础库：

HCCL集合通信库：包含内置通信算子和扩展通信算子，提供对外的通信算子接口。
HCOMM通信基础库：采用分层解耦的设计思路，将通信能力划分为控制面和数据面两部分。

🔍 目录结构说明

本项目关键目录如下所示：

│── src                         # HCCL算子源码目录
|    ├── common                 # 通用逻辑，包括类型定义、日志模块等
|    └── ops                    # HCCL算子实现
|        ├── all_gather         # AllGather算子实现
|        ├── all_gather_v       # AllGatherV算子实现
|        ├── all_reduce         # AllReduce算子实现
|        ├── all_to_all_v       # AlltoAll、AlltoAllV、AlltoAllVC算子实现
|        ├── barrier            # Barrier算子实现
|        ├── batch_send_recv    # BatchSendRecv算子实现
|        ├── broadcast          # Broadcast算子实现
|        ├── interface_graph_mode # 图模式接口实现
|        ├── op_common          # 算子通用组件
|        │   ├── algorithm      # 算法层
|        │   │   ├── executor   # 执行器
|        │   │   ├── template   # 算法模板
|        │   │   └── topo_match # 算法执行阶段拓扑层级匹配
|        │   ├── selector       # 算法选择、CostModel等选择逻辑
|        │   ├── topo_info      # 公共拓扑信息生成、转换与Rank映射
|        │   └── inc            # 公共头文件
|        ├── recv               # Recv算子实现
|        ├── reduce             # Reduce算子实现
|        ├── reduce_scatter     # ReduceScatter算子实现
|        ├── reduce_scatter_v   # ReduceScatterV算子实现
|        ├── scatter            # Scatter算子实现
|        └── send               # Send算子实现
├── include                     # HCCL对外头文件
├── test                        # 测试代码目录
|   ├── ut                      # 单元测试代码目录
|   └── st                      # 系统测试代码目录
├── docs                        # 资料文档目录
├── examples                    # 样例代码目录
└── build.sh                    # 编译构建脚本