| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
docs: 修复AIDD文档质量扫描报告中的语义与示例问题 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !163 merge docs/fix-aidd-report-issues into master docs: 修复AIDD文档质量扫描报告中的语义与示例问题 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 本 PR 修复 AIDD 文档质量扫描报告中的**语义与示例问题**（函数签名、公式、参数/返回值/支持范围、示例可运行性、文档自相矛盾），13 个文件，**纯文档改动，不涉及任何 .py**。 原 PR 里的纯格式改动（术语大小写、错别字、Markdown 格式、中英文之间的空格）已拆到 #183，本 PR 不再包含格式改动。 **首轮改动范围（13 个文件）** - **函数签名与导入路径**：add_rms_norm_bias 更正为实际接口 npu_add_rms_norm_bias；chunk_gate_delta_rule 更正为 chunk_gated_delta_rule - **公式修正**：mhc_post 的 bmm2 与反向公式索引方向修正，与内部前向 permute(0, 1, 3, 2) 的实现一致 - **变量名与示例可运行性**：x_triton 更正为 x、gamma 更正为 norm_gamma、model 更正为 rms_norm_gated；fused_cross_entropy_loss 示例补充 dtype/device 定义，示例不再报 NameError - **参数、返回值与支持范围**：alpha_chunks 接口无默认值、需显式传参；probs 仅 moe_sort_chunks_by_index_with_probs 使用；fused_cross_entropy_loss 返回值为标量；chunk_gated_delta_rule 反向子步骤由 5 更正为 7；recompute_w_u_fwd 补充 arch32/arch35 架构代号说明 - **数据修正**：clipped_swiglu 性能表删除单位失实的 bw(GB/s) 列（该列数值实为 MB/s，标 GB/s 意味着约 109 TB/s，远超 HBM 带宽） **第二轮（收尾修正）**——对首轮改动逐条做源码复核时，发现同批文件内仍有同类问题，一并修正： - **示例可运行性**：add_rms_norm_bias 的 3 个示例与 rmsnorm_without_weight 的示例补齐 NPU device/dtype。算子仅在 PrivateUse1（NPU）后端注册（mindspeed_ops/csrc/torch_binding.cpp:59），CPU 张量必然报 Could not run ... with arguments from the CPU backend；sinkhorn 示例补齐 dtype/device 并改用已定义变量（原先引用了 5 个未定义名字） - **函数签名**：chunk_gated_delta_rule 的**全部 15 处算子调用**逐条按源码签名核对后统一改为关键字调用。其中 2 处是真实错位：chunk_bwd_dv_local(q, k, g, do, scale) 的 g/do 位置互换（真实签名为 (q, k, do, g, ...)）、chunk_gated_delta_rule_bwd_dhu(q, k, w, g, h0, dht, do, dv, scale) 自第 4 个参数起全部错位（真实签名为 (q, k, w, do, dv, g, gk, h0, dht, scale, ...)）；prepare_wy_repr_bwd 的 du 参数名与 du=dv 映射也在正文中写明。其余 13 处改为关键字式以消除"位置参数是否写对"的歧义（已逐个用 AST 校验：关键字名存在于真实签名且顺序递增，arch32/arch35 两套实现均适用） - **支持范围与参数**：cumsum 的 arch35 支持与 4 维分发（原"arch35 暂不支持"与源码 api/triton/cumsum.py:150-160 直接矛盾）；rmsnormgated 的 bias（源码为必传参数且支持非 None，原文"固定为 None"有误）、输出 dtype、residual_in_fp32 作用范围、arch35 支持（原文"不支持arch35"有误，并补上 arch35 的 D 上限约束）；chunk_gated_delta_rule 的 head_first（弃用仅告警，非"仅支持 False"）；sinkhorn 的 mixes 支持 dtype 与 sinkhorn_iters；clipped_swiglu 的 swiglu_limit 非负约束；mhc_pre_only 的 eps 数据类型 - **文档自相矛盾与缺项**：recompute_w_u_fwd 统一"前向/反向"口径；cumsum 参数说明表补 chunk_indices 行；mhc_post 的 h_res 排列约定由 3 处重复收敛为 1 处权威说明，明确"公式采用用户输入排列、源码内部先 permute(0,1,3,2)" **文件清单**：docs/zh/aclnn/add_rms_norm_bias.md、docs/zh/catlass/chunk_loss.md、docs/zh/triton/chunk_gated_delta_rule.md、docs/zh/triton/clipped_swiglu.md、docs/zh/triton/cumsum.md、docs/zh/triton/fused_cross_entropy_loss.md、docs/zh/triton/mhc_post.md、docs/zh/triton/mhc_pre_only.md、docs/zh/triton/recompute_w_u_fwd.md、docs/zh/triton/rmsnorm_without_weight.md、docs/zh/triton/rmsnormgated.md、docs/zh/triton/sinkhorn.md、docs/zh/triton/sort_chunks_by_idx.md **与 #183 的关系**：#183 是本 PR 拆出的格式部分。两者改动行基本不重叠，任一方先合入后，另一方按页面提示变基即可。 ## Does this PR introduce any user-facing change? 无代码接口与算子行为变更，均为文档/示例与实际实现对齐的修正。其中文档描述的支持范围、参数与返回值有更正，以仓内实际实现为准。 ## How was this patch tested? - 逐条对照 mindspeed_ops/ 实际实现核实函数签名、公式、返回值与支持范围（含 arch32/triton/、arch35/triton/、api/triton/、csrc/）； - 公式类改动做了双路验证：内核推导 + UT 参考实现（如 tests/unit_tests/triton/test_mhc_post.py）交叉确认； - 示例可运行性：补齐 device/dtype、修正未定义变量后，示例不再报 NameError 与 CPU/NPU 后端不匹配错误； - 逐条与 #183 的改动做对照：两个 PR 的并集即原 #163 的全部改动，且每条改动只落在其中一个 PR； - 结构与格式自检：13 个文件 53 张表列数一致、git diff --check 干净、无新增中英文空格、无失效链接； - 纯文档改动，无功能逻辑；文档门禁（markdownlint、链接有效性等）由 CI 验证。 ## 已知遗留项（源码侧 docstring，本 PR 有意不修） 以下为**源码文件内**的 docstring 表述过时/有误，属于代码侧文档，修改它们会使本 PR 变为非纯文档改动（Detect_file_changes 判定 non-doc 后会触发 4 个 NPU UT 分片），故本 PR 不改，留待单独的源码清理： - mindspeed_ops/api/triton/sinkhorn.py:23 与 :59 仍写 optimized for GPU performance / with GPU optimization（本仓实现面向昇腾 NPU）； - mindspeed_ops/api/triton/fused_cross_entropy_loss.py:25 仍写 loss: Output tensor with shape [bs * seq_len]，而实际 return out.sum() 为 0 维标量； - mindspeed_ops/api/catlass/chunk_loss.py:107-112 的 docstring 写 "Atlas A3 BF16"，而 csrc/catlass/chunk_loss/chunk_loss_torch.cpp:99 同时允许 Ascend910B(A2) 与 Ascend910_93(A3)。 ## 另一项待确认（源码行为本身存疑，不宜由文档单方面"写死"） docs/zh/triton/chunk_gated_delta_rule.md 把 initial_state 描述为可用入参（含形状 [N, H, K, V]），但 mindspeed_ops/api/triton/chunk_gated_delta_rule.py:329-330 对任何非 None 的 initial_state 都无条件抛出 ValueError("The chunk_gated_delta_rule_fwd_h does not support initial_state.")。 这一条**未在本 PR 修改**：目前无法判断该限制是有意收窄（那文档应改，且需同步改函数签名段与参数表）、还是临时/缺陷（那应改代码）。本 PR 不替源码单方面背书，留待源码侧确认后单独处理。 See merge request: Ascend/MindSpeed-Ops!163 | 1 个月前 | |
docs(atb): add custom operator development guide Co-authored-by: Liz<lizhi166@huawei.com> # message auto-generated for no-merge-commit merge: !185 merge master into master docs(atb): add custom operator development guide Created-by: Liz_ Commit-by: Liz Merged-by: ascend-robot Description: ## What this PR does / why we need it? add custom operator development guide https://gitcode.com/Ascend/MindSpeed-Ops/issues/80 ## Does this PR introduce any user-facing change? NAN ## How was this patch tested? CI PASSED See merge request: Ascend/MindSpeed-Ops!185 | 1 个月前 | |
docs: 修复AIDD文档质量扫描报告中的语义与示例问题 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !163 merge docs/fix-aidd-report-issues into master docs: 修复AIDD文档质量扫描报告中的语义与示例问题 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 本 PR 修复 AIDD 文档质量扫描报告中的**语义与示例问题**（函数签名、公式、参数/返回值/支持范围、示例可运行性、文档自相矛盾），13 个文件，**纯文档改动，不涉及任何 .py**。 原 PR 里的纯格式改动（术语大小写、错别字、Markdown 格式、中英文之间的空格）已拆到 #183，本 PR 不再包含格式改动。 **首轮改动范围（13 个文件）** - **函数签名与导入路径**：add_rms_norm_bias 更正为实际接口 npu_add_rms_norm_bias；chunk_gate_delta_rule 更正为 chunk_gated_delta_rule - **公式修正**：mhc_post 的 bmm2 与反向公式索引方向修正，与内部前向 permute(0, 1, 3, 2) 的实现一致 - **变量名与示例可运行性**：x_triton 更正为 x、gamma 更正为 norm_gamma、model 更正为 rms_norm_gated；fused_cross_entropy_loss 示例补充 dtype/device 定义，示例不再报 NameError - **参数、返回值与支持范围**：alpha_chunks 接口无默认值、需显式传参；probs 仅 moe_sort_chunks_by_index_with_probs 使用；fused_cross_entropy_loss 返回值为标量；chunk_gated_delta_rule 反向子步骤由 5 更正为 7；recompute_w_u_fwd 补充 arch32/arch35 架构代号说明 - **数据修正**：clipped_swiglu 性能表删除单位失实的 bw(GB/s) 列（该列数值实为 MB/s，标 GB/s 意味着约 109 TB/s，远超 HBM 带宽） **第二轮（收尾修正）**——对首轮改动逐条做源码复核时，发现同批文件内仍有同类问题，一并修正： - **示例可运行性**：add_rms_norm_bias 的 3 个示例与 rmsnorm_without_weight 的示例补齐 NPU device/dtype。算子仅在 PrivateUse1（NPU）后端注册（mindspeed_ops/csrc/torch_binding.cpp:59），CPU 张量必然报 Could not run ... with arguments from the CPU backend；sinkhorn 示例补齐 dtype/device 并改用已定义变量（原先引用了 5 个未定义名字） - **函数签名**：chunk_gated_delta_rule 的**全部 15 处算子调用**逐条按源码签名核对后统一改为关键字调用。其中 2 处是真实错位：chunk_bwd_dv_local(q, k, g, do, scale) 的 g/do 位置互换（真实签名为 (q, k, do, g, ...)）、chunk_gated_delta_rule_bwd_dhu(q, k, w, g, h0, dht, do, dv, scale) 自第 4 个参数起全部错位（真实签名为 (q, k, w, do, dv, g, gk, h0, dht, scale, ...)）；prepare_wy_repr_bwd 的 du 参数名与 du=dv 映射也在正文中写明。其余 13 处改为关键字式以消除"位置参数是否写对"的歧义（已逐个用 AST 校验：关键字名存在于真实签名且顺序递增，arch32/arch35 两套实现均适用） - **支持范围与参数**：cumsum 的 arch35 支持与 4 维分发（原"arch35 暂不支持"与源码 api/triton/cumsum.py:150-160 直接矛盾）；rmsnormgated 的 bias（源码为必传参数且支持非 None，原文"固定为 None"有误）、输出 dtype、residual_in_fp32 作用范围、arch35 支持（原文"不支持arch35"有误，并补上 arch35 的 D 上限约束）；chunk_gated_delta_rule 的 head_first（弃用仅告警，非"仅支持 False"）；sinkhorn 的 mixes 支持 dtype 与 sinkhorn_iters；clipped_swiglu 的 swiglu_limit 非负约束；mhc_pre_only 的 eps 数据类型 - **文档自相矛盾与缺项**：recompute_w_u_fwd 统一"前向/反向"口径；cumsum 参数说明表补 chunk_indices 行；mhc_post 的 h_res 排列约定由 3 处重复收敛为 1 处权威说明，明确"公式采用用户输入排列、源码内部先 permute(0,1,3,2)" **文件清单**：docs/zh/aclnn/add_rms_norm_bias.md、docs/zh/catlass/chunk_loss.md、docs/zh/triton/chunk_gated_delta_rule.md、docs/zh/triton/clipped_swiglu.md、docs/zh/triton/cumsum.md、docs/zh/triton/fused_cross_entropy_loss.md、docs/zh/triton/mhc_post.md、docs/zh/triton/mhc_pre_only.md、docs/zh/triton/recompute_w_u_fwd.md、docs/zh/triton/rmsnorm_without_weight.md、docs/zh/triton/rmsnormgated.md、docs/zh/triton/sinkhorn.md、docs/zh/triton/sort_chunks_by_idx.md **与 #183 的关系**：#183 是本 PR 拆出的格式部分。两者改动行基本不重叠，任一方先合入后，另一方按页面提示变基即可。 ## Does this PR introduce any user-facing change? 无代码接口与算子行为变更，均为文档/示例与实际实现对齐的修正。其中文档描述的支持范围、参数与返回值有更正，以仓内实际实现为准。 ## How was this patch tested? - 逐条对照 mindspeed_ops/ 实际实现核实函数签名、公式、返回值与支持范围（含 arch32/triton/、arch35/triton/、api/triton/、csrc/）； - 公式类改动做了双路验证：内核推导 + UT 参考实现（如 tests/unit_tests/triton/test_mhc_post.py）交叉确认； - 示例可运行性：补齐 device/dtype、修正未定义变量后，示例不再报 NameError 与 CPU/NPU 后端不匹配错误； - 逐条与 #183 的改动做对照：两个 PR 的并集即原 #163 的全部改动，且每条改动只落在其中一个 PR； - 结构与格式自检：13 个文件 53 张表列数一致、git diff --check 干净、无新增中英文空格、无失效链接； - 纯文档改动，无功能逻辑；文档门禁（markdownlint、链接有效性等）由 CI 验证。 ## 已知遗留项（源码侧 docstring，本 PR 有意不修） 以下为**源码文件内**的 docstring 表述过时/有误，属于代码侧文档，修改它们会使本 PR 变为非纯文档改动（Detect_file_changes 判定 non-doc 后会触发 4 个 NPU UT 分片），故本 PR 不改，留待单独的源码清理： - mindspeed_ops/api/triton/sinkhorn.py:23 与 :59 仍写 optimized for GPU performance / with GPU optimization（本仓实现面向昇腾 NPU）； - mindspeed_ops/api/triton/fused_cross_entropy_loss.py:25 仍写 loss: Output tensor with shape [bs * seq_len]，而实际 return out.sum() 为 0 维标量； - mindspeed_ops/api/catlass/chunk_loss.py:107-112 的 docstring 写 "Atlas A3 BF16"，而 csrc/catlass/chunk_loss/chunk_loss_torch.cpp:99 同时允许 Ascend910B(A2) 与 Ascend910_93(A3)。 ## 另一项待确认（源码行为本身存疑，不宜由文档单方面"写死"） docs/zh/triton/chunk_gated_delta_rule.md 把 initial_state 描述为可用入参（含形状 [N, H, K, V]），但 mindspeed_ops/api/triton/chunk_gated_delta_rule.py:329-330 对任何非 None 的 initial_state 都无条件抛出 ValueError("The chunk_gated_delta_rule_fwd_h does not support initial_state.")。 这一条**未在本 PR 修改**：目前无法判断该限制是有意收窄（那文档应改，且需同步改函数签名段与参数表）、还是临时/缺陷（那应改代码）。本 PR 不替源码单方面背书，留待源码侧确认后单独处理。 See merge request: Ascend/MindSpeed-Ops!163 | 1 个月前 | |
docs: 架构图补充ATB后端，接口层ATB条目并入ACLNN Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !184 merge docs/update-arch-diagram-atb into master docs: 架构图补充ATB后端，接口层ATB条目并入ACLNN Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 架构图补齐ATB后端，并使接口层说明与之一致。 - 背景：ATB后端已随#182合入主线，但架构图仍是三后端版本的旧图（ docs/zh/figures/mindspeed_ops_arch_v2.png）。 - 架构图：后端层ACLNN标签补充ATB，与CATLASS同处一格（ACLNN（AscendC/CATLASS/ATB））；不新增方框，版式与幻灯片尺寸保持原样。 - docs/zh/introduction.md算子接口层：删除单独的"ATB算子接口"条目，与CATLASS一致归入ACLNN；子包列表同步由四个调整为api/triton、api/tilelang、api/aclnn三个。 - 架构图由mindspeed_ops_arch_v2.png更新为mindspeed_ops_arch.png，并移至"MindSpeed Ops架构"章节末尾、显示宽度调整为60%；旧图已无其他引用，随本PR删除。 ## Does this PR introduce any user-facing change? 仅文档与架构图变更，无接口或行为变更；mindspeed_ops/api/atb等代码路径与docs/zh/supported_operators.md中的后端清单均未改动。 - docs/zh/introduction.md - docs/zh/figures/mindspeed_ops_arch.png（新增） - docs/zh/figures/mindspeed_ops_arch_v2.png（删除） ## How was this patch tested? - 架构图由可编辑源导出，中文使用方正兰亭黑简体、英文使用Huawei Sans；逐字校验渲染字形（昇字行墨量指纹与旧图一致），新增标签实测位于框内且与相邻标签无重叠。 - 导出按幻灯片宽高比生成以避免纵向拉伸，裁切区域按图形并集自动计算。 - 文档门禁与代码门禁按仓库流程触发。 See merge request: Ascend/MindSpeed-Ops!184 | 1 个月前 | |
docs: 修改AIDD扫描问题 Co-authored-by: f60123591<fanghui49@h-partners.com> # message auto-generated for no-merge-commit merge: !149 merge master into master docs: 修改AIDD扫描问题 Created-by: chic666 Commit-by: f60123591 Merged-by: ascend-robot Description: ## What this PR does / why we need it? Please describe the background and detailed changes of the PR. If it is a bugfix, please attach the related issue. ## Does this PR introduce any user-facing change? 修改AIDD扫描问题 ## How was this patch tested? Please explain how to verify the correctness and effectiveness of this feature, as well as its usage constraints and limitations. See merge request: Ascend/MindSpeed-Ops!149 | 1 个月前 | |
docs: 统一专有名词大小写与文档格式 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !183 merge docs/fix-aidd-format into master docs: 统一专有名词大小写与文档格式 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 本 PR 是从 #163 中拆出的**纯格式改动**，不改变任何技术含义；#163 之后只保留语义/代码类修正（另见 #163 更新后的描述）。 **改动范围（20 个文件）** - **专有名词大小写统一**：Triton / NPU / CPU / PyTorch / Ascend / FP32 / AI Core / Vector Core / RMS Norm / Triton-Ascend - **错别字与译名**：仓上→仓库中、每个行→每一行、做任务总数→作为任务总数、ASLR 译名去掉冗余的“全随机”、 exec→executed、>=Python3.10→>=3.10 - **冗余表述与病句**：去掉“FP32 精度”里重复的“精度”、修正“执行加法操作”等复制粘贴残留注释、去掉重复的“Triton 下发” - **Markdown 格式**：参数表中 scalar 补行内代码、docstring 缩进修正、清掉空行上的行尾空格 **中英文之间不加空格** #163 新增的 fp16 与 bf16、仅在 arch32 架构上为可选输入、仅在 arch35 架构上生效、执行 Sinkhorn 算子、执行 rmsnorm 归一化计算 等中英文空格已全部改回无空格写法；本次新增的文字也一律不在中英文之间加空格。全仓存量的空格清理由 #176 统一处理，本 PR 只覆盖 #163 触达的行，避免与 #176 大面积重叠。 **文件清单**：docs/zh/SECURITYNOTE.md、install_guide.md、introduction.md、ops.md、quick_start_ops.md、release_notes_ops.md、tilelang/sinkhorn.md、triton/causal_conv1d.md、triton/chunk_gated_delta_rule.md、triton/chunk_kda_fwd_intra.md、triton/clipped_swiglu.md、triton/fused_cross_entropy_loss.md、triton/l2norm.md、triton/mhc_post.md、triton/mhc_pre_bmm.md、triton/mhc_pre_only.md、triton/recompute_w_u_fwd.md、triton/rmsnorm_without_weight.md、triton/sinkhorn.md、triton/solve_tril.md ## Does this PR introduce any user-facing change? 无。仅统一文档的术语书写与 Markdown 格式，不涉及接口、算子行为、示例语义的任何变更。 ## How was this patch tested? - 本地对全部 20 个改动文件执行 markdownlint --config .markdownlint.yaml，0 问题； - 逐条与 #163 的改动做对照：本 PR 与 #163（语义部分）的并集即原 #163 的全部改动，且每条改动只落在其中一个 PR； - 脚本校验改动行相对 master 未新增任何中英文之间的空格（中英文空格计数不增加）； - 纯文档改动，无功能逻辑，可运行性验证见 #163。 See merge request: Ascend/MindSpeed-Ops!183 | 1 个月前 | |
feat: 新增chunk_kda_fwd_intra的A5特性适配 Co-authored-by: Sousuk<251028619@qq.com> # message auto-generated for no-merge-commit merge: !186 merge master into master feat: 新增chunk_kda_fwd_intra的A5特性适配 Created-by: Sousuk Commit-by: Sousuk Merged-by: ascend-robot Description: ## What this PR does / why we need it? 新增chunk_kda_fwd_intra的arch35实现，以及API调用路由 ## Does this PR introduce any user-facing change? no ## How was this patch tested? 可运行chunk_kda_fwd_intra的ut测试或atk测试进行测试。 See merge request: Ascend/MindSpeed-Ops!186 | 1 个月前 | |
docs: 新增docs/zh中文文档（简介/软件安装/快速入门/算子清单/版本说明/安全声明） Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !147 merge docs/add-zh-docs-v2 into master docs: 新增docs/zh中文文档（简介/软件安装/快速入门/算子清单/版本说明/安全声明） Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 参考 MindSpeed-LLM docs/zh 的文档结构，为 MindSpeed-Ops 新增中文文档目录 docs/zh，包含六篇主文档： - 简介（introduction.md）：产品定位、三层软件架构（api接口层/arch32-arch35架构适配层/csrc原生算子层）、功能特性与典型应用场景 - 软件安装（install_guide.md）：硬件配套表、依赖软件安装指南、镜像安装与源码安装（含 SOC_VERSION、TileLang-Ascend 可选安装）、安装验证 - 快速入门（quick_start.md）：安装验证、FusedCrossEntropyLoss（Triton）与 AddRmsNormBias（ACLNN）算子上手示例、单元测试运行方法 - 算子清单（supported_operators.md）：按 Triton/TileLang/ACLNN 三类后端汇总全部算子及源码/文档链接 - 版本说明（release_notes.md）：产品版本信息、版本配套表、分支维护策略、已知问题 - 安全声明（SECURITYNOTE.md）：系统安全、公网地址声明（基于代码扫描）、公开接口声明等 同时将存量文档统一收录进 docs/zh（git rename 保留历史）： - docs/ops.md → docs/zh/ops.md（算子开发及合入说明） - docs/triton/、docs/tilelang/、docs/aclnn/、docs/qa/ → docs/zh/ 对应子目录 - 新合入 master 的 docs/triton/custom_triton_operator_guide.md、docs/catlass/（chunk_loss.md、custom_catlass_operator_guide.md）一并迁入 docs/zh - 同步更新 README.md、文档导航（docs/zh/_menu.md）及迁移文档中的相对链接 ## Does this PR introduce any user-facing change? 仅文档变更，无代码改动：新增 docs/zh 中文文档目录；原 docs/ 下算子文档路径变更为 docs/zh/ 对应路径（README 与内部链接已同步）。 ## How was this patch tested? - 文档变更；相对链接已全量校验（README + docs/zh 全部 md，含锚点链接），无失效链接 - 与最新 master（fe01feb）无冲突，README 自动合并结果已人工核对 - 文档内容基于仓内代码事实核实（版本配套、安装命令、目录结构、算子清单均与代码一致） See merge request: Ascend/MindSpeed-Ops!147 | 1 个月前 | |
docs: 统一专有名词大小写与文档格式 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !183 merge docs/fix-aidd-format into master docs: 统一专有名词大小写与文档格式 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 本 PR 是从 #163 中拆出的**纯格式改动**，不改变任何技术含义；#163 之后只保留语义/代码类修正（另见 #163 更新后的描述）。 **改动范围（20 个文件）** - **专有名词大小写统一**：Triton / NPU / CPU / PyTorch / Ascend / FP32 / AI Core / Vector Core / RMS Norm / Triton-Ascend - **错别字与译名**：仓上→仓库中、每个行→每一行、做任务总数→作为任务总数、ASLR 译名去掉冗余的“全随机”、 exec→executed、>=Python3.10→>=3.10 - **冗余表述与病句**：去掉“FP32 精度”里重复的“精度”、修正“执行加法操作”等复制粘贴残留注释、去掉重复的“Triton 下发” - **Markdown 格式**：参数表中 scalar 补行内代码、docstring 缩进修正、清掉空行上的行尾空格 **中英文之间不加空格** #163 新增的 fp16 与 bf16、仅在 arch32 架构上为可选输入、仅在 arch35 架构上生效、执行 Sinkhorn 算子、执行 rmsnorm 归一化计算 等中英文空格已全部改回无空格写法；本次新增的文字也一律不在中英文之间加空格。全仓存量的空格清理由 #176 统一处理，本 PR 只覆盖 #163 触达的行，避免与 #176 大面积重叠。 **文件清单**：docs/zh/SECURITYNOTE.md、install_guide.md、introduction.md、ops.md、quick_start_ops.md、release_notes_ops.md、tilelang/sinkhorn.md、triton/causal_conv1d.md、triton/chunk_gated_delta_rule.md、triton/chunk_kda_fwd_intra.md、triton/clipped_swiglu.md、triton/fused_cross_entropy_loss.md、triton/l2norm.md、triton/mhc_post.md、triton/mhc_pre_bmm.md、triton/mhc_pre_only.md、triton/recompute_w_u_fwd.md、triton/rmsnorm_without_weight.md、triton/sinkhorn.md、triton/solve_tril.md ## Does this PR introduce any user-facing change? 无。仅统一文档的术语书写与 Markdown 格式，不涉及接口、算子行为、示例语义的任何变更。 ## How was this patch tested? - 本地对全部 20 个改动文件执行 markdownlint --config .markdownlint.yaml，0 问题； - 逐条与 #163 的改动做对照：本 PR 与 #163（语义部分）的并集即原 #163 的全部改动，且每条改动只落在其中一个 PR； - 脚本校验改动行相对 master 未新增任何中英文之间的空格（中英文空格计数不增加）； - 纯文档改动，无功能逻辑，可运行性验证见 #163。 See merge request: Ascend/MindSpeed-Ops!183 | 1 个月前 | |
docs(atb): add custom operator development guide Co-authored-by: Liz<lizhi166@huawei.com> # message auto-generated for no-merge-commit merge: !185 merge master into master docs(atb): add custom operator development guide Created-by: Liz_ Commit-by: Liz Merged-by: ascend-robot Description: ## What this PR does / why we need it? add custom operator development guide https://gitcode.com/Ascend/MindSpeed-Ops/issues/80 ## Does this PR introduce any user-facing change? NAN ## How was this patch tested? CI PASSED See merge request: Ascend/MindSpeed-Ops!185 | 1 个月前 | |
docs: 统一专有名词大小写与文档格式 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !183 merge docs/fix-aidd-format into master docs: 统一专有名词大小写与文档格式 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 本 PR 是从 #163 中拆出的**纯格式改动**，不改变任何技术含义；#163 之后只保留语义/代码类修正（另见 #163 更新后的描述）。 **改动范围（20 个文件）** - **专有名词大小写统一**：Triton / NPU / CPU / PyTorch / Ascend / FP32 / AI Core / Vector Core / RMS Norm / Triton-Ascend - **错别字与译名**：仓上→仓库中、每个行→每一行、做任务总数→作为任务总数、ASLR 译名去掉冗余的“全随机”、 exec→executed、>=Python3.10→>=3.10 - **冗余表述与病句**：去掉“FP32 精度”里重复的“精度”、修正“执行加法操作”等复制粘贴残留注释、去掉重复的“Triton 下发” - **Markdown 格式**：参数表中 scalar 补行内代码、docstring 缩进修正、清掉空行上的行尾空格 **中英文之间不加空格** #163 新增的 fp16 与 bf16、仅在 arch32 架构上为可选输入、仅在 arch35 架构上生效、执行 Sinkhorn 算子、执行 rmsnorm 归一化计算 等中英文空格已全部改回无空格写法；本次新增的文字也一律不在中英文之间加空格。全仓存量的空格清理由 #176 统一处理，本 PR 只覆盖 #163 触达的行，避免与 #176 大面积重叠。 **文件清单**：docs/zh/SECURITYNOTE.md、install_guide.md、introduction.md、ops.md、quick_start_ops.md、release_notes_ops.md、tilelang/sinkhorn.md、triton/causal_conv1d.md、triton/chunk_gated_delta_rule.md、triton/chunk_kda_fwd_intra.md、triton/clipped_swiglu.md、triton/fused_cross_entropy_loss.md、triton/l2norm.md、triton/mhc_post.md、triton/mhc_pre_bmm.md、triton/mhc_pre_only.md、triton/recompute_w_u_fwd.md、triton/rmsnorm_without_weight.md、triton/sinkhorn.md、triton/solve_tril.md ## Does this PR introduce any user-facing change? 无。仅统一文档的术语书写与 Markdown 格式，不涉及接口、算子行为、示例语义的任何变更。 ## How was this patch tested? - 本地对全部 20 个改动文件执行 markdownlint --config .markdownlint.yaml，0 问题； - 逐条与 #163 的改动做对照：本 PR 与 #163（语义部分）的并集即原 #163 的全部改动，且每条改动只落在其中一个 PR； - 脚本校验改动行相对 master 未新增任何中英文之间的空格（中英文空格计数不增加）； - 纯文档改动，无功能逻辑，可运行性验证见 #163。 See merge request: Ascend/MindSpeed-Ops!183 | 1 个月前 | |
docs: 架构图补充ATB后端，接口层ATB条目并入ACLNN Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !184 merge docs/update-arch-diagram-atb into master docs: 架构图补充ATB后端，接口层ATB条目并入ACLNN Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 架构图补齐ATB后端，并使接口层说明与之一致。 - 背景：ATB后端已随#182合入主线，但架构图仍是三后端版本的旧图（ docs/zh/figures/mindspeed_ops_arch_v2.png）。 - 架构图：后端层ACLNN标签补充ATB，与CATLASS同处一格（ACLNN（AscendC/CATLASS/ATB））；不新增方框，版式与幻灯片尺寸保持原样。 - docs/zh/introduction.md算子接口层：删除单独的"ATB算子接口"条目，与CATLASS一致归入ACLNN；子包列表同步由四个调整为api/triton、api/tilelang、api/aclnn三个。 - 架构图由mindspeed_ops_arch_v2.png更新为mindspeed_ops_arch.png，并移至"MindSpeed Ops架构"章节末尾、显示宽度调整为60%；旧图已无其他引用，随本PR删除。 ## Does this PR introduce any user-facing change? 仅文档与架构图变更，无接口或行为变更；mindspeed_ops/api/atb等代码路径与docs/zh/supported_operators.md中的后端清单均未改动。 - docs/zh/introduction.md - docs/zh/figures/mindspeed_ops_arch.png（新增） - docs/zh/figures/mindspeed_ops_arch_v2.png（删除） ## How was this patch tested? - 架构图由可编辑源导出，中文使用方正兰亭黑简体、英文使用Huawei Sans；逐字校验渲染字形（昇字行墨量指纹与旧图一致），新增标签实测位于框内且与相邻标签无重叠。 - 导出按幻灯片宽高比生成以避免纵向拉伸，裁切区域按图形并集自动计算。 - 文档门禁与代码门禁按仓库流程触发。 See merge request: Ascend/MindSpeed-Ops!184 | 1 个月前 | |
docs: 统一专有名词大小写与文档格式 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !183 merge docs/fix-aidd-format into master docs: 统一专有名词大小写与文档格式 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 本 PR 是从 #163 中拆出的**纯格式改动**，不改变任何技术含义；#163 之后只保留语义/代码类修正（另见 #163 更新后的描述）。 **改动范围（20 个文件）** - **专有名词大小写统一**：Triton / NPU / CPU / PyTorch / Ascend / FP32 / AI Core / Vector Core / RMS Norm / Triton-Ascend - **错别字与译名**：仓上→仓库中、每个行→每一行、做任务总数→作为任务总数、ASLR 译名去掉冗余的“全随机”、 exec→executed、>=Python3.10→>=3.10 - **冗余表述与病句**：去掉“FP32 精度”里重复的“精度”、修正“执行加法操作”等复制粘贴残留注释、去掉重复的“Triton 下发” - **Markdown 格式**：参数表中 scalar 补行内代码、docstring 缩进修正、清掉空行上的行尾空格 **中英文之间不加空格** #163 新增的 fp16 与 bf16、仅在 arch32 架构上为可选输入、仅在 arch35 架构上生效、执行 Sinkhorn 算子、执行 rmsnorm 归一化计算 等中英文空格已全部改回无空格写法；本次新增的文字也一律不在中英文之间加空格。全仓存量的空格清理由 #176 统一处理，本 PR 只覆盖 #163 触达的行，避免与 #176 大面积重叠。 **文件清单**：docs/zh/SECURITYNOTE.md、install_guide.md、introduction.md、ops.md、quick_start_ops.md、release_notes_ops.md、tilelang/sinkhorn.md、triton/causal_conv1d.md、triton/chunk_gated_delta_rule.md、triton/chunk_kda_fwd_intra.md、triton/clipped_swiglu.md、triton/fused_cross_entropy_loss.md、triton/l2norm.md、triton/mhc_post.md、triton/mhc_pre_bmm.md、triton/mhc_pre_only.md、triton/recompute_w_u_fwd.md、triton/rmsnorm_without_weight.md、triton/sinkhorn.md、triton/solve_tril.md ## Does this PR introduce any user-facing change? 无。仅统一文档的术语书写与 Markdown 格式，不涉及接口、算子行为、示例语义的任何变更。 ## How was this patch tested? - 本地对全部 20 个改动文件执行 markdownlint --config .markdownlint.yaml，0 问题； - 逐条与 #163 的改动做对照：本 PR 与 #163（语义部分）的并集即原 #163 的全部改动，且每条改动只落在其中一个 PR； - 脚本校验改动行相对 master 未新增任何中英文之间的空格（中英文空格计数不增加）； - 纯文档改动，无功能逻辑，可运行性验证见 #163。 See merge request: Ascend/MindSpeed-Ops!183 | 1 个月前 | |
docs: 统一专有名词大小写与文档格式 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !183 merge docs/fix-aidd-format into master docs: 统一专有名词大小写与文档格式 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 本 PR 是从 #163 中拆出的**纯格式改动**，不改变任何技术含义；#163 之后只保留语义/代码类修正（另见 #163 更新后的描述）。 **改动范围（20 个文件）** - **专有名词大小写统一**：Triton / NPU / CPU / PyTorch / Ascend / FP32 / AI Core / Vector Core / RMS Norm / Triton-Ascend - **错别字与译名**：仓上→仓库中、每个行→每一行、做任务总数→作为任务总数、ASLR 译名去掉冗余的“全随机”、 exec→executed、>=Python3.10→>=3.10 - **冗余表述与病句**：去掉“FP32 精度”里重复的“精度”、修正“执行加法操作”等复制粘贴残留注释、去掉重复的“Triton 下发” - **Markdown 格式**：参数表中 scalar 补行内代码、docstring 缩进修正、清掉空行上的行尾空格 **中英文之间不加空格** #163 新增的 fp16 与 bf16、仅在 arch32 架构上为可选输入、仅在 arch35 架构上生效、执行 Sinkhorn 算子、执行 rmsnorm 归一化计算 等中英文空格已全部改回无空格写法；本次新增的文字也一律不在中英文之间加空格。全仓存量的空格清理由 #176 统一处理，本 PR 只覆盖 #163 触达的行，避免与 #176 大面积重叠。 **文件清单**：docs/zh/SECURITYNOTE.md、install_guide.md、introduction.md、ops.md、quick_start_ops.md、release_notes_ops.md、tilelang/sinkhorn.md、triton/causal_conv1d.md、triton/chunk_gated_delta_rule.md、triton/chunk_kda_fwd_intra.md、triton/clipped_swiglu.md、triton/fused_cross_entropy_loss.md、triton/l2norm.md、triton/mhc_post.md、triton/mhc_pre_bmm.md、triton/mhc_pre_only.md、triton/recompute_w_u_fwd.md、triton/rmsnorm_without_weight.md、triton/sinkhorn.md、triton/solve_tril.md ## Does this PR introduce any user-facing change? 无。仅统一文档的术语书写与 Markdown 格式，不涉及接口、算子行为、示例语义的任何变更。 ## How was this patch tested? - 本地对全部 20 个改动文件执行 markdownlint --config .markdownlint.yaml，0 问题； - 逐条与 #163 的改动做对照：本 PR 与 #163（语义部分）的并集即原 #163 的全部改动，且每条改动只落在其中一个 PR； - 脚本校验改动行相对 master 未新增任何中英文之间的空格（中英文空格计数不增加）； - 纯文档改动，无功能逻辑，可运行性验证见 #163。 See merge request: Ascend/MindSpeed-Ops!183 | 1 个月前 | |
docs: 统一专有名词大小写与文档格式 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !183 merge docs/fix-aidd-format into master docs: 统一专有名词大小写与文档格式 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? 本 PR 是从 #163 中拆出的**纯格式改动**，不改变任何技术含义；#163 之后只保留语义/代码类修正（另见 #163 更新后的描述）。 **改动范围（20 个文件）** - **专有名词大小写统一**：Triton / NPU / CPU / PyTorch / Ascend / FP32 / AI Core / Vector Core / RMS Norm / Triton-Ascend - **错别字与译名**：仓上→仓库中、每个行→每一行、做任务总数→作为任务总数、ASLR 译名去掉冗余的“全随机”、 exec→executed、>=Python3.10→>=3.10 - **冗余表述与病句**：去掉“FP32 精度”里重复的“精度”、修正“执行加法操作”等复制粘贴残留注释、去掉重复的“Triton 下发” - **Markdown 格式**：参数表中 scalar 补行内代码、docstring 缩进修正、清掉空行上的行尾空格 **中英文之间不加空格** #163 新增的 fp16 与 bf16、仅在 arch32 架构上为可选输入、仅在 arch35 架构上生效、执行 Sinkhorn 算子、执行 rmsnorm 归一化计算 等中英文空格已全部改回无空格写法；本次新增的文字也一律不在中英文之间加空格。全仓存量的空格清理由 #176 统一处理，本 PR 只覆盖 #163 触达的行，避免与 #176 大面积重叠。 **文件清单**：docs/zh/SECURITYNOTE.md、install_guide.md、introduction.md、ops.md、quick_start_ops.md、release_notes_ops.md、tilelang/sinkhorn.md、triton/causal_conv1d.md、triton/chunk_gated_delta_rule.md、triton/chunk_kda_fwd_intra.md、triton/clipped_swiglu.md、triton/fused_cross_entropy_loss.md、triton/l2norm.md、triton/mhc_post.md、triton/mhc_pre_bmm.md、triton/mhc_pre_only.md、triton/recompute_w_u_fwd.md、triton/rmsnorm_without_weight.md、triton/sinkhorn.md、triton/solve_tril.md ## Does this PR introduce any user-facing change? 无。仅统一文档的术语书写与 Markdown 格式，不涉及接口、算子行为、示例语义的任何变更。 ## How was this patch tested? - 本地对全部 20 个改动文件执行 markdownlint --config .markdownlint.yaml，0 问题； - 逐条与 #163 的改动做对照：本 PR 与 #163（语义部分）的并集即原 #163 的全部改动，且每条改动只落在其中一个 PR； - 脚本校验改动行相对 master 未新增任何中英文之间的空格（中英文空格计数不增加）； - 纯文档改动，无功能逻辑，可运行性验证见 #163。 See merge request: Ascend/MindSpeed-Ops!183 | 1 个月前 | |
docs: 算子清单补充CATLASS后端与chunk_loss算子 Co-authored-by: EliasKaslan<eliaskaslan@outlook.com> # message auto-generated for no-merge-commit merge: !181 merge docs/add-catlass-operators into master docs: 算子清单补充CATLASS后端与chunk_loss算子 Created-by: EliasKaslan Commit-by: EliasKaslan Merged-by: ascend-robot Description: ## What this PR does / why we need it? docs/zh/supported_operators.md的算子清单此前只登记了Triton、TileLang、ACLNN三类后端，缺少CATLASS后端与CATLASS算子，而仓库中CATLASS算子已经实际存在： - 公共算子chunk_loss：接口mindspeed_ops.api.catlass.chunk_loss_forward（mindspeed_ops/api/catlass/__init__.py），说明文档docs/zh/catlass/chunk_loss.md，UTtests/unit_tests/catlass/test_chunk_loss.py，CI由MINDSPEED_BUILD_CATLASS=1覆盖； - 私有验证算子_catlass_basic_matmul：README已说明其“仅用于验证CATLASS基础设施，不是正式公开算子接口”，因此不登记进清单。 docs/zh/catlass/custom_catlass_operator_guide.md本身也要求“在README支持算子清单中登记链接”，此前遗漏。 本次改动： 1. docs/zh/supported_operators.md：概述由“三类”改为“四类”；表1新增CATLASS后端行（默认不编译，需MINDSPEED_BUILD_CATLASS=1）；新增“CATLASS算子”章节与表5，登记chunk_loss的算子描述、调用接口与支持产品（Atlas A2/A3训练系列产品，Ascend 950PR&950DT系列产品暂不支持）；相关说明补充CATLASS约束与私有算子说明。 2. README.md：支持算子清单表格新增catlass列，并登记chunk_loss。 ## Does this PR introduce any user-facing change? 仅文档变更，不涉及算子接口与运行时行为变更。涉及文档：docs/zh/supported_operators.md、README.md。 ## How was this patch tested? 文档变更，无代码测试。本地校验： - markdownlint-cli@0.47.0 --config .markdownlint.yaml README.md docs/zh/supported_operators.md通过（exit 0）； - 新增链接目标均已确认存在（docs/zh/catlass/chunk_loss.md、docs/zh/catlass/custom_catlass_operator_guide.md、../../README.md）； - 清单内容与mindspeed_ops/api/catlass/__init__.py、docs/zh/catlass/chunk_loss.md的支持范围（BF16输入、H与V按16对齐、不满足约束直接报错且不回退PyTorch）逐项核对。 See merge request: Ascend/MindSpeed-Ops!181 | 1 个月前 |
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 |