[Bug][docs]: docs/quant_mode_introduction.md 是与 docs/en/context/ 下同名文件逐字节相同的孤儿副本，其 5 处图片引用在该层级全部破图-ops-ras-AtomGit

Open

[Bug][docs]: docs/quant_mode_introduction.md 是与 docs/en/context/ 下同名文件逐字节相同的孤儿副本，其 5 处图片引用在该层级全部破图 #59

eieieiAdd on Oct 1

Oct 1 Create

现象

docs/quant_mode_introduction.md（docs 目录根级）里 5 处原理图全部指向不存在的文件：

L23  ![Schematic diagram](../figures/pertensor_quantization.png)
L29  ![Schematic diagram](../figures/perchannel_quantization.png)
L35  ![Schematic diagram](../figures/pertoken_quantization.png)
L41  ![Schematic diagram](../figures/pergroup_quantization.png)
L48  ![Schematic diagram](../figures/perblock_quantization.png)

该文件位于 docs/，../figures/ 解析到仓库根目录的 figures/，而仓库根没有 figures/ 目录
（图片实际在 docs/en/figures/）→ 5 张图在页面上全是破图。

关键事实：这是一份孤儿副本

diff docs/quant_mode_introduction.md docs/en/context/quant_mode_introduction.md → 完全相同（0 差异）；
在 docs/en/context/ 这一层，同样的 ../figures/xxx.png 是正确的（解析到 docs/en/figures/，文件都在）；
全仓检索 quant_mode_introduction 的引用，只有 docs/zh/context/basic_concept.md:11 指向 ./quant_mode_introduction.md
（解析到 docs/zh/context/quant_mode_introduction.md，也存在）；没有任何文件引用 docs 根级这份副本。

所以根级这份是移动文件到 en/context/ 时漏删的残留，读者如果从目录树点进去会看到 5 张破图 + 一份重复内容。

建议处置（二选一，都需要维护者定）

删除 docs/quant_mode_introduction.md（推荐：内容与 docs/en/context/ 版逐字节相同，且无人引用）；
若确实要在 docs 根级保留一份入口，则把这 5 行改成 ![Schematic diagram](en/figures/xxx.png)。

我没有直接提 PR，因为"删文件"属于需要作者确认的动作。确认方向后我可以在 5 分钟内提交对应改动。

eieiei

Oct 1 Added label: document

NUAA_wqy

Oct 6 Associated pull request

yue-maCollaborators

Oct 7 Comments：

/assign @NUAA_wqy

CANN-robotCollaborators

Oct 7 Assign NUAA_wqy as responsible person

eieiei

Oct 9 Comments：

同步一条状态（07:49，来自立案人自己）：

