问题描述

对 ops-nn 仓库全部 Markdown 文档做图片引用存在性扫描，发现 48 处图片引用的目标文件在仓库中不存在。被引用路径集中在 docs/zh/figures/（如 PReluGradFusionPass.png、SoftmaxGradExtFusionPass_1.png 等），该目录下这些文件均不存在，读者查看对应算子文档时图片全部无法显示。

与既有 Issue 的区别

#6006 反馈的是图片文件命名不符合规范（含大写字母）；本反馈的核心是被引用的图片文件根本不存在（404）——即使按规范改了名，只要文件不补上，引用依然失效。两个问题需要分别处理：先补齐/恢复图片资源，再统一命名。

规范依据

CANN 社区《文档写作规范》「图片」一节：

【规则】图文配合使用，切忌图文分离。

缺失图片引用样例

（共 48 处，全量清单可用文末复现命令生成。）

影响分析

1. 算子文档可读性受损：失效引用集中在各算子的 FusionPass 说明文档（如 PReluGradFusionPass.md、SoftmaxGradExtFusionPass.md 系列），这些文档开头即引用架构图，图丢失后正文描述难以理解；
2. 与 docs-ci 冲突：resource-existence-check 会将这批引用判为失败；
3. 涉及算子面广：按目录分布涉及 activation、conv、loss 等多个算子族的文档。

修复建议

1. 从历史提交或原始设计材料中找回这批图片，补充到 docs/zh/figures/；
2. 若原始图片无法找回：删除对应引用并改写正文，或补绘新图；
3. 补齐后可结合 #6006 一并统一图片命名（小写+下划线）。

问题复现方式

git clone --depth 1 https://gitcode.com/cann/ops-nn.git
cd ops-nn

# figures 目录下不存在被引用的图片
ls docs/zh/figures/ 2>/dev/null | grep -c "PReluGradFusionPass"   # 0
test -e docs/zh/figures/PReluGradFusionPass.png && echo exists || echo missing

# 引用仍然存在
sed -n '7p' activation/p_relu_grad_update/docs/PReluGradFusionPass.md

影响级别

L2：约 48 处图片引用失效，"图文分离"违反文档写作规范，影响多个算子族文档的可读性；不影响代码功能。