readme

Files	Last commit	Last update
context	fix: [master分支]整改文档，README新增社区全量算子入口及徽章、刷新算子库架构图新增ops-ras、新增Batch一致性和确定性计算特性文档 Co-authored-by: weihao18<weihao16@h-partners.com> # message auto-generated for no-merge-commit merge: !12080 merge fix-issue-5311 into master fix: [master分支]整改文档，README新增社区全量算子入口及徽章、刷新算子库架构图新增ops-ras、新增Batch一致性和确定性计算特性文档 Created-by: weihao18 Commit-by: weihao18 Merged-by: cann-robot Description: ## 描述 fix: 整改文档，README新增社区全量算子入口及徽章、刷新算子库架构图新增ops-ras、新增Batch一致性和确定性计算特性文档 ## 关联的Issue https://gitcode.com/cann/ops-transformer/issues/5311 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [x] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!12080	1 month ago
debug	chore: replace gitcode.com links with atomgit.com Co-authored-by: qzzzy1<qiziyu2@huawei.com> # message auto-generated for no-merge-commit merge: !12664 merge master into master chore: replace gitcode.com links with atomgit.com Created-by: qzzzy1 Commit-by: qzzzy1 Merged-by: cann-robot Description: ## 描述 transformer仓gitcode.com改成atomgit.com ## 关联的Issue 关联Issue 5667 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [x] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!12664	1 month ago
develop	feat(pre-commit): 拦截类钩子报告统一落盘 pre-commit_reports + 健壮性与策略对齐 Co-authored-by: gitcode_lijd<lijiandong20@huawei.com> # message auto-generated for no-merge-commit merge: !12834 merge fix_2 into master feat(pre-commit): 拦截类钩子报告统一落盘 pre-commit_reports + 健壮性与策略对齐 Created-by: gitcode_lijd Commit-by: gitcode_lijd Merged-by: cann-robot Description: 关联Issue https://gitcode.com/cann/ops-transformer/issues/5016 ## 描述 #### 🐛 Bug 修复 / ✨ 特性增强 围绕既有 pre-commit 体系的三处完善（8 文件 +38/-12，1 笔提交）：**拦截类钩子报告落盘**、**脚本健壮性修复**、**策略与文档对齐**。全部经 --all-files 全量实测校准。 ### 一、拦截类钩子报告统一落盘 pre-commit_reports/（不入 git） | 改动 | 内容 | |---|---| | scripts/run_codespell.sh（新增） | codespell 输出 tee 到 pre-commit_reports/codespell.log（entry 覆写仍跑托管 venv，PIPESTATUS 保退出码） | | .pre-commit-config.yaml | codespell entry 指向包装脚本 | | scripts/oat_check.sh | 报告落点 oat_reports/result.txt → pre-commit_reports/oat_result.txt（单文件与批量两条写路径同步） | | .gitignore | oat_reports/ → pre-commit_reports/ | | docs/zh/develop/pre-commit_guide.md | 失败排查节补报告位置说明 | 自动修类钩子（clang-format/ruff）直接改好文件无需报告；拼写/合规须人工处理，报告落盘便于复查与喂给 agent 修复。 ### 二、健壮性修复（姊妹仓全量实测暴露的同款隐患） | 改动 | 内容 | |---|---| | scripts/oat_check.sh | eval 拼接改数组传参 + -f 加引——文件名含 ()/&/[]/空格时 eval 会打断 shell 致扫描假死/假过（本仓当前 0 此类文件名，防御性修复） | | scripts/format_cpp.sh | 目录不存在时原仅打印提示仍继续执行，改为报错退出（exit 1） | ### 三、策略与文档对齐 | 改动 | 内容 | |---|---| | OAT.xml | 豁免 requirements*.txt（依赖清单，双过滤器）、*.info（cmake help，双过滤器）——全量扫描 250→240，残留均为真实缺头债（增量消化） | | trailing-whitespace | 补 --markdown-linebreak-ext=md（防静默剥掉 md 双空格硬换行语法，实测：双空格保留、三空格收敛、单空格照删） | | .clang-format | PointerAlignment 改 **Left**（int* p 指针随类型，领导确认口径；引用 & 同规则）；年份 2025→2026 | ## 测试 - 全量 OAT 16 批真实扫描（无双误退出码）；缺头 py 拦截有效、豁免类型放行 - md 双空格保留实测通过；codespell 命中落盘、OAT 报告落盘且目录不被 git 跟踪 - 本提交自身过全部钩子（含 OAT）；yaml/xml/bash 语法全过 ## 留作仓主决策（本 PR 不动） - ruff --ignore 现行清单含 F841,F821,F401 等 F 系列——skills-dev 口径为「F 系列全启用抓真 bug」，两仓策略不同，建议仓主确认后另行统一 - third_party/catlass、third_party/opbase 下同名 oat_check.sh 为上游副本，未动 ## 类型标签 - [x] 🐛 Bug 修复 - [x] ✨ 特性增强 See merge request: cann/ops-transformer!12834	1 month ago
figures	fix: [master分支]整改文档，README新增社区全量算子入口及徽章、刷新算子库架构图新增ops-ras、新增Batch一致性和确定性计算特性文档 Co-authored-by: weihao18<weihao16@h-partners.com> # message auto-generated for no-merge-commit merge: !12080 merge fix-issue-5311 into master fix: [master分支]整改文档，README新增社区全量算子入口及徽章、刷新算子库架构图新增ops-ras、新增Batch一致性和确定性计算特性文档 Created-by: weihao18 Commit-by: weihao18 Merged-by: cann-robot Description: ## 描述 fix: 整改文档，README新增社区全量算子入口及徽章、刷新算子库架构图新增ops-ras、新增Batch一致性和确定性计算特性文档 ## 关联的Issue https://gitcode.com/cann/ops-transformer/issues/5311 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [x] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!12080	1 month ago
install	chore: replace gitcode.com links with atomgit.com Co-authored-by: qzzzy1<qiziyu2@huawei.com> # message auto-generated for no-merge-commit merge: !12664 merge master into master chore: replace gitcode.com links with atomgit.com Created-by: qzzzy1 Commit-by: qzzzy1 Merged-by: cann-robot Description: ## 描述 transformer仓gitcode.com改成atomgit.com ## 关联的Issue 关联Issue 5667 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [x] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!12664	1 month ago
invocation	chore: replace gitcode.com links with atomgit.com Co-authored-by: qzzzy1<qiziyu2@huawei.com> # message auto-generated for no-merge-commit merge: !12664 merge master into master chore: replace gitcode.com links with atomgit.com Created-by: qzzzy1 Commit-by: qzzzy1 Merged-by: cann-robot Description: ## 描述 transformer仓gitcode.com改成atomgit.com ## 关联的Issue 关联Issue 5667 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [x] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!12664	1 month ago
ascend950_op_list.md	feat(attention_worker_combine): 支持下一代实现 Co-authored-by: guoqiuhao<guoqiuhao1@huawei.com> # message auto-generated for no-merge-commit merge: !12658 merge att-dev into master feat(attention_worker_combine): 支持下一代实现 Created-by: guoqiuhao Commit-by: guoqiuhao Merged-by: cann-robot Description: ## 描述 AttentionWorkerCombine 支持下一代实现： 非量化：token 类型为 FP16 或 BF16，前 K 行路由专家分别乘 FP32 scale，最后一行共享专家直接累加； MXFP 反量化：支持 MXFP8 E5M2、MXFP8 E4M3FN 和 MXFP4 E2M1，K+1 行 token 均使用对应的 E8M0 scale 进行反量化，输出 BF16。 ## 关联的Issue [#5570](https://gitcode.com/cann/ops-transformer/issues/5570) ## 测试 st、二级冒烟 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [x] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [ ] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!12658	1 month ago
menu_aclnn_api.md	docs: remove aclnnAllGatherAdd entries from official aclnn API doc lists Co-authored-by: LiuZonggu<liuzonggu1@huawei.com> # message auto-generated for no-merge-commit merge: !13442 merge fix/remove-non-commercial-desc into master docs: remove aclnnAllGatherAdd entries from official aclnn API doc lists Created-by: LiuZonggu Commit-by: LiuZonggu Merged-by: cann-robot Description: ## 描述 aclnnAllGatherAdd is an examples-only (non-commercial) operator under examples/mc2/all_gather_add, but it was listed in the official aclnn API documentation — the only entry whose link points into the examples/ directory. This PR removes its menu entry from docs/zh/menu_aclnn_api.md and its table row from docs/zh/op_api_list.md. The operator itself and its references in the examples/experimental area are unchanged. ## 关联的Issue [Fixes #5857](https://gitcode.com/cann/ops-transformer/issues/5857) ## 测试 - Verified no remaining aclnnAllGatherAdd references under docs/zh/ - Table structure and menu alphabetical order intact after removal - Documentation-only change, no code/build impact ## 文档更新 This PR is a documentation update: 2 lines removed from 2 Chinese docs. ## 类型标签 - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [x] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!13442	1 month ago
menu_torch_api.md	feat: 新增 GroupedMatmulSwigluQuantWeightNzV3 算子及 aclnn/torch 接口 Co-authored-by: zhoushaolong<zhoushaolong3@huawei.com> # message auto-generated for no-merge-commit merge: !11903 merge feature/gmm-swiglu-quant-weight-nz-v3 into master feat: 新增 GroupedMatmulSwigluQuantWeightNzV3 算子及 aclnn/torch 接口 Created-by: zhoushaolong Commit-by: zhoushaolong Merged-by: cann-robot Description: ## 描述 新增 GroupedMatmulSwigluQuantWeightNzV3 算子：融合 GroupedMatmul、MXFP8 反量化、SwiGLU 与 MXFP8 量化的 weight NZ 特化版本，直接接收 FRACTAL_NZ 格式 weight，当前支持 Ascend 950PR/Ascend 950DT 单 Tensor MXFP8 场景（swigluMode 当前仅支持 2）。 相对 V2 接口的主要扩展： - 新增 SwiGLU 计算参数 swigluMode、clampLimit、gluAlpha、gluBias（mode 2：前半部分 clamp 后执行带 alpha 的 SiLU，后半部分 clamp 加 bias 作线性分支，逐元素相乘） - 新增 MX 量化参数 roundMode、scaleAlg、dstTypeMax 主要交付内容： - op_api：aclnnGroupedMatmulSwigluQuantWeightNzV3 两段式接口（GetWorkspaceSize + 执行） - op_host：算子注册、infershape、tiling（通用 + arch35 tensor api tiling） - op_kernel：arch35 MXFP8 tensor api kernel（含 apt 适配） - torch_extension：grouped_matmul_swiglu_quant_v2 torch 扩展（csrc + python 绑定） - 公共 cgmct：epilogue 支持 V3 SwiGLU 参数与多种 scale 算法（cuBLAS 对齐、动态 dtype 范围），yScale 类型化为 E8M0 并按有效分组紧凑拷贝 - docs / example：aclnn 接口文档、torchapi 文档、README 与菜单更新、arch35 调测示例 ## 关联的Issue - 关联Issue #5552 ## 测试 新增 UT： - tests/ut/op_api/test_aclnn_grouped_matmul_swiglu_quant_weight_nz_v3.cpp（含用例 csv） - tests/ut/op_host/test_grouped_matmul_swiglu_quant_weight_nz_v3_route_tiling.cpp（含 tensor api gate 用例说明） ## 文档更新 新增 docs/aclnnGroupedMatmulSwigluQuantWeightNzV3.md 与 docs/torchapi_grouped_matmul_swiglu_quant_v2.md；更新 README.md、docs/zh/menu_torch_api.md、docs/zh/torch_api_list.md。 ## 类型标签 - [ ] 🐛 Bug修复 - [x] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [ ] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!11903	1 month ago
op_api_list.md	docs: remove aclnnAllGatherAdd entries from official aclnn API doc lists Co-authored-by: LiuZonggu<liuzonggu1@huawei.com> # message auto-generated for no-merge-commit merge: !13442 merge fix/remove-non-commercial-desc into master docs: remove aclnnAllGatherAdd entries from official aclnn API doc lists Created-by: LiuZonggu Commit-by: LiuZonggu Merged-by: cann-robot Description: ## 描述 aclnnAllGatherAdd is an examples-only (non-commercial) operator under examples/mc2/all_gather_add, but it was listed in the official aclnn API documentation — the only entry whose link points into the examples/ directory. This PR removes its menu entry from docs/zh/menu_aclnn_api.md and its table row from docs/zh/op_api_list.md. The operator itself and its references in the examples/experimental area are unchanged. ## 关联的Issue [Fixes #5857](https://gitcode.com/cann/ops-transformer/issues/5857) ## 测试 - Verified no remaining aclnnAllGatherAdd references under docs/zh/ - Table structure and menu alphabetical order intact after removal - Documentation-only change, no code/build impact ## 文档更新 This PR is a documentation update: 2 lines removed from 2 Chinese docs. ## 类型标签 - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [x] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!13442	1 month ago
op_list.md	fix product master2 Co-authored-by: caiwenwen<caiwenwen6@h-partners.com> # message auto-generated for no-merge-commit merge: !13074 merge master into master fix product master2 Created-by: caiwenwen Commit-by: caiwenwen Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> AI处理器对应的产品型号名称更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> [#3258](https://gitcode.com/cann/ops-math/issues/3258) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ok ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> *.md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-transformer!13074	1 month ago
torch_api_list.md	feat: 新增 GroupedMatmulSwigluQuantWeightNzV3 算子及 aclnn/torch 接口 Co-authored-by: zhoushaolong<zhoushaolong3@huawei.com> # message auto-generated for no-merge-commit merge: !11903 merge feature/gmm-swiglu-quant-weight-nz-v3 into master feat: 新增 GroupedMatmulSwigluQuantWeightNzV3 算子及 aclnn/torch 接口 Created-by: zhoushaolong Commit-by: zhoushaolong Merged-by: cann-robot Description: ## 描述 新增 GroupedMatmulSwigluQuantWeightNzV3 算子：融合 GroupedMatmul、MXFP8 反量化、SwiGLU 与 MXFP8 量化的 weight NZ 特化版本，直接接收 FRACTAL_NZ 格式 weight，当前支持 Ascend 950PR/Ascend 950DT 单 Tensor MXFP8 场景（swigluMode 当前仅支持 2）。 相对 V2 接口的主要扩展： - 新增 SwiGLU 计算参数 swigluMode、clampLimit、gluAlpha、gluBias（mode 2：前半部分 clamp 后执行带 alpha 的 SiLU，后半部分 clamp 加 bias 作线性分支，逐元素相乘） - 新增 MX 量化参数 roundMode、scaleAlg、dstTypeMax 主要交付内容： - op_api：aclnnGroupedMatmulSwigluQuantWeightNzV3 两段式接口（GetWorkspaceSize + 执行） - op_host：算子注册、infershape、tiling（通用 + arch35 tensor api tiling） - op_kernel：arch35 MXFP8 tensor api kernel（含 apt 适配） - torch_extension：grouped_matmul_swiglu_quant_v2 torch 扩展（csrc + python 绑定） - 公共 cgmct：epilogue 支持 V3 SwiGLU 参数与多种 scale 算法（cuBLAS 对齐、动态 dtype 范围），yScale 类型化为 E8M0 并按有效分组紧凑拷贝 - docs / example：aclnn 接口文档、torchapi 文档、README 与菜单更新、arch35 调测示例 ## 关联的Issue - 关联Issue #5552 ## 测试 新增 UT： - tests/ut/op_api/test_aclnn_grouped_matmul_swiglu_quant_weight_nz_v3.cpp（含用例 csv） - tests/ut/op_host/test_grouped_matmul_swiglu_quant_weight_nz_v3_route_tiling.cpp（含 tensor api gate 用例说明） ## 文档更新 新增 docs/aclnnGroupedMatmulSwigluQuantWeightNzV3.md 与 docs/torchapi_grouped_matmul_swiglu_quant_v2.md；更新 README.md、docs/zh/menu_torch_api.md、docs/zh/torch_api_list.md。 ## 类型标签 - [ ] 🐛 Bug修复 - [x] ✨ 新特性 - [ ] ⚡ 性能优化 - [ ] ♻️ 重构 - [ ] 🧪 测试 - [ ] 📦 构建/CI - [ ] 🔧 配置变更 - [ ] 📝 文档更新 - [ ] ⬆️ 依赖升级 - [ ] 🔒 安全修复 - [ ] 🧹 代码清理 - [ ] ❓ 其他，请描述： See merge request: cann/ops-transformer!11903	1 month ago