| docs(aclnn): 修正 GroupNormSiluQuant/GroupNormSilu 与 scatter 四算子的资料与实现不一致项 Co-authored-by: tangpingchuan<tangpingchuan@huawei.com> # message auto-generated for no-merge-commit merge: !9399 merge fix/aclnn-doc-support-scope into master docs(aclnn): 修正 GroupNormSiluQuant/GroupNormSilu 与 scatter 四算子的资料与实现不一致项 Created-by: zl_hw Commit-by: tangpingchuan Merged-by: cann-robot Description: ## 描述 三类「资料与实现不符」的订正，来源于测试反馈的资料核对。**不改动任何算子实现**，唯一的非文档改动是补了 2 条 tiling 边界 UT。 **一、GroupNormSiluQuant / GroupNormSilu：输出 Tensor 的「非连续Tensor」列标注与实现不符** aclnnGroupNormSiluQuant 的 out / meanOut / rstdOut 三行在 docs 中标 -（未标注）、在 README 中标 x（不支持）；aclnnGroupNormSilu 的同三行标 x。而三者的 op_api 实现中每个输出均经 l0op::ViewCopy 写回（空 Tensor 分支的 FillScalar 同样经 ViewCopy），即支持非连续输出。三处统一改为 √。 **二、GroupNormSiluQuant：空 Tensor 支持范围声明过宽** docs 与 README 原文为「支持空Tensor（任意维度为0）」。实现自首版 5d36b373b 起，CheckAttr 即拒收 N（第 0 维）或 C（第 1 维）为 0 的输入并返回 161002。表述收窄为「支持空Tensor：N（第0维）与C（第1维）需大于0，其余维度可为0」，填充行为（out 为空、meanOut 填 0、rstdOut 填 NAN）与原描述一致，保留不变。 **三、ScatterMin / ScatterMax / ScatterMul / ScatterDiv：aclnn 资料缺少 varRef 首维上限约束** 四个算子共用 scatter_reduce_common tiling，其中 varFirstDim > INT32_MAX 即拒收——并行归并排序以 INT32_MAX 作为补齐哨兵，首维再大将使合法索引与哨兵不可区分。该约束已在四个算子的 README「约束说明」中声明（2e6678836，与实现同笔提交），但四篇 aclnn 资料的「约束说明」节遗漏，本次补入「varRef的首维大小不超过INT32_MAX。」。 **四、补齐 ScatterMin tiling 的边界用例** 既有 4 条 tiling UT 均为常规规模，未覆盖 INT32_MAX 边界。新增两条：首维 = INT32_MAX 期望接受、= INT32_MAX + 1 期望拒收。 ## 关联的Issue 关联Issue #5270 —— https://gitcode.com/cann/ops-nn/issues/5270 ## 测试 **1. Host UT** bash build.sh -u --ophost --ops=scatter_min --soc=ascend950 ScatterMinTiling 共 9 条用例全部通过（原 4 条 + 本次新增 2 条 + 其余 3 条），含新增的 test_tiling_var_dim0_eq_int32max（期望 GRAPH_SUCCESS）与 test_tiling_var_dim0_over_int32max（期望拒收）。 **2. Ascend 950PR 真机实测（CANN 9.2.0 发布包内置 kernel）** - 非连续输出：为 aclnnGroupNormSiluQuant 与 aclnnGroupNormSilu 构造末维 stride=2 的非连续输出，结果均与全连续基线逐元素一致；并在 storage 空隙中预置哨兵值，跑完检查未被改写，确认是按 stride 散射写入而非连续覆盖。 - 空 Tensor 逐轴：N=0、C=0 被拒收并返回 161002；H=0、W=0 通过，meanOut 填 0、rstdOut 填 NAN。 ## 文档更新 更新了 7 篇资料，均只改与实现不符的字段，不涉及接口与行为变更： - norm/group_norm_silu_quant/docs/aclnnGroupNormSiluQuant.md（非连续标记 ×3、空 Tensor 范围） - norm/group_norm_silu_quant/README.md（非连续标记 ×3、空 Tensor 范围） - norm/group_norm_silu/docs/aclnnGroupNormSilu.md（非连续标记 ×3） - index/scatter_min/docs/aclnnScatterMin.md、index/scatter_max/docs/aclnnScatterMax.md、index/scatter_mul/docs/aclnnScatterMul.md、index/scatter_div/docs/aclnnScatterDiv.md（各补 1 条首维约束） ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： ## AI/Agent生成声明 <!-- [x] 表示选中 --> - [x] AI辅助编写 See merge request: cann/ops-nn!9399 | 12 天前 |
