Pull Request

变更摘要

此 PR 回退了 PR !3807 的变更，恢复 aclrtDim3 类型的定义与使用。PR !3807 曾删除 aclrtDim3 并统一替换为 dim3（含 C++ 构造函数支持），但出于需保留 aclrtDim3 类型的原因，本次回退将所有 dim3 引用还原为 aclrtDim3，同时移除 dim3 的构造函数及条件编译保护，并删除对应的构造行为单元测试。

主要改动

• 恢复 aclrtDim3 类型定义：在 include/external/acl/acl_rt.h 中，删除带 C++ 构造函数与 #ifndef __BISHENG_CCEC__ 条件编译的 dim3 结构体，恢复为无构造函数的 aclrtDim3 结构体（含 x、y、z 三个 uint32_t 成员）。
• 恢复 SIMT 内核 API 参数类型：在 acl_rt_wrapper.h 的宏定义和 kernel.cpp 的实现中，将 aclrtLaunchSIMTKernelWithArgsArray 和 aclrtLaunchSIMTKernelWithHostArgs 的 gridDim、blockDim 参数类型从 dim3 还原为 aclrtDim3。
• 修复单元测试：在 acl_runtime_unittest.cpp 中，将所有 SIMT 内核测试用例中的 dim3 变量声明替换回 aclrtDim3，并移除针对 dim3 默认构造函数、部分参数构造函数和全参数构造函数的三项测试用例。
• 恢复 API 参考文档：在 docs/zh/api_ref/14_kerne_loading_and_execution.md 和 docs/zh/api_ref/25-04_Structs.md 中恢复与 aclrtDim3 相关的文档内容。

代码审查

经过全面审查，所有 6 个变更文件均已检查完毕。以下是我的分析：

逐文件审查结果

1. include/external/acl/acl_rt.h

• dim3 → aclrtDim3 类型定义恢复正确，移除了 __BISHENG_CCEC__ 守卫和 C++ 构造函数（恢复至 C 语言纯结构体形态）
• 两个 SIMT API 函数签名中 dim3 → aclrtDim3 参数类型恢复正确
• aclrtPlaceHolderInfo 结构体定义未变更，仍位于第 749-752 行
• 所有变更与其余文件一致

结论：无问题。

2. src/acl/aclrt_impl/acl_rt_wrapper.h

• wrapper 宏中 dim3 → aclrtDim3 类型替换正确
• 两个 SIMT API 的宏定义与头文件声明一致

结论：无问题。

3. src/acl/aclrt_impl/kernel.cpp

• aclrtLaunchSIMTKernelWithArgsArrayImpl 和 aclrtLaunchSIMTKernelWithHostArgsImpl 两个实现函数签名中 dim3 → aclrtDim3 替换正确
• 函数体内部的 gridDim.x/y/z、blockDim.x/y/z 字段访问无需变更（结构体成员名相同）
• static_cast<uint32_t>(argsSize) 和 static_cast<uint32_t>(placeHolderNum) 是已有的窄化转换，不在本次 diff 变更范围内

结论：无问题。

4. tests/ut/acl/testcase/acl_runtime_unittest.cpp

• 所有 SIMT kernel 测试用例中 dim3 → aclrtDim3 替换正确
• 移除了三个 dim3 构造函数测试（dim3_default_constructor_initializes_to_one、dim3_partial_args_constructor、dim3_full_args_constructor），因为 aclrtDim3 是纯 C 结构体，无构造函数
• 测试调用处的类型与函数签名完全匹配

结论：无问题。

5. docs/zh/api_ref/14_kerne_loading_and_execution.md

• TOC 中移除了两个 SIMT API 条目
• launch_kernel_comparison 锚点和 SIMT 行已移除
• 各 Launch 接口的"参考资源"小节中，跨引用恢复为内联对比表（去除了 SIMT 行），语义一致
• aclrtLaunchKernelWithHostArgs 的 placeHolderArray 参数，aclrtPlaceHolderInfo 文档恢复为内联定义
• 两个 SIMT API 的完整文档章节（aclrtLaunchSIMTKernelWithArgsArray、aclrtLaunchSIMTKernelWithHostArgs）已移除
• 无悬空的跨引用（已确认 launch_kernel_comparison、25-04_Structs.md#dim3、25-04_Structs.md#aclrtPlaceHolderInfo 均无残留引用）

结论：无问题。

6. docs/zh/api_ref/25-04_Structs.md

• TOC 中移除了 aclrtPlaceHolderInfo 和 dim3
• 两个结构体的完整文档条目已移除
• 文件以 aclrtUuid 正常结束

结论：无问题。

关闭摘要

• P0：0 个
• P1：0 个
• P2：0 个
• P3：0 个

整体风险判断：低。 这是一次干净的回退操作，所有类型名称从 dim3 恢复到 aclrtDim3，所有文档、实现和测试一致。SIMT API 文档被移除（这些文档原本就是被回退的 PR 新增的），API 声明和实现仍然保留。跨文件引用和类型一致性均已验证，未发现任何正确性、安全性或可靠性问题。

💬 仅评论

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

💡 Tip:

• Committer can comment /approve or /lgtm
• Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

yanmingxiang, thanks for your pull request. All authors of the commits have signed the CLA. 👍

/compile

流水线任务触发成功
任务链接 [16a63a751ceb4a6aa60e15285da555a6][流水线指导]

[2026-07-29 21:07:43]    CI执行结束

流水线任务触发成功
任务链接 [5375942ec8c44f32a94102f6ccfd3008][流水线指导]

[2026-07-29 20:40:22]    CI执行结束

/approve
/lgtm

/approve

/approve

/compile

流水线任务触发成功
任务链接 [a84787bee65b4b28a1bc0b9f7dd724fb][流水线指导]

[2026-07-29 21:19:03]    CI执行结束

流水线任务触发成功
任务链接 [7c5ac59573b64b69abdc1ca129d7228b][流水线指导]

[2026-07-29 21:10:46]    CI执行结束