描述

本 PR 修正 swiglu_mx_quant 算子资料与实际实现不一致的问题，并对齐 golden 参考实现与 binary.json 属性顺序。

改动一：修正算子描述与实现不一致（README.md / docs/aclnnSwigluMxQuant.md / op_graph/swiglu_mx_quant_proto.h）

属性描述由"预留参数"修正为真实语义：

• activate_left：表示对输入的前半部分或后半部分做 SwiGLU 激活，false 时激活后半部分；swiglu_mode=1 时该参数不生效
• swiglu_mode：计算模式 0=传统 SwiGLU、1=奇偶交错变体、2=前后分半 clamp 变体、3=前后分半 sigmoid-clamp 变体，取值范围 [0, 3]
• clamp_limit：变体 SwiGLU（swiglu_mode=1/2/3）的 clamp 门限，需大于 0
• glu_alpha / glu_bias：变体 SwiGLU（swiglu_mode=1/2）的 sigmoid 缩放系数 / 线性部分偏置
• group_mode：0=count 模式、1=cumsum 模式，当前仅支持 0
• scale_alg：0=OCP、1=cuBLAS、2=RNE（预留），当前仅支持 0 和 1
• max_dtype_value：预留参数，当前版本未生效

输入/输出描述修正：

• x：在 activate_dim 指定维度上的尺寸必须是 2 的倍数（原文误写为 dim 维度）
• group_index：shape[0] 大于 0 且小于等于 256；aclnn 文档数据类型由仅 INT64 修正为 INT32、INT64；补充 data 取值约束——每个值必须为大于等于 0 的整数，且所有值的和必须小于等于需要量化的 x 的总行数
• y：形状与 x 相同，activate_dim 维度为 x 的一半
• mxscale：每个量化块（32 个元素一组）的缩放因子；scale 成对存放——axis 轴为 y 对应轴除以 32 向上取整后按偶数对齐，最后一维固定为 2 存放相邻两个量化块的 scale；当 axis=-2 且 group_index 存在时，axis 轴 shape 为 y 对应轴值整除 64 再加 group_num

约束修正与补充：

• 修正：activate_dim 为非尾轴时，swiglu_mode 必须为 0（aclnn 文档原文误写为 0 或 1）
• 新增：swiglu_mode 为 2 或 3 时，axis 必须为 -1
• proto.h 中 mxscale shape 推导公式同步修正（块数按偶数对齐成对打包；group_index 且非尾轴时为 act_shape[axis]/64 + group_num）
• 新增：group_index 输入 data 约束——每个值必须为大于等于 0 的整数，且所有值的和必须小于等于需要量化的 x 的总行数（README.md 输入表与约束说明、aclnn 文档参数表与约束说明、proto.h 输入描述与 Constraints 三处同步补充；aclnn 文档原文"每个元素需要大于0"同步修正为"大于等于0的整数"）

改动二：golden 参考实现修正（tests/assets/golden.py）

• mxscale 布局修正为成对打包：axis 维为 ceil(n_blocks/2)，末维 2 存放相邻两个 32 元素块的 scale，padding 槽位补 0
• E8M0 scale 编码修正：scale_byte = clip(floor(log2(amax)) - emax + 127, 0, 255)，全零块输出 scale 字节 0（2^-127）
• group_index 场景修正：axis=-2 时每组拥有 ceil(rows_g/64) 个 scale pair 按组紧凑排布（分配 axis 维 = M//64 + groupNum）；axis=-1 时 group_index 对 SwiGLU 输出展平后的行做分段
• 头部新增 mxscale layout 说明注释（与 kernel/infershape 对齐）

改动三：binary.json 属性顺序对齐（op_host/config/ascend950/swiglu_mx_quant_binary.json）

• 16 个 binary 配置项的 attrs 顺序统一调整为与 proto.h 属性声明顺序一致：activate_dim 移至 activate_left 之前，group_mode 移至 glu_bias 之后
• 属性集合与取值不变，纯顺序调整（+144/-144 对称改动）

关联的Issue

• 关联Issue #5832（https://gitcode.com/cann/ops-nn/issues/5832）

测试

• golden.py 为精度比对参考实现，本次将其与 kernel 实际输出布局（mxscale 成对打包、E8M0 编码、group_index 打包逻辑）对齐，保障 ST 精度比对基准正确

文档更新

• quant/swiglu_mx_quant/README.md：属性语义、输入输出描述及约束修正
• quant/swiglu_mx_quant/docs/aclnnSwigluMxQuant.md：group_index 数据类型、mxscaleOut shape 规则、约束修正
• quant/swiglu_mx_quant/op_graph/swiglu_mx_quant_proto.h：属性语义与 mxscale 推导公式注释同步

类型标签

• Bug修复
• 新特性
• 性能优化
• 文档更新
• 其他，请描述：

AI/Agent生成声明

• AI辅助编写