已合并
Docs: data_type_utils相关接口资料更新 #680
ren-botao创建于 22 天前
Docs: data_type_utils相关接口资料更新 #680
已合并
Pull Request已成功合入, 合并人@CANN-robot
（感谢 ren-botao 的贡献）
atomgit-bot
22 天前 评论：
22 天前 评论：
变更摘要
本次 PR 是纯粹的文档更新，聚焦于 data_type_utils 相关接口资料的补充与完善。共涉及 31 个文件，新增约 368 行、删除约 29 行，不包含任何代码逻辑或功能变更。
主要改动
data_type_utils接口文档补充：针对data_type_utils相关模块的接口说明进行了内容增补与格式调整，提升了文档的完整性和可读性。- 文档细节修正：对原有文档中少量不准确或过时的描述进行了修正（体现为 29 行删除），确保接口文档与实际行为一致。
- 多文件文档同步更新：31 个变更文件表明此次更新覆盖了
data_type_utils相关的多个文档入口，可能涉及不同模块或不同层级的接口说明页面。
atomgit-bot
22 天前 评论：
22 天前 评论：
代码审查
审查总结
已审查全部 31 个变更文件，结果如下：
| 优先级 | 数量 |
|---|---|
| P0 | 0 |
| P1 | 0 |
| P2 | 0 |
| P3 | 1 |
各文件审查结论：
.gitignore— 无问题（添加.claude/、.opencode/开发工具目录到忽略列表）docs/zh/api/nnopbase/opdev/0_opdev_api_list.md— 无问题（API 列表新增 8 个接口条目，旧 op_common 章节标记为废弃）docs/zh/api/nnopbase/opdev/1_opdev_api_introduction.md— 无问题（data_type_utils 条目增加废弃提示）docs/zh/api/nnopbase/opdev/data_type_utils/CanCast.md— 无问题（新增文档，内容正确）docs/zh/api/nnopbase/opdev/data_type_utils/CheckType.md— 无问题（新增文档，内容正确）docs/zh/api/nnopbase/opdev/data_type_utils/IsComplexType.md— 无问题（新增文档，内容正确）docs/zh/api/nnopbase/opdev/data_type_utils/IsFloatingType.md— 无问题（新增文档，内容正确）docs/zh/api/nnopbase/opdev/data_type_utils/IsIntegralType.md— 无问题（新增文档，内容正确）docs/zh/api/nnopbase/opdev/data_type_utils/IsIntegralType_bool.md— 无问题（新增文档，内容正确）docs/zh/api/nnopbase/opdev/data_type_utils/PromoteType.md— 无问题（新增文档，内容正确）docs/zh/api/nnopbase/opdev/data_type_utils/ToString.md— 无问题（新增文档，内容正确）docs/zh/api/nnopbase/opdev/data_type_utils/data_type_utils.md— 无问题（索引页新增 8 个接口链接）docs/zh/api/nnopbase/opdev/data_type_utils/reserved_interface_data_type_utils.md— 无问题（移除已升级为正式接口的 CheckType）docs/zh/api/nnopbase/opdev/float4_e1m2/float4_e1m2.md— 无问题（infinity/NaN 描述修正）docs/zh/api/nnopbase/opdev/float4_e2m1/float4_e2m1.md— 无问题docs/zh/api/nnopbase/opdev/float6_e2m3/float6_e2m3.md— 无问题docs/zh/api/nnopbase/opdev/float6_e3m2/float6_e3m2.md— 无问题docs/zh/api/nnopbase/opdev/float8_e4m3fn/float8_e4m3fn.md— 无问题docs/zh/api/nnopbase/opdev/float8_e5m2/float8_e5m2.md— 无问题docs/zh/api/nnopbase/opdev/float8_e8m0/float8_e8m0.md— P3：max()="最大值" 与infinity()="最大有限值" 描述不一致docs/zh/api/nnopbase/opdev/hifloat4/hifloat4.md— 无问题docs/zh/api/nnopbase/opdev/op_common_related_interface/CanCast.md— 无问题（添加废弃提示）docs/zh/api/nnopbase/opdev/op_common_related_interface/IsComplexType.md— 无问题docs/zh/api/nnopbase/opdev/op_common_related_interface/IsFloatingType.md— 无问题docs/zh/api/nnopbase/opdev/op_common_related_interface/IsIntegralType.md— 无问题docs/zh/api/nnopbase/opdev/op_common_related_interface/IsIntegralType_bool.md— 无问题docs/zh/api/nnopbase/opdev/op_common_related_interface/PromoteType.md— 无问题docs/zh/api/nnopbase/opdev/op_common_related_interface/data_type_utils-6.md— 无问题docs/zh/api/nnopbase/opdev/op_common_related_interface/op_common_related_interface.md— 无问题docs/zh/api/nnopbase/opdev/opbase_frame_interface.md— 无问题（标记 op_common 为废弃）docs/zh/api/nnopbase/opdev/small_vector/small_vector.md— 无问题（reserve/ExpandCap 描述改进）
整体风险判断：低风险。 本 PR 为纯文档更新，新增 data_type_utils 接口文档并标记旧 op_common 接口为废弃，同时改进了多种浮点类型和 small_vector 的描述文字。除 Float8E8M0 一处 max()/infinity() 措辞不一致外，未发现安全风险、误导性指令或内容错误。
⚠️ 已识别出整体风险，但无法提取行内评论，请参考整体评估。
22 天前 添加了label：cann-cla/yes
CANN-robot
22 天前 评论：
22 天前 评论：
Thanks for your pull-request.
The full list of commands accepted by me can be found at here。
You can get sig-info at here
PR Approval Progress
✅ Congratulations! All modules have met the lgtm and approve requirements.
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| repo-cann/opbase | ✅ 宋恺, 张磊 (2/2) | ✅ 宋恺, 张磊 (2/1) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
ren-botao, thanks for your pull request. All authors of the commits have signed the CLA. 👍
CANN-robot22 天前 将zhou-qilong,wangrui_,rxtfeng,loov1,jia0liang,zl_hw,songkai111,llimwang,gubaocheng设为评审人
22 天前 将zhou-qilong,wangrui_,rxtfeng,loov1,jia0liang,zl_hw,songkai111,llimwang,gubaocheng设为评审人
CANN-robot22 天前 将zhou-qilong,wangrui_,rxtfeng,loov1,jia0liang,zl_hw,songkai111,llimwang,gubaocheng设为审查人
22 天前 将zhou-qilong,wangrui_,rxtfeng,loov1,jia0liang,zl_hw,songkai111,llimwang,gubaocheng设为审查人
CANN-robot
22 天前 评论：
22 天前 评论：
The following users do not have permission to comment /lgtm or /approve on any module in this PR:
陈娇
21 天前 添加了label：ci-pipeline-running
CANN-robot
21 天前 评论：
21 天前 评论：
流水线任务触发成功
任务链接 [5ea8b338bfc4489aaa08948a59b8aafd][流水线指导]
| 任务名称 | 状态 | 日志 | 下载链接 |
|---|---|---|---|
| codecheck | ✅ SUCCESS | >>>>> | |
| SCA | ✅ SUCCESS | >>>>> | |
| antipoison | ✅ SUCCESS | >>>>> | |
| Check_Pr | ✅ SUCCESS | >>>>> | |
| Compile_Ascend_X86_ubuntu24 | ✅ SUCCESS | >>>>> | >>>>> |
| UT_Test | ✅ SUCCESS | ||
| Compile_Ascend_ARM_ubuntu24 | ✅ SUCCESS | >>>>> | >>>>> |
| pre_comment | ✅ SUCCESS | >>>>> | |
| StaticCheck_codespell | ⚠️ WARNING | >>>>> | |
| StaticCheck_link_validity | ✅ SUCCESS | ||
| StaticCheck_resource_existence | ✅ SUCCESS | ||
| StaticCheck_tag_closed | ✅ SUCCESS | ||
| StaticCheck_markdownlint | ✅ SUCCESS | ||
| codecheck_style | ✅ SUCCESS | >>>>> | |
| precommit | ✅ SUCCESS | >>>>> | |
| API_Check | ✅ SUCCESS | >>>>> |
[2026-07-29 16:22:57] CI执行结束
21 天前 添加了label：api-check-pass
21 天前 删除了label：ci-pipeline-running
21 天前 添加了label：ci-pipeline-passed
CANN-robot
21 天前 评论：
21 天前 评论：
流水线 PR-pipeline_cann_opbase#1571 [ commitID：d1f59497 ] 已完成
songkai111
21 天前 评论：
21 天前 评论：
/approve
CANN-robot
21 天前 评论：
21 天前 评论：
The following users do not have permission to comment /lgtm or /approve on any module in this PR:
陈娇
21 天前 添加了label：approved
CANN-robot
21 天前 评论：
21 天前 评论：
The following users do not have permission to comment /lgtm or /approve on any module in this PR:
陈娇
21 天前 添加了label：lgtm
21 天前 关闭了关联的issue
21 天前 合入了pull request
描述
资料问题修改：
关联的Issue
#290 data_type_utils相关接口资料更新
#255 代码和文档不一致：ToString接口缺少文档
测试
文档更新
data_type_utils目录下相关文档；
float8/6/4相关文档
small_vector.md
类型标签