Document Link（文档链接）

• https://gitcode.com/cann/ops-transformer/blob/master/posembedding/rotary_position_embedding/docs/aclnnRotaryPositionEmbedding.md
• https://gitcode.com/cann/ops-transformer/blob/master/posembedding/rotary_position_embedding/docs/aclnnRotaryPositionEmbeddingV2.md
• https://gitcode.com/cann/ops-transformer/blob/master/posembedding/rotary_position_embedding_grad/docs/aclnnRotaryPositionEmbeddingGrad.md

Issues Section（问题文档片段）

1. Ascend 950 mode 支持列表不完整：三份文档 Ascend 950PR/Ascend 950DT 行原只写 2=quarter，3=interleave-half，缺失 0=half、1=interleave。
2. mode3 命名不一致：文档用 interleave-half，tiling 报错日志用 deepseek_interleave（forward/grad 各一处）。
3. V2 文档 rotate 未标注可选：参数表输入/输出列写 输入，与全仓可选参数标 可选输入 的约定不一致（rotate 实为可选，缺省按 mode 公式计算）。
4. V2 错误码表 161002 描述不完整：ACLNN_ERR_PARAM_INVALID 行描述未包含 rotate，与 op_api 入参校验范围不符。

Existing Issues（存在的问题）

1. 950 实际支持 mode 0/1/2/3，文档只列 2/3，用户易误判 950 不支持 half/interleave。
2. 同一模式文档叫 interleave-half、报错叫 deepseek_interleave，排查报错时易困惑。
3. rotate 未标注可选，与实现（可选、缺省走 mode 公式）不符。
4. 错误码表 161002 未列 rotate，与 op_api 校验（rotate 非空且 SoC 不支持时返回该错误码）不符。