现象

aclnnInplaceSin 的 selfRef 数据类型支持面，资料参数表、头文件注释、实现三处互不一致，
另有一处错误码声明与实现不符：

三处口径成环：参数表 3 种 / 头文件 11 种 / 实测 6 种。信参数表漏用 fp64 与 complex；
信头文件会拿整型去调、白等一个 161002。

期望

• 参数表 selfRef「数据类型」列补 DOUBLE、COMPLEX64、COMPLEX128；
• 头文件 @param selfRef 注释改成与之一致的 6 种（补 BFLOAT16、删 INT8/INT16/INT32/INT64/UINT8/BOOL）；
• 错误码表删掉「数据格式」，或改为「仅支持 ND，非 ND 只告警并按 ND 解释」；若要求拒绝，
  需把 CheckParamsSin 的 OP_LOGW 改成返回 ACLNN_ERR_PARAM_INVALID。

环境

• 基线：cann/ops-math@b7fe8ad85b879ec4ad7d358c19bddd26fe85e181（git ls-remote --heads origin 的 master）
• 资料 sha256：a949bff62eff37ea8b049c7bf309ec5396fd0c14c4311dbfb526b2382ef5a0f8
  （git show b7fe8ad:math/sin/docs/aclnnSin&aclnnInplaceSin.md | sha256sum 与本地检出逐字节一致）
• 硬件：Atlas A3（IT22HMDA_4_S），8 NPU / 16 device，npu-smi 26.1.1
• 软件：CANN 9.2.0（toolkit + A3-ops），Python 3.12.15，torch 2.12.0+cpu / torch_npu

文档链接

• 资料：math/sin/docs/aclnnSin&aclnnInplaceSin.md（aclnnInplaceSin 段）
  https://gitcode.com/cann/ops-math/blob/master/math/sin/docs/aclnnSin%26aclnnInplaceSin.md
• 头文件：math/sin/op_api/aclnn_sin.h（aclnnInplaceSinGetWorkspaceSize 的 @param selfRef）

问题文档片段

片段 1（参数表 selfRef 行「数据类型」列）：FLOAT、BFLOAT16、FLOAT16

片段 2（同一节错误码表）：ACLNN_ERR_PARAM_INVALID | 161002 | selfRef数据类型和数据格式不在支持的范围之内。

片段 3（头文件 aclnn_sin.h 的 @param selfRef 注释）：

数据类型支持INT8、INT16、INT32, INT64, UINT8、BOOL、FLOAT、FLOAT16、
DOUBLE、COMPLEX64、COMPLEX128

存在的问题

即「现象」表 3 条：① 参数表漏声明 DOUBLE/COMPLEX64/COMPLEX128；② 头文件注释多写 6 种整型/bool
且漏 BFLOAT16；③ 错误码表把 format 纳入 161002 而实现只告警。三条均属资料/注释写错，
实测不产生错误结果，故按文档问题报（P2）。

复现步骤

1. A3 + CANN 9.2.0 环境 source /usr/local/Ascend/ascend-toolkit/set_env.sh，运行 python3 repro_inplacesin_doc.py；
2. 对照输出：fp64/complex64/complex128 的 rc1/rc2 均为 0，三种非 ND 格式 rc1 均为 0，int32/bool 的 rc1 为 161002；
3. 与 md 参数表（3 种）、md 错误码表（format 应 161002）、头文件注释（11 种）三方比对。

复现脚本

source /usr/local/Ascend/ascend-toolkit/set_env.sh
python3 repro_inplacesin_doc.py

实测输出（python3 repro_inplacesin_doc.py; echo EXIT=$?）：

[D1] 资料 selfRef dtype 声明：'FLOAT、BFLOAT16、FLOAT16'
[D1] fp64        接受（rc=0/0）
[D1] complex64   接受（rc=0/0）
[D1] complex128  接受（rc=0/0）
[D1] int32       拒绝 rc1=161002（资料未声明，符合契约）
[D1] bool        拒绝 rc1=161002（资料未声明，符合契约）
[D2] format=FRACTAL_NZ  rc=0/0（资料错误码表声明非 ND 应 161002）
[D2] format=NDHWC       rc=0/0（资料错误码表声明非 ND 应 161002）
[D2] format=FRACTAL_Z   rc=0/0（资料错误码表声明非 ND 应 161002）
[D3] 头文件 aclnnInplaceSin 注释：含 DOUBLE=True，含 BFLOAT16=False
==== 结论 ====
  [缺陷] D1: fp64/complex64/complex128 被接受（资料未声明）
  [缺陷] D2: FRACTAL_NZ/NDHWC/FRACTAL_Z 未按资料返回 161002（ret rc1=0）
  [缺陷] D3: 头文件注释列 DOUBLE 却漏 BFLOAT16（与 md 及实测三方不一致）
退出码 1（缺陷成立）
EXIT=1

退出码语义：0=资料与实现一致、1=缺陷成立、2=无法判定。

影响

按参数表只能看到 3 种 dtype，fp64 与 complex64/128 这两类实测可用的能力没有出口；
按头文件注释写代码会传整型/bool 而拿到 161002（注释引导踩坑）；按错误码表预期「非 ND 报 161002」
的调用方会写出多余分支，并误判 ND 是强制约束。

建议

按「期望」三处同步改齐，使 md 参数表 / 头文件注释 / 实现白名单 三方一致；并在 op_api 单测里加
一条「dtype 白名单与 md 参数表一致」的断言，避免再次漂移。

与既有 issue 的关系（查重结论）

• #4210（[aclnnSin] FLOAT16 精度保证范围写成 [-10^7,10^7]）：本资料「约束说明」把三种 dtype
  写成同一范围而 fp16 上界仅 65504 —— 该段落双接口共用，已由 #4210 覆盖，本单不重复提。
• #4146（[InplaceSinh] 头文件注释声明 selfRef 支持 6 种整型/bool，实测全返 161002）：
  同族但接口不同；本单除「多写 6 种整型」外还有「漏写 BFLOAT16」「参数表少写 DOUBLE/COMPLEX」。
• #4147（[InplaceSinh] 错误码表参数名写成 cost/p 且缺「维度大于8」子项）：本接口的
  「维度大于8」子项存在且实测一致（rank 9、10 均 161002），本单讲的是 format 被纳入 161002。
• #4200（[aclnnInplaceAtan2] 的 selfRef 表外 dtype 未拒绝）：同「实现宽于资料」形态、不同接口，
  本单放行的是资料没写的 dtype，属漏声明。

附带说明（不属本单）

同批 1000 条六维用例在 A3 上：精度 906/906 通过、确定性 230 条逐位一致、错误码 3/3 匹配、
886,577 次并发无异常，未发现功能缺陷。另注：Sin kernel 退出时 VECTOR_MASK_0/1、CTRL[56] 未复位，
VECTOR_MASK_0 残留值等于元素数（64/1024/256/32/16 逐一对应），与 #4201(Mod)、#7659(FastGelu)
同一指纹，本批未观测到数值后果，仅作线索登记。