[L2] docs/quant_mode_introduction.md 是 docs/en/context/ 同名文件的逐字节副本，但它这里的 5 张图路径解析不到-ops-ras-AtomGit

Open

[L2] docs/quant_mode_introduction.md 是 docs/en/context/ 同名文件的逐字节副本，但它这里的 5 张图路径解析不到 #63

eieieiAdd on Oct 2

eieiei

Oct 2 Create

级别判断

L2（读者在这一页看不到任何一张示意图；且该文件与仓库的 en/zh 目录约定冲突，需要维护者定去留）

问题

docs/quant_mode_introduction.md 与 docs/en/context/quant_mode_introduction.md 内容逐字节相同：

GET /repos/cann/ops-ras/contents/docs/quant_mode_introduction.md?ref=master        md5=5fb94cc6ab8a  5939 字节
GET /repos/cann/ops-ras/contents/docs/en/context/quant_mode_introduction.md?ref=master  md5=5fb94cc6ab8a  5939 字节
GET /repos/cann/ops-ras/contents/docs/zh/context/quant_mode_introduction.md?ref=master  md5=0346b65d557b  4272 字节（中文版另有内容）

问题是这份"根级副本"里的图片是相对路径 ../figures/xxx.png：

放在 docs/en/context/ 时，../figures/ = docs/en/figures/ —— 5 张图都在（docs/en/figures 有 56 个条目，pertensor_quantization.png contents API 确认 type=file）；
放在 docs/ 时，../figures/ = docs/figures/，而这个目录不存在（GET /repos/cann/ops-ras/contents/docs/figures?ref=master → 404）。

所以打开 docs/quant_mode_introduction.md 这一页，5 张"原理图"全部显示不出来：

第 23/29/35/41/48 行：![Schematic diagram](../figures/pertensor|perchannel|pertoken|pergroup|perblock _quantization.png)

另外这一份是英文内容却放在 docs/ 根下，与仓库既定的 docs/zh/... + docs/en/... 双份约定不一致
（同目录的 README.md/QUICKSTART.md/CONTRIBUTING_DOCS.md 都是"中英各一份且带 _en 后缀"的形式）。

建议

三选一，都能让这一页正常显示：

删除这份根级重复（推荐——它与 docs/en/context/ 那份逐字节相同，删掉不损失任何内容）；
或者把它挪进某个 context/ 目录，让 ../figures/ 重新指向存在的图片目录；
或者把图片路径改成 en/figures/...（但这样就与 en/zh 两份的组织方式不一致，不如前两种）。

我没有直接提删除 PR：删文件属于内容决策（万一这一份是刻意留在根级给某个入口用的），
你们定一个口径我立刻执行；如果选 1，我一个 PR 就能清掉（只有这 1 个文件）。

yue-maCollaborators

Oct 7 Comments：

/assign @LiuZonggu

CANN-robotCollaborators

Oct 7 Assign LiuZonggu as responsible person

eieiei

Oct 9 Comments：

这条是我自己的重复立案，建议关闭：同一缺陷早在 2026-10-01 已由我立案 #59（《docs/quant_mode_introduction.md 是与 docs/en/context/ 下同名文件逐字节相同的孤儿副本，其 5 处图片引用在该层级全部破图》），10-02 我又开了这条 #63，内容重叠。

更糟的是这个重复造成了实际的评审负担：10-07 18:29/18:31 两次 /assign 把同一个缺陷分别派给了两位同学（#59 → @NUAA_wqy，#63 → @LiuZonggu）。而修复其实已经有人在做：**https://gitcode.com/cann/ops-ras/pull/139**（@NUAA_wqy，10-06 提出，标题就是 docs: remove orphaned duplicate of docs/en/context/quant_mode_introduction.md，只动这一个文件）。

所以我做两件事：① 主动把 #63 关掉（state_event: close），避免 @LiuZonggu 重复投入；② 保留 #59 作为主条目，等 !139 合并后由 @NUAA_wqy 或维护者一并关闭即可。给两位被派到同一件事的同学道歉，是我的查重没做到位——我只查了 Issue 标题里的文件名，没先查自己名下已有的 Issue。

（顺带一条与本条无关但同目录的信息：!141 把 31 个中文图片文件名规范成英文并同步更新引用，那是 #64 的范围；docs/zh/figures/ 的中文命名素材在现状下是能解析到的，所以 #64 讲的是 en/zh 混用那一类，与本条孤儿副本不是同一件事。）

补充（07:49）：我没有权限用 API 关闭这条，麻烦 @yue-ma 或 @LiuZonggu 点一下关闭。 我把能试的都试了：PATCH /repos/cann/ops-ras/issues/63 带 {"state_event":"close"} 返回 200 但 state 仍是 open（该字段被忽略）；同时带 state 字段时接口回 'state_event': input must in [reopen, close]；PUT /issues/63、PATCH /issues/63/state、POST /issues/63/close 都是 404（路由不存在）。所以只能由有权限的人关掉，或者等 !139 合并时由其正文写 closes #59 一并带走（#63 请手工关）。@LiuZonggu 这条不需要你做修复，缺陷已被 #59 + !139 覆盖，抱歉占了你一次分派。

zWaNg3

18 days ago Comments：

您好，感谢补充说明，确认本 Issue 与 #59 是同一问题。

问题分析

我们在当前 master（commit 6918d51）复核了两条 Issue 指向的事实：根级 docs/quant_mode_introduction.md 与 docs/en/context/quant_mode_introduction.md 的 blob SHA 相同，确认逐字节一致；根级副本的 5 处 ../figures/*_quantization.png 由于 docs/figures 不存在而全部破图，而 docs/en/figures 共有 56 个条目、这 5 张图片均存在；全仓也没有文件引用根级副本。结论与 #59 一致。

处理方向

本 Issue 是 #59 的重复立案，不需要单独修复，也不建议再让 LiuZonggu 重复投入。修复统一由 #59 / PR #139（删除孤儿副本）跟踪，合并后关闭 #59；建议本条直接关闭。#64 涉及的图片重命名是另一件事，与本条无关。

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（[L2] docs/quant_mode_introduction.md 是 docs/en/con）提交于 2026-10-02，已超过两周暂无处理动态。麻烦老师方便时看一眼：问题是否有效、是否需要我补充复现信息或直接出修复 PR；若已失效或不在范围内，也请告知后关闭。感谢！

zWaNg3

9 days ago Comments：

您好，感谢跟进。本 Issue 与 #59 是同一问题：根级 docs/quant_mode_introduction.md 与 docs/en/context/quant_mode_introduction.md 的 blob SHA 相同、逐字节一致；根级副本的 5 处 ../figures/*.png 全部解析不到，而同样的写法在 docs/en/context/ 下 5 张图都能解析；全仓也没有文件引用根级副本。

修复统一由 #59 / PR #139 的删除方案跟踪，本 Issue 不需要单独修复，也不需要再补充复现信息或提交新的 PR。建议关闭本 Issue，保留 #59 作为跟踪条目。

eieiei

7 days ago Comments：

按 zWaNg33 老师判定：本条与 #59 为同一问题。按重复关闭本条，跟进统一在 #59。感谢查重！

zWaNg3

2 days ago Comments：

收到，感谢确认。本条按 #59 的重复项关闭，后续跟进统一在 #59 / PR #139，不再单独处理。