已合并
feat(knowledge): 镜像同步 cann_docs_raw 20261020 快照（c_api 重构迁移与工具 frontmatter 剥离） #139
qixingkai创建于 5 天前
feat(knowledge): 镜像同步 cann_docs_raw 20261020 快照（c_api 重构迁移与工具 frontmatter 剥离） #139
已合并
Pull Request已成功合入, 合并人@CANN-robot
（感谢 qixingkai 的贡献）5 天前 预合并成功（commit_id: 7e50a37bf88d0f8228dd94252fc248dacd3ba9d4）
5 天前 预合并成功（commit_id: b7c7939ee8c6a824ce2796a615128d4a2c24ba8c）
5 天前 添加了label：cann-cla/yes
5 天前 添加了label：stat/needs-squash
CANN-robot
5 天前 评论：
5 天前 评论：
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.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.
PR Approval Progress
✅ Congratulations! All modules have met the lgtm and approve requirements.
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| repo-cann/cannbot-knowledge | ✅ zhanghz1, qq_41667743 (2/2) | ✅ zhanghz1 (1/1) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
qixingkai, thanks for your pull request. All authors of the commits have signed the CLA. 👍
5 天前 修改了pull request 的描述
qixingkai
4 天前 评论：
4 天前 评论：
/compile
4 天前 预合并成功（commit_id: 6c52d8b0aed73c51248e6f515ee09c5f11e4729c）
CANN-robot
4 天前 评论：
4 天前 评论：
| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |
4 天前 添加了label：ci-pipeline-running
4 天前 删除了label：ci-pipeline-running
4 天前 添加了label：ci-pipeline-failed
4 天前 修改了pull request 的描述
CANN-robot
4 天前 评论：
4 天前 评论：
流水线分析报告 — cannbot-knowledge run#245
流水线: 1f7fbdf1e3534672a82af5fa32ee11b4 | PR#139 | 2026-10-21 13:39:12 ~ 13:41:50 | 失败 Job 1 个
定界结论: 工程问题 / 存量基线问题 — catlass 路由已注册但内容 PR 未合入, 与本 PR 变更无关
- 失败类型: 工程问题(存量基线) — 非 PR#139 变更导致, 提交者无需改代码
- 根因: master 基线上
governance/schemas/registries.yaml已声明catlass技术(要求knowledge/ops/catlass目录存在), 但提供该目录的内容 PR#128 尚未合入; PR#139 的合并快照不含 catlass 目录, 触发 FormatCheck P0 - 处置建议: ① 维护者优先合入 PR#128(catlass 内容), 之后重新触发 PR#139 流水线即可通过; ② 若 PR#128 短期无法合入, PR#139 可参照 PR#136 做法临时带入
knowledge/ops/catlass/index.md占位过门禁 - 排除项: 非 PR#139 文档/代码变更导致(其 7341 个变更文件均在 ascendc 域, 无任何 catlass 路径); 非环境/网络问题(Checkout 正常, 检查完整执行 8878 个 Markdown)
失败根因分析
根因 #1: 工程问题 / 存量基线问题 — FormatCheck 报 knowledge/ops/catlass 路由目录缺失
- 定位步骤:
3_Run FormatCheck.log - 影响 Job: FormatCheck(唯一失败 Job, 其余 Job 均通过或未受影响)
- 根因证据(日志原文):
## FormatCheck · ❌ 未通过
- 已检查：`8878` 个 Markdown
- Findings：`1`（P0 `1` · P1 `0` · P2 `0`）
| 等级 | 检查 | 文件 | 说明 |
|---|---|---|---|
| P0 | `navigation/structure.missing` | knowledge/ops/catlass | required domain or predeclared route directory is missing |
::error::Process exited with code 1
-
证据链(为何与本 PR 无关):
- PR#139(文档镜像同步, 7341 个变更文件)仅触碰
knowledge/ops/ascendc域及 4 个脚本/配置文件, 无任何 catlass 路径; - master 与本 run 合并快照(6c52d8b0)的
knowledge/ops/下仅有ascendc/pypto/shared/tilelang/triton, 均无 catlass 目录; - master 的
governance/schemas/registries.yaml已声明catlass技术(type: ascendc, domains: [ops]), 由 PR#122「注册 catlass technology 作为 CATLASS route 的规则」于 2026-10-20 19:33:57 合入(commit 654f897d17); - 提供该目录内容的 PR#128「迁入 CATLASS route 的 36 张算子知识卡」仍 open 未合入;
- 时间线佐证: PR#122 合入前的各 PR runs 均通过; 合入后, 含 catlass 内容的 PR#128(run#243)与 PR#136(自带
knowledge/ops/catlass/index.md, run#244)均通过, 而不含 catlass 内容的 PR#139(run#245)即失败。
- PR#139(文档镜像同步, 7341 个变更文件)仅触碰
-
结论: 路由注册(PR#122)与内容供给(PR#128)的合入顺序错配, 使 master 基线对"不含 catlass 内容的 PR"必然产生此 P0, 属仓库治理基线问题, 需维护者处置。
结构化定界摘要
[{"repo": "cannbot-knowledge", "run_number": 245, "Failed_Type": "工程问题",
"Failed_Sub_Type": "存量基线问题",
"Failed_Reason": "PR#122(2026-10-20 19:33:57合入)在governance/schemas/registries.yaml注册catlass路由, 要求knowledge/ops/catlass目录存在, 但内容PR#128尚未合入, 不含catlass内容的PR#139触发FormatCheck P0 structure.missing; 与本PR变更(仅ascendc域)无关",
"evidence": "| P0 | `navigation/structure.missing` | knowledge/ops/catlass | required domain or predeclared route directory is missing |",
"suggestion": "维护者先合入PR#128(catlass内容)后重新触发PR#139; 或PR#139参照PR#136临时带入knowledge/ops/catlass/index.md占位过门禁",
"jobs": "FormatCheck"}]
由门禁失败定界分析自动生成 | repo: cannbot-knowledge | run: 1f7fbdf1e3534672a82af5fa32ee11b4 | PR#139
4 天前 修改了pull request 的描述
此处折叠了6条事件消息 查看更多
4 天前 修改了pull request 的描述
qixingkai
4 天前 评论：
4 天前 评论：
/compile
4 天前 预合并成功（commit_id: dde3c0b9df66615a0ba038e952bbda7397c64789）
CANN-robot
4 天前 评论：
4 天前 评论：
| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |
4 天前 删除了label：ci-pipeline-failed
此处折叠了8条事件消息 查看更多
4 天前 删除了label：ci-pipeline-passed
CANN-robot
4 天前 评论：
4 天前 评论：
qixingkai
4 天前 评论：
4 天前 评论：
/compile
4 天前 预合并成功（commit_id: 06822c341bb910d4b3be9461765f73993cadc0c1）
CANN-robot
4 天前 评论：
4 天前 评论：
| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |
4 天前 添加了label：ci-pipeline-running
4 天前 删除了label：ci-pipeline-running
4 天前 添加了label：ci-pipeline-passed
zhanghz1
4 天前 评论：
4 天前 评论：
/approve
4 天前 添加了label：lgtmapproved
4 天前 合入了pull request
变更说明
a0011f0f，与 #137 内容字节级一致），本 PR 可独立合入；若本 PR 先行合入，#137 可关闭为 superseded；若 #137 先合，本 PR diff 自动收敛为纯同步 diff。fixed_archive_docs.py sync --updated-at 2026-10-20T07:46:54Z将全量镜像卡对齐 20261020 固定日期快照。上游 09-29~10-12 将api/SIMD-API/c_api/扁平结构重构为主题子目录（mmad_compute、cube_compute_load/store、inter/intra_core_sync 等），并新增 tensor_api reg_vector_compute、mc2、data_move_guide、defs 等新文档：deprecated_interface/加_deprecated后缀（上游弃用）；2 个原弃用文档解除弃用迁至cube_compute_store/fixed_archive_docs.py新增strip_source_frontmatter()——上游在asc_abs.md头部引入 YAML frontmatter（okftype孤例，3732 个源文档中唯一），原实现泄漏进镜像卡正文触发结构测试失败；现剥离可解析为 YAML mapping 的前导块，非 mapping 原样保留；深度消费上游元数据待格式推广后另行 RFC，当前仅"识别并忽略"级兼容navigation/structure.missing | knowledge/ops/catlass根因为上游合入顺序错配——PR#122（654f897d，10-20 19:33）注册了 catlass technology，但供给内容的 PR#128（36 张卡）与自带占位 index 的 PR#136 均未合入，master 基线因此对任何不含 catlass 内容的 PR 必然触发该 P0（时间线佐证：#122 合入前各 run 通过；含 catlass 内容的 run#243/#244 通过；不含的 run#245 失败）。本 PR 补齐预建路由占位knowledge/ops/catlass/index.md（与 PR#136 已过 CI 版本字节一致）并同步父级knowledge/ops/index.md，本地format_check.py复现 P0 后修复归零（checked=8879，Findings 0）。fixed_archive_docs.py与evals/test_governance.py两个文件。变更类型
验证
定向验证（最新基线 be5882ef 上）：CI FormatCheck 对应的
format_check.py本地 P0=0（checked=8879）；全库knowledge_lint --strict-navigationP0=0 P1=0 P2=0；召回验证：asc_mmad（literal，新路径排名第 1）、asc_set_l0c2gm_config_deprecated（弃用卡排名第 1）均可检索。