The current Pull Request has been closed by chenqi317.
变更摘要
本 PR 对 apply_adam_v2 算子进行质量加固,核心围绕 TilingKey 按 rank 分层编码、空张量短路、kernel 侧 NDDMA 多维搬运重写、主机侧校验与错误日志规范化,以及示例代码资源释放修正。改动涉及 op_host(tiling、infershape)、op_kernel(kernel、struct、tiling_data)与 examples 三部分。
主要改动
- TilingKey 按 rank 分层编码: 在
apply_adam_v2_struct.h中新增APPLY_ADAM_V2_RANK8_FP32_ADAM等 Key 4~7 与APPLY_ADAM_V2_RANK8_OFFSET,使 rank<=4 映射到ApplyAdamV2TilingData<4>、rank>4 映射到<8>;apply_adam_v2.cpp通过if constexpr (KEY < APPLY_ADAM_V2_RANK8_OFFSET)选择对应模板并在Process中扣除偏移。 - 空张量短路处理: 在
apply_adam_v2_tiling_arch35.h新增成员is_empty_,RunTiling检测到 var 元素数为 0 时直接返回成功、设置blockDim=1并输出零 tile,跳过 kernel 计算。 - kernel NDDMA 多维搬运重写:
apply_adam_v2_kernel.h中CopyInOne由一维DataCopyPad改为基于AscendC::DataCopy+NdDmaConfig的多维搬运,并区分RANK <= 5(单次 NDDMA)与RANK > 5(外层循环逐块搬运);同时Init中以ndmaStart统一 NDDMA 起始维度。 - 主机侧校验与错误日志规范化: 在
apply_adam_v2_tiling_data.h引入kAdamModeAdam、kAdamModeMbart、kInfApproxThreshold、kGradNormFloor命名常量,tiling 中新增输入 Format 必须为FORMAT_ND的校验,并将多处OP_LOGE替换为OP_LOGE_FOR_INVALID_*结构化宏。 - 可选输入与示例资源修正:
apply_adam_v2_infershape.cpp按GetOptionalInputShape动态判断step_size、max_grad_norm是否参与形状校验;test_geir_apply_adam_v2.cpp在new后增加空指针检查并在构造 Tensor 后delete[]释放内存。


Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.
PR Approval Progress
⚠️ This PR does not yet meet the following requirements:lgtm (requires ≥ 2 person(s) per module)、approve (requires ≥ 1 person(s) per module)
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| */*/README.md | ❌ (0/2)(You can also ask: 胡碧霞, 刘波, 曾娟, 杜慧萍, 上官秦南) | ❌ (0/1)(You can also ask: 杜慧萍, 冯英, 蔡雯雯, 杨露, 陈娇) |
| optim | ❌ (0/2)(You can also ask: 王星, 曾娟, 上官秦南, 陈展熹, 刘波) | ❌ (0/1)(You can also ask: 王星, 苏跃明, 汤平川, 钱泽洪, 陈展熹) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
handsomeRobot_SK, thanks for your pull request. All authors of the commits have signed the CLA. 👍


compile


| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |


您好,pr合入已准备就绪,请尽快联系committer进行检视,谢谢!


触发条件:adam 模式下传入 0 < max_grad_norm < 1 且 global_grad_norm > 1。base 版本文档与标准 Adam 裁剪语义均为 clip_coeff = min(1, max_grad_norm / global_grad_norm),而 kernel 只把 max_grad_norm 当开关(apply_adam_v2_kernel.h:383 判断 maxGradNorm > 0 && globalGradNorm > 1 后直接 clip_coeff = 1/globalGradNorm),其数值完全不参与运算。后果:本 PR 未修实现,而是把 README 口径改成与实现一致,等于用文档消除设计偏差;若 spec/golden 仍为 min 公式则线上数值系统性偏大(如 max=0.5、global=0.8 应为 0.625,实现给出 1.0),且 kernel 对 NaN/Inf 置 1.0 的保护也未写入文档。建议:按 spec 修正 kernel 为 min(1, max/global),或按设计变更流程同步 spec/golden 并在 README 明确标注“实现差异”,同时补充 max_grad_norm≠1 的精度用例。
如已修复请回复说明,我会在确认后把该意见标记为已解决。


触发条件:编译 op_host/apply_adam_v2_infershape.cpp。本文件仅 include log/log.h、register/op_impl_registry.h 以及新加的 op_kernel/arch35/apply_adam_v2_tiling_data.h,而 Ops::Base::ToString 声明在 util/shape_util.h;仓内其余使用该工具函数的 infershape(如 loss/mse_loss、optim/sparse_apply_ftrl)均显式 #include "util/shape_util.h",log/log.h 不提供该声明。后果:该翻译单元报 “Ops 未声明”,op_host 构建以及本 PR 刚加固过安全编译选项的 infershape UT 目标都会编译失败,质量加固分支无法出包。建议:在 log/log.h 之后补 #include "util/shape_util.h",并本地编译 infershape 目标验证。
如已修复请回复说明,我会在确认后把该意见标记为已解决。


触发条件:var 为 0 元素(shape 含 0)且其它输入非法,例如 lr/beta1/epsilon 传了 0 元素张量,或 m/v/grad 与 var 不广播兼容。该“6.5 空 Tensor 早退”插入在 dtype 校验之后、标量 shape 约束(第 7 段)、has_max_grad_norm_/has_step_size_ 探测与 PadAndSqueeze/broadcast 校验之前,命中即 return GRAPH_SUCCESS。后果:非法标量/不兼容形状被当作合法调用接受;而 kernel 的 Process() 即使 0 个 tile 也会无条件执行 *(gmInPtr_[IN_LR]) 等标量 GM 读取(apply_adam_v2_kernel.h:365-369),0 元素标量会造成非法 GM 访问;同时 rank_ 保持 0,一旦后续在空分支外复用会取到错误值。建议:将空 Tensor 早退移到标量校验之后、DoTilingAndSet/PadAndSqueeze 之前(空场景仍需跳过切分以避免 MultiCoreSplit 除零),或至少在空分支内补做标量与可选输入校验。
如已修复请回复说明,我会在确认后把该意见标记为已解决。


注释写“以下三字段仅作 ABI 占位,Host 不写入有效值”,但紧随其后的三个字段是 clipCoeff、hasMaxGradNorm、hasStepSize:其中 hasMaxGradNorm/hasStepSize 由 host 写入有效值(apply_adam_v2_tiling_arch35.cpp:489-490)并被 kernel 用于决定是否读取 max_grad_norm/step_size 以及 mbart 模式下用 lr 兜底(apply_adam_v2_kernel.h:373、392-396),真正的三个占位字段是 clipCoeff/stepSizeVal/lrVal。后果:维护者按注释清理“占位字段”会直接破坏梯度裁剪与 mbart 步长逻辑,且该结构同时是 host/kernel ABI,删除会引入静默错位。建议:把 clipCoeff/stepSizeVal/lrVal 归并到一处并注释为占位字段,hasMaxGradNorm/hasStepSize 单独说明其真实语义。
如已修复请回复说明,我会在确认后把该意见标记为已解决。


本 PR 只给 GenOnesDataFloat32 的 new 补了判空并补了 delete[],同一文件 main() 中 “Session* session = new Session(build_opts);”(第 151 行)仍未做判空,且 “ret = session->AddGraph(...)”(第 154 行)的返回值未检查就无条件打印 AddGraph success。后果:内存不足或图注册失败时示例会静默打印成功结论或空指针解引用,内存与错误处理整改未真正闭环。建议:同批补 Session new 判空与 AddGraph 返回值判断(失败时打印错误、释放 session 并返回 FAILED)。
如已修复请回复说明,我会在确认后把该意见标记为已解决。


这里用 add_executable/add_test 创建独立测试可执行文件,未接入仓内标准 UT 框架(同目录兄弟 PR 11222 用 add_modules_ut_sources 接入 nn_op_host_ut)。后果:该 infershape UT 不会被仓级 nn_op_host_ut 收集,CI 的 op_host_ut 门禁不会执行它,测试形同虚设。建议改为 add_modules_ut_sources(HOSTNAME ${OP_INFERSHAPE_MODULE_NAME} ...) 的标准写法。


@handsomeRobot_SK 请处理检视意见。未解决的检视意见:
- 触发条件:adam 模式下传入 0 < max_grad_norm < 1 且 global_grad_norm > 1。base 版本文档与标准 Adam 裁剪语义均为 clip_coeff = min(1, max_grad_norm / global_grad_norm),而 kernel 只...
- 触发条件:编译 op_host/apply_adam_v2_infershape.cpp。本文件仅 include log/log.h、register/op_impl_registry.h 以及新加的 op_kernel/arch35/apply_adam_v2_tiling_data.h,而 O...
- 触发条件:var 为 0 元素(shape 含 0)且其它输入非法,例如 lr/beta1/epsilon 传了 0 元素张量,或 m/v/grad 与 var 不广播兼容。该“6.5 空 Tensor 早退”插入在 dtype 校验之后、标量 shape 约束(第 7 段)、has_max_gra...
- 注释写“以下三字段仅作 ABI 占位,Host 不写入有效值”,但紧随其后的三个字段是 clipCoeff、hasMaxGradNorm、hasStepSize:其中 hasMaxGradNorm/hasStepSize 由 host 写入有效值(apply_adam_v2_tiling_arch3...
- 本 PR 只给 GenOnesDataFloat32 的 new 补了判空并补了 delete[],同一文件 main() 中 “Session* session = new Session(build_opts);”(第 151 行)仍未做判空,且 “ret = session->AddGraph...


@handsomeRobot_SK 请处理检视意见。未解决的检视意见:
- 触发条件:adam 模式下传入 0 < max_grad_norm < 1 且 global_grad_norm > 1。base 版本文档与标准 Adam 裁剪语义均为 clip_coeff = min(1, max_grad_norm / global_grad_norm),而 kernel 只...
- 触发条件:编译 op_host/apply_adam_v2_infershape.cpp。本文件仅 include log/log.h、register/op_impl_registry.h 以及新加的 op_kernel/arch35/apply_adam_v2_tiling_data.h,而 O...
- 触发条件:var 为 0 元素(shape 含 0)且其它输入非法,例如 lr/beta1/epsilon 传了 0 元素张量,或 m/v/grad 与 var 不广播兼容。该“6.5 空 Tensor 早退”插入在 dtype 校验之后、标量 shape 约束(第 7 段)、has_max_gra...
- 注释写“以下三字段仅作 ABI 占位,Host 不写入有效值”,但紧随其后的三个字段是 clipCoeff、hasMaxGradNorm、hasStepSize:其中 hasMaxGradNorm/hasStepSize 由 host 写入有效值(apply_adam_v2_tiling_arch3...
- 本 PR 只给 GenOnesDataFloat32 的 new 补了判空并补了 delete[],同一文件 main() 中 “Session* session = new Session(build_opts);”(第 151 行)仍未做判空,且 “ret = session->AddGraph...


@handsomeRobot_SK 请处理检视意见。未解决的检视意见:
- 触发条件:adam 模式下传入 0 < max_grad_norm < 1 且 global_grad_norm > 1。base 版本文档与标准 Adam 裁剪语义均为 clip_coeff = min(1, max_grad_norm / global_grad_norm),而 kernel 只...
- 触发条件:编译 op_host/apply_adam_v2_infershape.cpp。本文件仅 include log/log.h、register/op_impl_registry.h 以及新加的 op_kernel/arch35/apply_adam_v2_tiling_data.h,而 O...
- 触发条件:var 为 0 元素(shape 含 0)且其它输入非法,例如 lr/beta1/epsilon 传了 0 元素张量,或 m/v/grad 与 var 不广播兼容。该“6.5 空 Tensor 早退”插入在 dtype 校验之后、标量 shape 约束(第 7 段)、has_max_gra...
- 注释写“以下三字段仅作 ABI 占位,Host 不写入有效值”,但紧随其后的三个字段是 clipCoeff、hasMaxGradNorm、hasStepSize:其中 hasMaxGradNorm/hasStepSize 由 host 写入有效值(apply_adam_v2_tiling_arch3...
- 本 PR 只给 GenOnesDataFloat32 的 new 补了判空并补了 delete[],同一文件 main() 中 “Session* session = new Session(build_opts);”(第 151 行)仍未做判空,且 “ret = session->AddGraph...


@handsomeRobot_SK 请处理检视意见。未解决的检视意见:
- 触发条件:adam 模式下传入 0 < max_grad_norm < 1 且 global_grad_norm > 1。base 版本文档与标准 Adam 裁剪语义均为 clip_coeff = min(1, max_grad_norm / global_grad_norm),而 kernel 只把 max_grad_norm 当开关(apply_adam_v2_kernel.h:383 判断 maxGradNorm > 0 && globalGradNorm > 1 后直接 clip_coeff = 1/glo
- 触发条件:编译 op_host/apply_adam_v2_infershape.cpp。本文件仅 include log/log.h、register/op_impl_registry.h 以及新加的 op_kernel/arch35/apply_adam_v2_tiling_data.h,而 Ops::Base::ToString 声明在 util/shape_util.h;仓内其余使用该工具函数的 infershape(如 loss/mse_loss、optim/sparse_apply_ftrl)均显式 #
- 触发条件:var 为 0 元素(shape 含 0)且其它输入非法,例如 lr/beta1/epsilon 传了 0 元素张量,或 m/v/grad 与 var 不广播兼容。该“6.5 空 Tensor 早退”插入在 dtype 校验之后、标量 shape 约束(第 7 段)、has_max_grad_norm_/has_step_size_ 探测与 PadAndSqueeze/broadcast 校验之前,命中即 return GRAPH_SUCCESS。后果:非法标量/不兼容形状被当作合法调用接受;而 kern
- 注释写“以下三字段仅作 ABI 占位,Host 不写入有效值”,但紧随其后的三个字段是 clipCoeff、hasMaxGradNorm、hasStepSize:其中 hasMaxGradNorm/hasStepSize 由 host 写入有效值(apply_adam_v2_tiling_arch35.cpp:489-490)并被 kernel 用于决定是否读取 max_grad_norm/step_size 以及 mbart 模式下用 lr 兜底(apply_adam_v2_kernel.h:373、392-39
- 本 PR 只给 GenOnesDataFloat32 的 new 补了判空并补了 delete[],同一文件 main() 中 “Session* session = new Session(build_opts);”(第 151 行)仍未做判空,且 “ret = session->AddGraph(...)”(第 154 行)的返回值未检查就无条件打印 AddGraph success。后果:内存不足或图注册失败时示例会静默打印成功结论或空指针解引用,内存与错误处理整改未真正闭环。建议:同批补 Session n
- 这里用 add_executable/add_test 创建独立测试可执行文件,未接入仓内标准 UT 框架(同目录兄弟 PR 11222 用 add_modules_ut_sources 接入 nn_op_host_ut)。后果:该 infershape UT 不会被仓级 nn_op_host_ut 收集,CI 的 op_host_ut 门禁不会执行它,测试形同虚设。建议改为 add_modules_ut_sources(HOSTNAME ${OP_INFERSHAPE_MODULE_NAME} ...) 的标准写


该 PR 存在未解决的代码冲突,且已超过 10 天未更新,已被暂时关闭。若需继续合入,请先解决冲突并重新打开 PR。


[apply_adam_v2] quality-hardening:算子质量加固修复(准入+检视问题整改)
一、变更概述
apply_adam_v2(Adam/ MBART-Adam 优化器更新算子,ops-nn/optim/apply_adam_v2,ascend950/arch35,RegBase VF 链 + TBuf 管理 UB,仅 GEIR 通路)在 2026-09-23 质量扫描中结论为准入 FAIL(P1 产品支持 / P2 golden 一致性 2 项 FAIL + P3 格式校验 WARN + P4 空 Tensor 转检视)与代码检视 3 FAIL / 5 SUSPICIOUS / 设计一致性 6 项偏差 / 风格 3 FAIL(问题 C1~C14)。
本分支
apply_adam_v2_quality_hardening(自 quality-hardening 基线 ae74ae0da 起,共 9 个提交)对上述问题逐条整改,并同步交付件仓 operator-artifacts/ApplyAdamV2(DESIGN/REQUIREMENTS/spec/golden/异常用例)。整改原则:二、分类修改清单
2.1 代码修改(ops-nn/optim/apply_adam_v2)
int64_t start, end拆分初始化2.2 资料修改(operator-artifacts/ApplyAdamV2)
2.3 用例修改(operator-artifacts/ApplyAdamV2)
三、逐 commit 摘要(分支 9 提交)
交付件同步提交(operator-artifacts/ApplyAdamV2 本算子部分)
四、测试与验证
cross_check+math.isnan/math.isinf,符合 longtail-docs-verification 规则 f(仅允许 torch/tf 计算)。五、未完成事项与限制
5.1 三禁区声明(本分支不触碰,问题转入未修项追踪)
[ApplyAdamV2]注册节维持现状(架构既定),README 支持面最终口径待产品/架构决策(未修项 A1)。5.2 环境限制(无 NPU/TTK)
CreateAddrReg索引上限与UpdateMask(count)尾段掩码语义(API-8)离线无法核实,repCount≤199<255 由 UB 预算保证(未修项 B4)。5.3 未修项索引
完整未修项(8 条:A1/A2/B3/B4/B5/C6/C7/D8)与处置建议见《apply_adam_v2_未修项明细.md》(guide/未修项明细/ 目录),含工具链/仓内惯例冲突豁免(STYLE-1.4 snake_case 成员、STYLE-2.3 Type* 风格)等待工具链 owner 裁决。