已关闭
[Bug-Report|缺陷反馈]: experimental/conversion/fill/README.md 中测试样例链接指向不存在的 test_aclnn_fill.cpp #2457
gcw_93rlw6ed创建于  8月1日关闭于  8月1日
gcw_93rlw6ed
8月1日 创建

一、问题描述 (必填)

文件 experimental/conversion/fill/README.md 第 54 行通过 HTML <a> 标签引用了测试样例文件 ./examples/test_aclnn_fill.cpp,但该文件在仓库中并不存在。

实际 experimental/conversion/fill/examples/ 目录下的测试样例文件为 test_aclnn_fill_scalar.cpptest_aclnn_fill_tensor.cpp 两个文件(分别对应 scalar 和 tensor 两种调用方式),并没有名为 test_aclnn_fill.cpp 的文件。

文档中引用的单一文件名既不存在也覆盖不全,无法引导用户找到正确的样例入口。

二、环境信息 (可选)

  • 仓库:cann/ops-math
  • 分支:master
  • 文件路径:experimental/conversion/fill/README.md
  • 失效引用所在行:54
  • 验证方式:本地 clone master 分支后用 lsfind 验证

三、重现步骤 (可选)

  1. git clone -b master https://gitcode.com/cann/ops-math.git && cd ops-math
  2. 查看引用:sed -n '54p' experimental/conversion/fill/README.md
    输出:<td><a href="./examples/test_aclnn_fill.cpp"> test_aclnn_fill.cpp</a></td><td>通过aclnn调用的方式调用Fill算子。</td>
  3. 验证 target 不存在:ls experimental/conversion/fill/examples/test_aclnn_fill.cpp → No such file or directory
  4. 查找 examples 实际内容:ls experimental/conversion/fill/examples/ → 只有 test_aclnn_fill_scalar.cpptest_aclnn_fill_tensor.cpp
  5. 在 GitCode Web 界面打开 experimental/conversion/fill/README.md,点击第 54 行 test_aclnn_fill.cpp 链接,跳转 404

四、预期结果 (可选)

修复 experimental/conversion/fill/README.md 第 54 行,将失效链接替换为真实存在的样例文件。建议根据实际样例文件拆分为两行,分别指向 scalar 和 tensor 两种调用方式:

  • 修复前(1 行失效链接):
    <a href="./examples/test_aclnn_fill.cpp"> test_aclnn_fill.cpp</a> — 通过aclnn调用的方式调用Fill算子。

  • 修复后(2 行有效链接):
    <a href="./examples/test_aclnn_fill_scalar.cpp"> test_aclnn_fill_scalar.cpp</a> — 通过aclnn调用的方式调用Fill算子(scalar 入参)。
    <a href="./examples/test_aclnn_fill_tensor.cpp"> test_aclnn_fill_tensor.cpp</a> — 通过aclnn调用的方式调用Fill算子(tensor 入参)。

五、修复建议 (可选)

该问题根因疑似 fill 算子在重构中将原 test_aclnn_fill.cpp 拆分为 scalar/tensor 两个样例文件后,未同步更新 README 中的引用。建议:

  1. 修复本文件链接,按实际样例文件拆分引用。
  2. 全仓扫描其他算子 README 中引用 test_aclnn_<op>.cpp 的链接,校验 target 文件是否真实存在。
  3. 可在 CI 文档检查流程中增加「代码文件引用 target 必须真实存在」的校验。

💡 备注(选填)

本 issue 与 issue #2454/#2455/#2456 属同类文档失效引用问题,建议统一在 CI 中增加引用存在性校验。

likedislike
songkai111成员
8月1日 评论:

确实存在问题,已安排相关责任人修复

likedislike
Ssongkai111成员
8月1日 关联了pull request:fix: 修复多个文档中的失效链接(#2455/#2456/#2457/#2458/#2459)
CANN-robotCANN-robot成员
8月1日 关闭了 issue
CANN-robotCANN-robot成员
8月1日 添加了label:resolved