CANN/cannbot：常见陷阱

【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skillstitle: 常见陷阱 purpose: 汇总 RegBase 设计和实现中的高频错误作为审查前快速检查表。 read_when:设计缺少分层或实现出现不稳定问题。需要快速判断是否偏离 RegBase 主路径。 keywords:trapsreviewlayer next_reads:api_misuse.mdregbase_vs_membase_confusions.mdprecision_failures.md depth: foundation topic_type: pitfall常见陷阱1. 分层陷阱把整个 kernel 写成一个大 VF 函数。把 GM/UB copy 和寄存器计算写在同一层不说明 ownership。在Process里直接堆寄存器级数学导致CopyIn - Compute - CopyOut不可读。只写 “RegBase path”没有说明 Host / Kernel / UB / VF 边界。2. API 陷阱编造AscendC::Reg::*签名。把 MemBase / LocalTensor API 当成 RegBase VF API。没有检查 header 或 SDK 文档。API 参数顺序和 mask 位置靠猜。3. tail / mask 陷阱copy 层处理了 tail但 VF store 没有 mask。mask 使用对齐长度而不是有效长度。compare mask 和 store mask 混用但语义不同。padding 值进入数学结果。4. dtype / precision 陷阱fp16/bf16 不说明是否升 fp32。cast 回输出 dtype 的位置不清楚。reduce accumulation dtype 不明确。quant/dequant 缺少 scale、rounding、saturate 说明。5. 同步陷阱用SyncAll修本地 stage ordering。把MaskReg当同步。没有参考实现就加SetFlag/WaitFlag。cross-core flag 用来补本地 UB 交接。相关文档[[api_misuse]][[regbase_vs_membase_confusions]][[precision_failures]]【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考