一、文档链接

• 仓库：cann/ops-math
• 文件：math/round/docs/aclnnRoundDecimals&aclnnInplaceRoundDecimals.md
• 非原地接口段参数表：L107-115（aclnnRoundDecimalsGetWorkspaceSize）
• 原地接口段参数表：L280-288（aclnnInplaceRoundDecimalsGetWorkspaceSize，同样问题）

二、问题文档片段

L107-115 逐字原文：

      <td>decimals（int64_t）</td>
      <td>输入</td>
      <td>指定需要四舍五入的位数。</td>
      <td>-</td>
      <td>-</td>
      <td>-</td>
      <td>-</td>
      <td>-</td>

「约束说明」（L241、L394）逐字原文：

针对decimals不为0的场景：
输入数据超过(-347000, 347000)范围，精度可能会有影响。

三、存在的问题

1）decimals 的取值约束应有而缺。 参数表给这一行留了「使用说明 / 数据类型 / 数据格式 / 维度 / 非连续Tensor」五个字段，全部填的是 -。也就是说：合法取值范围没写、默认值没写、负值是否允许没写。而「约束说明」约束的是输入数据的绝对值（|x| > 347000），不是 decimals 本身，两件事不能互相顶替。

2）实测该参数的值域确实受约束（A2 910B2 / CANN 9.2.0，aclnn 两段式直调，两次调用均返回 0）：

用户按现在的资料无法预判「传 40 会得到全 NaN」「传 INT64_MAX 会被当成 -1」。这类输入目前既不报错也不提示。

3）接口层同样不校验。 math/round/op_api/aclnn_round.cpp 的 CheckParamsRound 只校验空指针、dtype、shape 与 format，校验区内不出现 decimals，值域完全靠调用方自觉。

4）建议补法。 在参数表 decimals 行的「使用说明」列补一句取值范围，并在「约束说明」补边界行为，例如：

decimals 建议取值 [-38, 38]（FLOAT）/ [-308, 308]（DOUBLE）；超出该区间时实现返回 NaN，不额外报错。FLOAT16/BFLOAT16 实测到 decimals=5 仍正常（走另一条执行路径），如无已知上限可写明"建议不超过 4"。

原地与非原地两段参数表内容一致，建议同步修改。

四、复现方式

1. 在仓库根目录保存下面脚本为 check.py。
2. 执行 python3 check.py。
3. 期望输出末行为 [DEFECT]、退出码为 1；若资料已补取值范围，脚本会打印 [OK] 并返回 0。

import pathlib
import re
import sys

doc = pathlib.Path("math/round/docs/aclnnRoundDecimals&aclnnInplaceRoundDecimals.md").read_text("utf-8")
row = re.search(r"<td>decimals（int64_t）</td>(.*?)</tr>", doc, re.S).group(1)
cells = re.findall(r"<td>(.*?)</td>", row)
rng = re.search(r"decimals[^。；\n]{0,40}?[-+]?\d+\s*[~至到]\s*[-+]?\d+", doc)
api = pathlib.Path("math/round/op_api/aclnn_round.cpp").read_text("utf-8")
guarded = "decimals" in api.split("aclnnRoundGetWorkspaceSize")[0]
print("使用说明列 =", repr(cells[2].strip()))
print("全文存在 decimals 区间声明 =", bool(rng))
print("接口层校验 decimals =", guarded)
if cells[2].strip() == "-" and not rng and not guarded:
    print("[DEFECT] decimals 既无取值范围说明，接口层也不校验值域")
    sys.exit(1)
print("[OK] 资料已声明 decimals 的取值范围")

实测输出（当前 master）：

使用说明列 = '-'
全文存在 decimals 区间声明 = False
接口层校验 decimals = False
[DEFECT] decimals 既无取值范围说明，接口层也不校验值域

以上脚本只读仓内文件，不依赖 NPU 与网络；第 2 点表格中的上板数据来自 aclnnRoundDecimals 两段式直调，环境为 Ascend 910B2 + CANN 9.2.0。