| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
docs: align bilingual example READMEs Co-authored-by: xun_zhuge<zhugexun@hisilicon.com> # message auto-generated for no-merge-commit merge: !4370 merge fix-examples-bilingual-readme-alignment into master docs: align bilingual example READMEs Created-by: xun_zhuge Commit-by: xun_zhuge Merged-by: cann-robot Description: ## 描述 本 PR 从 master 分支修复 examples 目录中中英文 README 不严格对应、同仓文档链接形式不统一及 Markdown 渲染结构错误的问题，确保两种语言描述同一份技术内容，并统一使用相对路径引用本仓 docs。不涉及样例实现逻辑。 主要变更： - 全量核对 388 组 README.md / README_en.md，中英文单边缺失均为 0。 - 补齐英文文档遗漏的场景图、理论分析公式、参数解释、产品差异、性能分析和 API 使用说明；重点补齐 10 张场景图及多处 MTE2/Cube 理论分析，并完整对齐 18 处 msOpProf 章节。 - 修正矩阵维度、shape、对齐值、性能倍率、带宽公式及百分点等技术数据，确保文档与中文原文及样例源码一致。 - 修复语义误译，包括逐元素比较值被误译为比较 tensor 尺寸、aic_mac_ratio 被误译为理论峰值性能，以及 UB Bank 冲突调优建议增译和漏译等问题。 - 将 70 个 README 中 420 条指向本仓 docs 的 GitCode HTTPS 链接改为相对路径，保留 28 个锚点，且转换前后均解析到同一文件或目录。 - 更新 Markdown 链接策略：允许 examples 使用相对路径引用 docs，并拒绝新增同仓 docs HTTPS 链接；其他跨区链接约束保持不变。 - 修复 3 处实际渲染结构问题：mmad_load3dv2 英文表格行缩进、simulator 英文子列表层级、load_data_2dv2_l12l0 中文代码块列表归属。 - 将 6 个中英文 README 中 12 处 C++ 代码块语言标识统一为 cpp，确保代码高亮标识一致。 - 对 17 个存在对齐问题的中英文对应目录树统一 // 注释列，修复 08_simulator 英文树层级缩进，并将 4 组目录树误用的 ASCII | 统一为 Unicode │。 - 为满足仓库中英文 README 成对修改拦截规则，对 PR 中 34 个原本单边改动的 counterpart 增加不影响 Markdown 渲染的空行，使全部改动 README 成对出现。 - 对齐标题层级、段落与列表、目录树、命令、代码注释、Markdown/HTML 表格、图片、公式、链接和锚点，并清理英文正文中的中文残留。 ## 关联的Issue 无。 ## 测试 已完成以下验证： - git diff --check origin/master...HEAD：通过。 - bash -n scripts/markdown_link_check.sh：通过。 - bash scripts/markdown_link_check.sh --full：通过，共检查 3953 个 Markdown 文件。 - README 配对检查：388 组，中文或英文单边缺失均为 0。 - 双语渲染结构检查：388 组的标题、表格、代码块、列表及嵌套关系差异均为 0。 - 全量 Markdown 格式检查：776 个 README、1770 个 Markdown 表格、4068 个 fenced code block；表格缩进、代码围栏闭合/缩进及非规范 C++ 语言标识问题均为 0。 - 目录树专项检查：278 个带注释的中英文对应目录树块；注释列不一致、短层级缩进和 ASCII 树线残留均为 0。 - 成对修改检查：186 个改动 README，组成 93 对；单边改动为 0；34 个补位 README 的渲染 HTML 变化为 0。 - 链接精确转换检查：70 个 README、420 条链接、28 个锚点，非链接正文改动为 0，目标错误为 0。 - examples 中同仓 docs HTTPS 链接残留检查：0 条。 - 链接策略红绿验证：同仓 HTTPS 链接会被拒绝并给出相对路径，原有 docs/api 与 docs/guide 跨区约束仍生效。 - 提交前检查：OAT Compliance Check 和 Markdown link check 均通过。 ## 文档更新 更新 examples 下 186 个 README 文件（93 个英文、93 个中文）及 scripts/markdown_link_check.sh，使双语文档严格对齐、翻译准确，统一同仓文档链接规范，并修复表格、代码块和列表的渲染格式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4370 | 1 个月前 | |
📝 docs: update special buffer dump README titles Co-authored-by: ApeiriaNode_Booker<renjie88@huawei.com> # message auto-generated for no-merge-commit merge: !4419 merge docs/special-buffer-dump-title into master 📝 docs: update special buffer dump README titles Created-by: ApeiriaNode_Booker Commit-by: ApeiriaNode_Booker Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> - 调整 special_buffer_dump 中英文 README 标题，突出特殊 Buffer 的 DumpTensor 功能。 - 保留 QuantMatmulHifp8 作为样例背景，避免将该样例表述为具体算子用例。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> - pre-commit run --from-ref HEAD^ --to-ref HEAD ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4419 | 1 个月前 | |
fix(examples): correct build settings and fp16 validation Co-authored-by: zhangyujia77<zhangyujia37@huawei.com> # message auto-generated for no-merge-commit merge: !4349 merge fix-examples into master fix(examples): correct build settings and fp16 validation Created-by: zhangyujia77 Commit-by: zhangyujia77 Merged-by: cann-robot Description: ## 描述 修复examples目录中的构建配置和FP16结果校验问题： 1. 删除8个样例中重复添加的 --npu-arch=${CMAKE_ASC_ARCHITECTURES}，统一由ASC CMake模块注入，避免编译命令重复传参。 2. 精简ge_torchair和triple_chevron_notation的链接依赖。 3. 将aclnn_invocation的FP16结果校验从精确比特比较改为容差比较。 ## 关联的Issue 无。 ## 测试 - 对以下8个受影响样例分别执行CMake配置和完整构建，全部通过：ge_torchair、pybind、torch_library、triple_chevron_notation、vector_tiling_strategy、00_basic_compile、03_static_library_compile、matmul_aot_compilation。 ## 文档更新 无。 ## 类型标签 - [x] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4349 | 1 个月前 | |
fix ld_st_reg_align ub init bug Co-authored-by: ruanyy<ruanyingyang@h-partners.com> # message auto-generated for no-merge-commit merge: !4486 merge bugfix into master fix ld_st_reg_align ub init bug Created-by: ruanyy Commit-by: ruanyy Merged-by: cann-robot Description: ## 描述 ld_st_reg_align 样例偶现精度问题修复：非对齐场景的尾块数据没有初始化，导致可能混入上一次计算的脏数据 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 cpu、npu模式验证通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4486 | 1 个月前 | |
docs: align bilingual example READMEs Co-authored-by: xun_zhuge<zhugexun@hisilicon.com> # message auto-generated for no-merge-commit merge: !4370 merge fix-examples-bilingual-readme-alignment into master docs: align bilingual example READMEs Created-by: xun_zhuge Commit-by: xun_zhuge Merged-by: cann-robot Description: ## 描述 本 PR 从 master 分支修复 examples 目录中中英文 README 不严格对应、同仓文档链接形式不统一及 Markdown 渲染结构错误的问题，确保两种语言描述同一份技术内容，并统一使用相对路径引用本仓 docs。不涉及样例实现逻辑。 主要变更： - 全量核对 388 组 README.md / README_en.md，中英文单边缺失均为 0。 - 补齐英文文档遗漏的场景图、理论分析公式、参数解释、产品差异、性能分析和 API 使用说明；重点补齐 10 张场景图及多处 MTE2/Cube 理论分析，并完整对齐 18 处 msOpProf 章节。 - 修正矩阵维度、shape、对齐值、性能倍率、带宽公式及百分点等技术数据，确保文档与中文原文及样例源码一致。 - 修复语义误译，包括逐元素比较值被误译为比较 tensor 尺寸、aic_mac_ratio 被误译为理论峰值性能，以及 UB Bank 冲突调优建议增译和漏译等问题。 - 将 70 个 README 中 420 条指向本仓 docs 的 GitCode HTTPS 链接改为相对路径，保留 28 个锚点，且转换前后均解析到同一文件或目录。 - 更新 Markdown 链接策略：允许 examples 使用相对路径引用 docs，并拒绝新增同仓 docs HTTPS 链接；其他跨区链接约束保持不变。 - 修复 3 处实际渲染结构问题：mmad_load3dv2 英文表格行缩进、simulator 英文子列表层级、load_data_2dv2_l12l0 中文代码块列表归属。 - 将 6 个中英文 README 中 12 处 C++ 代码块语言标识统一为 cpp，确保代码高亮标识一致。 - 对 17 个存在对齐问题的中英文对应目录树统一 // 注释列，修复 08_simulator 英文树层级缩进，并将 4 组目录树误用的 ASCII | 统一为 Unicode │。 - 为满足仓库中英文 README 成对修改拦截规则，对 PR 中 34 个原本单边改动的 counterpart 增加不影响 Markdown 渲染的空行，使全部改动 README 成对出现。 - 对齐标题层级、段落与列表、目录树、命令、代码注释、Markdown/HTML 表格、图片、公式、链接和锚点，并清理英文正文中的中文残留。 ## 关联的Issue 无。 ## 测试 已完成以下验证： - git diff --check origin/master...HEAD：通过。 - bash -n scripts/markdown_link_check.sh：通过。 - bash scripts/markdown_link_check.sh --full：通过，共检查 3953 个 Markdown 文件。 - README 配对检查：388 组，中文或英文单边缺失均为 0。 - 双语渲染结构检查：388 组的标题、表格、代码块、列表及嵌套关系差异均为 0。 - 全量 Markdown 格式检查：776 个 README、1770 个 Markdown 表格、4068 个 fenced code block；表格缩进、代码围栏闭合/缩进及非规范 C++ 语言标识问题均为 0。 - 目录树专项检查：278 个带注释的中英文对应目录树块；注释列不一致、短层级缩进和 ASCII 树线残留均为 0。 - 成对修改检查：186 个改动 README，组成 93 对；单边改动为 0；34 个补位 README 的渲染 HTML 变化为 0。 - 链接精确转换检查：70 个 README、420 条链接、28 个锚点，非链接正文改动为 0，目标错误为 0。 - examples 中同仓 docs HTTPS 链接残留检查：0 条。 - 链接策略红绿验证：同仓 HTTPS 链接会被拒绝并给出相对路径，原有 docs/api 与 docs/guide 跨区约束仍生效。 - 提交前检查：OAT Compliance Check 和 Markdown link check 均通过。 ## 文档更新 更新 examples 下 186 个 README 文件（93 个英文、93 个中文）及 scripts/markdown_link_check.sh，使双语文档严格对齐、翻译准确，统一同仓文档链接规范，并修复表格、代码块和列表的渲染格式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4370 | 1 个月前 | |
修复bank conflict用例case10-14报错 Co-authored-by: cruiter<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !4394 merge fix-bank-conflict into master 修复bank conflict用例case10-14报错 Created-by: printfscanfmain Commit-by: cruiter Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 修复bank conflict用例case10-14报错 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 不涉及 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 不涉及 ## 类型标签 <!-- [x] 表示选中 --> - [x] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4394 | 1 个月前 | |
docs: align bilingual example READMEs Co-authored-by: xun_zhuge<zhugexun@hisilicon.com> # message auto-generated for no-merge-commit merge: !4370 merge fix-examples-bilingual-readme-alignment into master docs: align bilingual example READMEs Created-by: xun_zhuge Commit-by: xun_zhuge Merged-by: cann-robot Description: ## 描述 本 PR 从 master 分支修复 examples 目录中中英文 README 不严格对应、同仓文档链接形式不统一及 Markdown 渲染结构错误的问题，确保两种语言描述同一份技术内容，并统一使用相对路径引用本仓 docs。不涉及样例实现逻辑。 主要变更： - 全量核对 388 组 README.md / README_en.md，中英文单边缺失均为 0。 - 补齐英文文档遗漏的场景图、理论分析公式、参数解释、产品差异、性能分析和 API 使用说明；重点补齐 10 张场景图及多处 MTE2/Cube 理论分析，并完整对齐 18 处 msOpProf 章节。 - 修正矩阵维度、shape、对齐值、性能倍率、带宽公式及百分点等技术数据，确保文档与中文原文及样例源码一致。 - 修复语义误译，包括逐元素比较值被误译为比较 tensor 尺寸、aic_mac_ratio 被误译为理论峰值性能，以及 UB Bank 冲突调优建议增译和漏译等问题。 - 将 70 个 README 中 420 条指向本仓 docs 的 GitCode HTTPS 链接改为相对路径，保留 28 个锚点，且转换前后均解析到同一文件或目录。 - 更新 Markdown 链接策略：允许 examples 使用相对路径引用 docs，并拒绝新增同仓 docs HTTPS 链接；其他跨区链接约束保持不变。 - 修复 3 处实际渲染结构问题：mmad_load3dv2 英文表格行缩进、simulator 英文子列表层级、load_data_2dv2_l12l0 中文代码块列表归属。 - 将 6 个中英文 README 中 12 处 C++ 代码块语言标识统一为 cpp，确保代码高亮标识一致。 - 对 17 个存在对齐问题的中英文对应目录树统一 // 注释列，修复 08_simulator 英文树层级缩进，并将 4 组目录树误用的 ASCII | 统一为 Unicode │。 - 为满足仓库中英文 README 成对修改拦截规则，对 PR 中 34 个原本单边改动的 counterpart 增加不影响 Markdown 渲染的空行，使全部改动 README 成对出现。 - 对齐标题层级、段落与列表、目录树、命令、代码注释、Markdown/HTML 表格、图片、公式、链接和锚点，并清理英文正文中的中文残留。 ## 关联的Issue 无。 ## 测试 已完成以下验证： - git diff --check origin/master...HEAD：通过。 - bash -n scripts/markdown_link_check.sh：通过。 - bash scripts/markdown_link_check.sh --full：通过，共检查 3953 个 Markdown 文件。 - README 配对检查：388 组，中文或英文单边缺失均为 0。 - 双语渲染结构检查：388 组的标题、表格、代码块、列表及嵌套关系差异均为 0。 - 全量 Markdown 格式检查：776 个 README、1770 个 Markdown 表格、4068 个 fenced code block；表格缩进、代码围栏闭合/缩进及非规范 C++ 语言标识问题均为 0。 - 目录树专项检查：278 个带注释的中英文对应目录树块；注释列不一致、短层级缩进和 ASCII 树线残留均为 0。 - 成对修改检查：186 个改动 README，组成 93 对；单边改动为 0；34 个补位 README 的渲染 HTML 变化为 0。 - 链接精确转换检查：70 个 README、420 条链接、28 个锚点，非链接正文改动为 0，目标错误为 0。 - examples 中同仓 docs HTTPS 链接残留检查：0 条。 - 链接策略红绿验证：同仓 HTTPS 链接会被拒绝并给出相对路径，原有 docs/api 与 docs/guide 跨区约束仍生效。 - 提交前检查：OAT Compliance Check 和 Markdown link check 均通过。 ## 文档更新 更新 examples 下 186 个 README 文件（93 个英文、93 个中文）及 scripts/markdown_link_check.sh，使双语文档严格对齐、翻译准确，统一同仓文档链接规范，并修复表格、代码块和列表的渲染格式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4370 | 1 个月前 | |
【样例】更新01_simd_cpp_api下样例目录结构 Co-authored-by: wx369<wangxu243@huawei.com> # message auto-generated for no-merge-commit merge: !3131 merge master into master 【样例】更新01_simd_cpp_api下样例目录结构 Created-by: wx369 Commit-by: wx369 Merged-by: cann-robot Description: ## 描述 更新01_simd_cpp_api下样例目录结构 ## 关联的Issue 关联Issue [#896](https://gitcode.com/cann/asc-devkit/issues/896) ## 测试 通过了样例的编译运行 ## 文档更新 NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [x] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!3131 | 2 个月前 | |
【样例】更新01_simd_cpp_api下样例目录结构 Co-authored-by: wx369<wangxu243@huawei.com> # message auto-generated for no-merge-commit merge: !3131 merge master into master 【样例】更新01_simd_cpp_api下样例目录结构 Created-by: wx369 Commit-by: wx369 Merged-by: cann-robot Description: ## 描述 更新01_simd_cpp_api下样例目录结构 ## 关联的Issue 关联Issue [#896](https://gitcode.com/cann/asc-devkit/issues/896) ## 测试 通过了样例的编译运行 ## 文档更新 NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [x] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!3131 | 2 个月前 |
样例列表
| 目录名称 | 功能描述 |
|---|---|
| 00_introduction | 基于Ascend C的简单示例，通过Ascend C编程语言实现自定义功能，分别给出对应的<<<>>>直调实现 |
| 01_utilities | 基于Ascend C的简单样例，通过printf、assert、DumpTensor等API介绍上板打印、异常检测、CPU孪生调试等系统工具使用方法，适用于调试阶段 |
| 02_features | 基于Ascend C特性样例，介绍了Aclnn（ge入图）工程、LocalMemAllocator、Barrier单独内存申请分配等特性 |
| 03_basic_api | 基于Ascend C基础API样例，介绍了数据搬运、计算等基础API的使用方法 |
| 04_advanced_api | 基于Ascend C API类库的使用样例，通过<<<>>>直调的实现方式，介绍了数学库、激活函数等API类库 |
| 05_best_practices | 基于Ascend C的性能优化实践，聚焦于关键计算与内存访问的调优，旨在提升在Ascend平台上的运行效率 |
| 06_compatibility_guide | 针对不兼容的特性，提供兼容性样例 |