已合并
feat(model): 按 RFC #47 重构推理知识并增加可选 Scope 检索 #143
feat(model): 按 RFC #47 重构推理知识并增加可选 Scope 检索 #143
已合并
汪超创建于 14 天前
汪超成员
14 天前

变更说明

模型推理的机制、优化规则、实现案例和排障步骤混放在 experience 等路径中,同一主题有重复入口,查询也难以区分阶段、执行后端和模型特征。本 PR 按 RFC #47 调整知识职责与导航,并增加显式、可选的模型推理 Scope 匹配。

主要改动

  1. 将 119 项 Optimization、21 张 Guide 迁出 experience,整理模型总览与其他 Concept;规范规则、案例、机制、操作流程和 Runbook 的职责,合并或拆分重复正文,同步导航、链接、Concept ID 引用与回归期望。旧外部路径会失效。
  2. 基于已合入的 PR171 基础治理,在 Query、Ingest、模型知识及评测中接入可选 Scope。显式查询区分 match、unknown、conflict,只排除明确冲突,缺条件保留未知;长短上下文、batch、并发、服务方式、并行和部署拓扑拆为独立维度,objective 精确匹配。无 Scope 时保留原查询流程和排序算法。
  3. 按固定来源核对知识适用范围与实现边界,修正 C8 尺度、padding、图后端/预热、Prefill 回退、缓存与并行等审查问题;两张排障卡迁入 Runbook。12 张原 draft 中 3 张获得依据升级,9 张仍保留证据缺口,未补造 verified。
  4. 评测拒绝从通用 filters 隐藏传入 Scope;保留 Scope 匹配、索引、预检、评审输入校验等可复用代码与回归用例。
  5. 在现有 evals/model_inference_scope_cases.yaml 统一维护 model_scope_01~30 主集,保留 30 道召回正例、33 项必需入口。第 09 题的配置合法性目标改为 bringup;第 21 题保留量化精度比较,查询未定位 draft,不附加 A3 或 latency 条件,答案明确不能确认 A3。A3 stable 的草稿隔离另作过滤回归;删除重复的 A/B 派生用例,不再维护独立 V2 主集。

前置治理合入与冲突处理

PR171 已合入。本轮同步 master,按实际代码保留显式 Scope 查询、Ingest 的 --scope-file 和模型推理目录退役约束;保留上游日志格式 P0、顺序 P1 及 CI 日志快照逻辑。六处治理/Skill/契约冲突按消费能力统一,四份历史日志保留双方全部不同条目并倒序合并。

另修复上游 Kernel 计时诊断卡中两处指向旧 experience 层的引用,仅调整链接目标,原文、Frontmatter 和平台不变。基础阶段的旧路径兼容回归使用未配置目录退役的独立测试配置,生产目录拒绝回归继续启用。完整 PR 差异不含 .gitcode/、一次性报告或本地 RFC。

检视意见修订(2026-10-28)

本轮处理检视意见时,目标 master 又新增 1a0a50cb。已同步该提交并解决唯一的当天日志冲突,保留双方完整历史条目;其新增两张算子卡及导航与目标分支字节一致,不构成本 PR 的额外知识改写。

  • 测试描述:在 evals/test_scope_extensions.py 用容量校验、处理器返回值、路由/Profile 边界及冲突/未知召回等具体用途替换“夹具”表述,保持测试行为与断言不变。
  • L2 范围:修正 ascendc.md 及目录摘要的全平台显式控制泛化;以固定版本 SetL2CacheHint 文档说明产品和缓存模式限制,原平台声明保持不变。
  • 性能依据:对 950PR/DT 的 uint32 直方图模型与 A3 排序估算,给出单 Query、S_k=16384、k=512 的公式及取值方法,并补充局部周期测量和同平台实现对照步骤;约 3.89 仅为跨平台理论周期比,没有新增真机性能结果。

PR 范围

RFC 以 Issue #47 为评审入口。代码差异包含知识、治理与 Skill 实现、必要文档/导航/日志及可复用测试;一次性实验和审查记录在作者本地保留,不纳入代码差异。

变更类型

验证

本轮本地验证(2026-10-28)

