Pull Request已成功合入, 合并人@CANN-robot
（感谢 zouyanlong 的贡献）
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/ascend-transformer-boost | ✅ goodpeople233, 尹祺然 (2/2) | ✅ 尹祺然 (1/1) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
Linking Issue Notice
@ninihihi , the pull request must be linked to at least one issue.
If an issue has already been linked, but the needs-issue label remains, you can remove the label by commenting /check-issue .
compile#openlibing
compile
文档检查门禁结果:
变更摘要
此 PR 主要对 ATB 项目中与 ATB_BUILD_DEPENDENCY_PATH 环境变量及 ABI（CXX ABI）判断相关的文档说明进行修正和补充，涉及 README.md、docs/常见问题与回答.md 和 docs/测试框架指南.md 三份文档。变更聚焦于澄清 nnal 依赖路径的正确设置方式、ABI 版本（cxx_abi_0 / cxx_abi_1）的判定逻辑（结合 PyTorch 的 torch.compiled_with_cxx11_abi()），以及 ABI 切换后需执行 --clean-first 全量重编译的注意事项，确保用户能够正确配置编译环境并避免链接错误。
主要改动
- 修正
ATB_BUILD_DEPENDENCY_PATH设置说明：在README.md和docs/常见问题与回答.md中，明确了 nnal 安装在默认路径（/usr/local/Ascend/nnal/...）时无需手动设置该变量、脚本会自动匹配 ABI；非默认路径时须手动指向正确的cxx_abi_{0|1}子目录。 - 补充 ABI 版本判定方法：在
docs/常见问题与回答.md中新增了基于 PyTorch 安装状态的 ABI 判定流程——未安装 PyTorch 时默认使用cxx_abi_1，已安装时通过torch.compiled_with_cxx11_abi()返回值确定cxx_abi_0或cxx_abi_1。 - 新增 ABI 切换后重编译警告：在
README.md（第 143 行）和docs/测试框架指南.md（第 79 行）中分别补充了说明：切换 ABI 或 PyTorch 环境变更导致 ABI 判别结果改变时，必须重新设置ATB_BUILD_DEPENDENCY_PATH并执行bash scripts/build.sh --clean-first全量重编译，否则 CMake 缓存残留会导致链接错误。 - 完善测试框架指南的编译失败排查表：在
docs/测试框架指南.md的“常见编译失败”表格中修正了libatb.so: undefined reference错误的解决方案描述，明确指向 CXX ABI 版本一致性检查。
compile#openlibing
libing-pipeline创建中，请等待……
/lgtm
描述
修正ATB_BUILD_DEPENDENCY_PATH及ABI判断说明(含README/FAQ/测试框架指南)
checklist