修复已在进行：**https://gitcode.com/cann/ops-ras/pull/139**（@NUAA_wqy，单文件删除该孤儿副本）→ 本 Issue 等它合并即可关闭，建议在 PR 正文或合并说明里写 closes #59。
我 10-02 另开的 #63 是同一件事的重复立案，已在该条里留言说明并请维护者关闭；10-07 那次 /assign 把 #59 派给 @NUAA_wqy、#63 派给 @LiuZonggu，重复派活是我的查重失误（只查了 Issue 标题关键词、没查自己名下已有条目），已致歉。
本 Issue 的证据补充一条实测口径：diff <(git show origin/master:docs/quant_mode_introduction.md) <(git show origin/master:docs/en/context/quant_mode_introduction.md) 无输出（逐字节相同），且 git ls-tree origin/master:docs --name-only 里 figures/ 不存在 → 根级副本的 5 处 ../figures/*.png 必然解析不到，而 en/context 版同样写法能解析到，这正好反证它属于 en/context 层级。

zWaNg3

18 days ago Comments：

您好，感谢反馈，证据很完整。

问题分析

已在当前 master（commit 6918d51）复核：

docs/quant_mode_introduction.md 与 docs/en/context/quant_mode_introduction.md 都存在，且 blob SHA 相同，确认逐字节一致；
根级副本第 23、29、35、41、48 行的 ../figures/*.png 从 docs/ 解析到仓库根 figures/，而该目录不存在，5 处引用确实全部破图；同样的写法在 docs/en/context/ 下解析到 docs/en/figures/，这些图片文件均存在；
全仓检索 quant_mode_introduction，除 en/context 与 zh/context 两份同名文件外，只有 docs/zh/context/basic_concept.md:11 的 ./quant_mode_introduction.md 引用，指向 zh/context 版本；没有文件引用 docs 根级副本。

因此同意这是移动文件到 en/context/ 时漏删的孤儿副本，建议直接删除。

处理方向

关联 PR #139 已按删除方案处理，目前为 open、尚未合入，与建议一致；请在 PR 描述或合并说明中带上 closes #59，合入后本 Issue 即可关闭。#63 作为重复立案可在 #59 或 #63 中说明后关闭，修复统一以 #139 为准。

zWaNg3

17 days ago Comments：

/assign @gcw_pDXyHirS

CANN-robotCollaborators

17 days ago Assign gcw_pDXyHirS as responsible person

eieiei

17 days ago Comments：

@LiuZonggu @yue-ma 老师好，本 Issue（[Bug][docs]: docs/quant_mode_introduction.md 是与 do）提交于 2026-10-01，已超过两周暂无处理动态。麻烦老师方便时看一眼：问题是否有效、是否需要我补充复现信息或直接出修复 PR；若已失效或不在范围内，也请告知后关闭。感谢！

eieiei

17 days ago Comments：

【新增两条本机证据 + 一条约定冲突，本条可与 !139 一起收口】

（本地静态复算，2026-10-22 14:04，ref 今天新拉）

这类「整份复制的 Markdown 副本」在 CANN 里是孤例。新写了一条车道：对每个仓 git ls-tree -r -z 取全部 .md 的 blob，找同一 blob 出现在 ≥2 个路径、且把正文里的相对链接在每个路径各解析一遍，只有「某路径有死链 + 同 blob 在另一路径全部解析成功」才算命中（三条件同时成立，避免把「原文写错」误算成「副本位置错」；围栏代码块整块跳过）。扫了 23 个仓：唯一命中就是本条的 docs/quant_mode_introduction.md（blob f31ead144faa…，好位置 docs/en/context/quant_mode_introduction.md，坏位置 5 条 ../figures/*.png 全解析不到）。另外 6 组命中全在 cann-ops-competitions 的参赛队 README（模板里 [.clang-format](.clang-format)，个别队伍没提交那个文件），属各队自有内容、不是模板缺陷，我没算进这条。⇒ 修法只能是删副本，改链接只是把孤儿续命。
它同时还违反本仓自己的双语命名约定：docs/ 根级现存文件每个都有 _en 孪生（README.md/README_en.md、QUICKSTART.md/QUICKSTART_en.md、CONTRIBUTING_DOCS.md/CONTRIBUTING_DOCS_en.md），仓根同理（CHANGELOG、CONTRIBUTING、README、SECURITY）。而 docs/quant_mode_introduction.md 是英文内容占了 X.md 这个中文位、且没有 X_en.md（docs/zh/context/ 里那份中文是另一个 blob fb53beb421…）。这解释了两件事：为什么它会「长」在根级（放英文名进了约定给中文名留的位置），以及为什么没人给它入链。
收口路径：!139 删除该副本，ci-pipeline-passed、mergeable=True、codecheck_Pr ✅。我这边同时把自己那条改链接的 !132 关掉（它的靶子就是这份该删的文件），并留了 head sha 作为 !139 未落地时的兜底。
我自己在这条缺陷上立了两条重复 Issue（#59 与 #63，10-09 已在 #63 留言建议关闭、维护者也确认「同一问题」），但 .contributor 关不掉 Issue：请合并时把 #63 一起关掉，或告诉我要不要在这条下补 /close。

想请模块内的评审同学看一下：如果 !139 这几天能合，本条就可以按「已修复」结；若需要我改成先提别的方案，我按 #59 的做法重开一条单文件 PR 也行。

zWaNg3

9 days ago Comments：

您好，感谢补充证据。已在当前 master（commit 6918d51）复核：

docs/quant_mode_introduction.md 与 docs/en/context/quant_mode_introduction.md 的 blob SHA 相同，确认逐字节一致；
根级副本第 23、29、35、41、48 行的 ../figures/*.png 从 docs/ 解析到仓库根 figures/，该目录不存在，5 处全部破图；同样写法在 docs/en/context/ 下解析到 docs/en/figures/，5 个目标文件均存在；
全仓只有 docs/zh/context/basic_concept.md:11 引用同名文件，指向 docs/zh/context/ 版本；没有文件引用根级副本。

因此同意按方案 1 删除根级副本，改链接只会保留这份孤儿文件。关联 PR #139 已按删除方案处理，当前 open、尚未合入；建议评审合入后关闭本 Issue，#63 作为重复项可一并关闭。您已关闭的 !132 不需要恢复。