现象

aclnnRange 的 out 声明为 2 维或 3 维时，两段接口均返回 0（放行），并把前 N 个元素写满；资料参数表要求 out 是 1 维张量。实现只拒绝了 0 维（dim_num == 0）这一种情况。

实测（Atlas A2 910B2，CANN 9.2.0，start=-0.5, end=16, step=1，推导长度 17）：

复现脚本输出：

[D2 out=[17]      ] phase1=0 phase2=0 written=17
[D2 out=[2,8] 2-D ] phase1=0 phase2=0 written=16
[D2 out=[1,1,17] 3D] phase1=0 phase2=0 written=17
[D2 out=[] 0-D    ] phase1=161002

另：valid-fuzz 采样器在无 tensor 输入的接口上自然造出 out=fp16[8x8]ND（2 维），同样两段返回 0 —— 2 维放行是稳定行为，不是偶发。

期望

资料 math/range/docs/aclnnRange.md 的 out 参数行：

同文档「功能说明」也写明「返回大小为 $\lfloor\frac{end-start}{step}\rfloor+1$ 的 1 维张量」。

非 1 维的 out 属于参数与接口契约不符，应按错误码表返回 161002（ACLNN_ERR_PARAM_INVALID），而不是静默按扁平化写入。

根因

math/range/op_api/aclnn_range.cpp:172-183：

inline static aclnnStatus CheckParamsLogic(const aclScalar* start, const aclScalar* end, const aclScalar* step,
                                           const aclTensor* out)
{
    size_t dim_num = out->GetViewShape().GetDimNum();
    OP_CHECK(dim_num != 0,                                  // ← 只排除 0 维
             OP_LOGE(ACLNN_ERR_PARAM_INVALID, "Expected out to be a 1D tensor, but got %zu dimension(s).", dim_num),
             return ACLNN_ERR_PARAM_INVALID);
    ...
}

告警文案写的是「Expected out to be a 1D tensor」，但判定条件只写了 dim_num != 0 —— 文案与条件不一致，2/3/4 维全部通过。正确条件应为 dim_num == 1。

环境

• Atlas A2 训练系列产品（910B2），CANN 9.2.0
• 仓库 cann/ops-math，master 1b415030
• 头文件 /usr/local/Ascend/ascend-toolkit/latest/include/aclnnop/aclnn_range.h（9.2.0 发布件）

复现步骤

1. source $ASCEND_HOME_PATH/set_env.sh，确认 ASCEND_OPP_PATH=$ASCEND_HOME_PATH/opp。
2. g++ -std=c++17 -O2 repro.cpp -o repro -I$ASCEND_HOME_PATH/include -I$ASCEND_HOME_PATH/include/aclnnop -L$ASCEND_HOME_PATH/lib64 -Wl,--allow-shlib-undefined -lascendcl -lopapi -lnnopbase
3. 选一张 Health=OK 的卡（Health=Alarm 的 die 上 aclrtSetDevice 会永久挂死）：PROBE_DEV=<n> ./repro
4. 2 维与 3 维两组两段均返回 0（应为 161002）。

实测输出：

==== aclnnRange out 维数校验 ====
out=[17]      phase1=0 phase2=0 written=17/17   <- 合法对照
out=[2,8]     phase1=0 phase2=0 written=16/16   <- 2 维被放行（应 161002）
out=[1,1,17]  phase1=0 phase2=0 written=17/17   <- 3 维被放行（应 161002）
out=[]        phase1=161002                     <- 0 维被拦

复现脚本

完整脚本见附件 probe_range_contract.cpp（shape 组）。核心：

for (auto& sh : {std::vector<int64_t>{17}, {2,8}, {1,1,17}, {}}) {
    aclTensor* out = aclCreateTensor(sh.data(), (int)sh.size(), ACL_FLOAT,
                                     nullptr, 0, ACL_FORMAT_ND, sh.data(), (int)sh.size(), dev);
    aclnnStatus r1 = aclnnRangeGetWorkspaceSize(s, e, p, out, &ws, &ex);
    printf("rank=%zu phase1=%d\n", sh.size(), (int)r1);
}