提交 c86f6028,同步目标 master d95b5c69。本轮仅 logs/2026-10-28.md 发生冲突,双方 14 条不同记录均完整保留并按时间倒序合并。模型知识、Scope、Skill 与测试实现相对 9aadebde 不变;上游 Catlass DSL 知识和导航原样保留。完整 PR 差异不含 .gitcode/、一次性报告或本地 RFC。

严格全库 Lint 检查 9154 个 Markdown,P0/P1/P2 均为 0;721 个目录索引无陈旧项,8433 张卡片完成索引构建和完整校验。72 题原检索门禁通过(Recall 0.560、MRR 0.466);215 条模型 Scope 回归全部通过(Recall 1.000、MRR 0.953)。A3 与 950 定向查询均首位命中原 AscendC 卡。

本地 FormatCheck 9154 文件零 Finding,GraphCheck 8433 节点、18263 条边;另有 36 项 trace 回归、1935 张 Runbook 字段笔记硬检查、Ruff、Shell 语法及固定文档差异检查通过。111 张存量卡片缺少适用场景的非阻断提示仍保留。这些是本地执行结果,不代表云端 CI 已通过。

bash check.sh 已在本轮合并树上完整执行,因两项文档存量失败退出 1:415 项单测中 413 项通过、2 项失败、无跳过。失败仍为 test_governance_specs_keep_five_focused_entries(上游已有 refinery.md)和 test_markdown_structure(375 个与目标分支字节一致的存量文件);两项测试方法与最新目标相同。本次没有修改无关知识或放宽检查。

下方 30 题 A/B 保留原实验与数据,本轮机器回归未替代适用性评审,也没有新增设备性能测量。

最新 A/B:当前 30 题主集(2026-10-23)

本轮重新执行 A 7ea0efbe(迁移前基线)与 B 07ce2a9e(当前提交),使用现有 evals/model_inference_scope_cases.yaml 的 model_scope_01~30,保留 30 道召回正例、33 项必需入口。查询文字和支持的过滤条件一致;A 沿用原 Query,B 在声明条件时使用 Scope。第 09 题使用 bringup;第 21 题保留精度比较,查询未定位 draft,不传平台或 latency Scope。

指标 A B
严格 ID Recall@5(按题等权,主指标) 78.3% 98.3%
必需入口命中数 26/33 32/33
全部必需入口均命中的题数 23/30 29/30
非空召回率 96.7%(29/30) 100.0%(30/30)
Scope precision@5(模型判定) 0.7% 1.4%
Conflict rate@5(模型判定) 4.8% 0.7%
Unknown rate@5(模型判定) 94.5% 97.9%
实际返回项数 145 150

Scope 比率只覆盖 29 道显式 Scope 题,两侧分母均为 145 项。模型判定的匹配/冲突/未知数量分别为 A 1/7/137,B 2/1/142。第 21 题不计入 Scope 比率,但始终计入 30 题 Recall 和非空召回分母;未知不视为匹配或明确冲突。主题相关性另判,两侧无关项分别为 21/44,不能将其自动算作 Scope 冲突。

B 的规范入口命中改善、明确冲突减少;但已确认适用项仅 2/145,未知率升至 97.9%,主题无关项由 21/145(14.5%)增至 44/150(29.3%)。这些结果不能证明整体决策质量提高或正式验收通过。

likedislike
Pull Request已成功合入, 合并人@CANN-robot
(感谢 汪超 的贡献)
汪汪超成员
14 天前 创建了 pull request,commit fd3dd23d
汪汪超成员
14 天前 关联了issue:[RFC] 优化模型推理知识的分类、结构和检索范围
汪汪超成员
14 天前 预合并成功(commit_id: 53f97d8b2395bd8c5f73db758fbb46614d0336d2)
汪汪超成员
14 天前 推送  8 个提交:fd3dd23d-7 commits from branch master,e234393b-merge: resolve PR #143 conflicts with upstream master
汪汪超成员
14 天前 预合并成功(commit_id: 573077093888554b623ca9b5e65979d1220c9a84)
此处折叠了84条消息 查看更多
CANN-robotCANN-robot成员
8 天前 添加了label:ci-pipeline-passed
zhanghz1
zhanghz1成员
8 天前 评论:

/lgtm

likedislike
wangshaojun
wangshaojun成员
8 天前 评论:

/approve

likedislike
CANN-robotCANN-robot成员
8 天前 添加了label:lgtmapproved
CANN-robotCANN-robot成员
8 天前 合入了pull request