| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
fix(sources): 注册 Recipes 本地来源与固定提交 Co-authored-by: qq_41667743<wangchao725@huawei.com> # message auto-generated for no-merge-commit merge: !187 merge register_recipes_sources into master fix(sources): 注册 Recipes 本地来源与固定提交 Created-by: qq_41667743 Commit-by: qq_41667743 Merged-by: cann-robot Description: PR #183 将模型知识的来源改为 cann-recipes-raw/...，但 CI 使用目标分支的治理与工具，只叠加 PR 的 knowledge/ 和 logs/。同一知识 PR 中的来源登记尚未合入，因此 LQC 等卡片报 source.resource 和 link.outside_bundle。 本 PR 先行登记 10 个 Recipes 及依赖仓，每仓只绑定一个与 #183 一致的固定提交，并拆出必要的资源恢复、工作项解析、忽略规则、文档和接受/拒绝回归。模型知识正文更新继续由 #183 交付。 验证： - 独立注册分支：全库 Lint P0/P1/P2=0，723 个导航无陈旧项，8440 张卡的索引完整校验通过；72 项通用检索达到门槛，215 项模型回归全部通过。 - 复现可信 CI：登记前 1162 条来源错误、1060 条链接错误；叠加登记后，#183 的 FormatCheck 为 9200 项、0 findings，GraphCheck 为 8466 节点、17914 边，均通过。 - bash check.sh 完整单测 425 项，422 通过、1 跳过、2 项与目标分支完全相同的既有文档失败（Spec 数量约定、375 条 Markdown 结构问题）；后续轨迹测试、运行手册硬约束、Ruff、Shell 语法和归档 diff-check 独立通过。 合入顺序：先合入本 PR，再合入 [#183](https://gitcode.com/cann/cannbot-knowledge/pull/183)。 See merge request: cann/cannbot-knowledge!187 | 6 天前 | |
docs: 修正 okf.md 悬空的知识卡示例路径 Co-authored-by: lizhe<147392333@qq.com> # message auto-generated for no-merge-commit merge: !98 merge fix-35-okf-dangling-example into master docs: 修正 okf.md 悬空的知识卡示例路径 Created-by: lizhe_li Commit-by: lizhe Merged-by: cann-robot Description: ## 背景 governance/specs/okf.md 的 Concept ID 示例引用了全仓不存在的知识卡路径： - 示例引用：knowledge/ops/ascendc/apis/datacopypad_gm_to_ub.md - master 核实：find knowledge -iname "*datacopypad*" 下无 apis/ 路径的卡，该 .md 全仓不存在。 ## 修改 把该示例替换为仓内真实存在的知识卡： - knowledge/ops/ascendc/runbooks/compilation/datacopypad_gm_to_ub_requires_pad_params.md - 对应 Concept ID：ops/ascendc/runbooks/compilation/datacopypad_gm_to_ub_requires_pad_params 该示例仅用于演示「Bundle 内相对路径 → Concept ID」的推导，替换后仍满足演示语义，且所举卡片真实存在。 ## 验证 - 新路径存在、旧路径不存在（Test-Path 分别 True / False）； - 文档中的 Concept ID 字符串与路径去掉 knowledge/ 前缀及 .md 后缀后逐字符一致； - 全仓 grep 后，规范中该悬空示例已消除。 ## 范围 仅修改 governance/specs/okf.md 一行示例；不新建知识卡、不改动任何 knowledge/ 正文内容。 Fixes #35 See merge request: cann/cannbot-knowledge!98 | 1 天前 | |
feat(governance): 注册 tools 知识域（直辖 concepts Profile） Co-authored-by: jinyingqi<jinyingqi@huawei.com> # message auto-generated for no-merge-commit merge: !238 merge governance-register-tools into master feat(governance): 注册 tools 知识域（直辖 concepts Profile） Created-by: jinyingqi Commit-by: jinyingqi Merged-by: cann-robot Description: ## 变更说明 - 关联：Issue #101（工具知识）的治理前置；由原 PR #233 **拆分而来**（#233 同时注册 tools 域与 debugging Profile，按检视意见拆为两个独立 PR，本 PR 是其一；其二为注册 debugging Profile 的 PR）。 - 主要改动（纯治理，知识树与 logs 与 master 完全一致）： 1. governance/schemas/registries.yaml：domains 新增 tools（描述：CANN 工具的使用契约、产物结构与结论边界；direct_types: [concepts]，路径形态 knowledge/tools/concepts/<卡>.md）； 2. governance/specs/paths.md：Domain-route 矩阵补 tools 行；合法/非法路径示例各补一条（knowledge/tools/concepts/*.md 合法；缺 concepts 层的 knowledge/tools/<卡>.md 非法）。 - 新规则消费者：Issue #101 的三个工具知识 PR（#216/#217/#219，落位 knowledge/tools/concepts/；#216 一并物化 tools 域入口、Bundle 根条目与结构物化期望集）。 - 合入顺序：本 PR 先合入 → 工具知识 PR 重新触发 compile 转绿（PR CI 以目标分支治理校验 PR 知识树）。 - 已知过渡态（与先例 !23 register contrib domain 相同）：本 PR 合入后、#216 合入前，本仓自身治理下 knowledge/tools 域根未物化会触发 structure.missing 与 3 项 current-state 用例失败，由紧随其后的 #216 消除；本 PR 的 CI 不受影响（知识树与 master 一致）。 ## 变更类型 - [ ] 知识卡 - [x] 治理规则（Schema / Profile / Registry / Contract / Spec） - [ ] Knowledge Skill（Ingest / Query / Lint） - [ ] 检索、评测或测试 - [ ] 安装、脚本、依赖或 CI - [ ] 文档 - [ ] 其他： ## 验证 - [x] PR 知识树与 logs 与 master 完全一致（git diff origin/master -- knowledge/ logs/ 为空）——CI 以 master 治理校验时复现 master 基线（绿） - [x] 本分支自身治理下 Contract 抽查：knowledge/tools/concepts/npu_check_usage.md 被接受；knowledge/tools/npu_check_usage.md（缺 concepts 层）被拒绝 - [x] YAML 语法与 domains 校验通过（Contract 加载无异常） - [x] 未提交敏感信息或 artifacts/ 产物 ## 合入顺序 本 PR → （debugging 注册 PR，二者独立无依赖）→ 工具知识 PR #216/#217/#219。 See merge request: cann/cannbot-knowledge!238 | 2 小时前 | |
docs(governance): 精炼规约预案——去中心、递归自我改进的知识精炼分支(未启用,供评审) Co-authored-by: lczheng<zhenglingchao@huawei.com> # message auto-generated for no-merge-commit merge: !169 merge spec-refinery into master docs(governance): 精炼规约预案——去中心、递归自我改进的知识精炼分支(未启用,供评审) Created-by: lczheng Commit-by: lczheng Merged-by: cann-robot Description: ## 变更说明 提出一套在本仓长期分支上运行的去中心、**递归自我改进**(RSI)的知识精炼机制:粗料宽进、蒸馏严出,主张须由两个不同账号在各自设备上复跑后才算确立,按周期把成品回灌 master 上一个独立于 knowledge/ 的成品目录。回路是闭合的:工位干活时消费自己蒸馏出的成品,失败和缺口变成新订单、订单再生订单,检查器随坏样例成长——库在长,长库的系统也在长。目标是为 CANN 与算子开发沉淀一层 AI 原生、可按证据链复核的知识。本 PR 只提交规约文本供评审,机制未启用。 - 关联 Issue:无(预案文本直接提交评审;预案内 §6 已说明日后实际过境的贡献材料仍按仓库届时适用的流程准备) - 主要改动:新增 governance/specs/refinery.md;README 治理规范列表加一行链接;logs/ 记一条 - 补充说明:两件事在预案内作为待批准事项明文列出、获准前不生效——① 独立成品目录的结构扩展(不进 knowledge/,不碰其 Bundle/Concept ID/索引规矩,所需同步的消费者已列明);② 自动化边界(不引入自动提交/合并的仓库脚本与 Skill,代理贡献者与 CONTRIBUTING §2/§7 的适用关系请评审确认)。未包含:任何机器规则、Schema、Contract、Skill 变更。 ## 变更类型 - [x] 治理规则(Schema / Profile / Registry / Contract / Spec) - [x] 文档 ## 验证 - [ ] bash check.sh:本地环境存在偶发文件读取错误,完整套件未能在本地稳定跑完;与本次变更相关的检查已本地通过(知识 Lint 对含新增三文件的全库 9026 个文件 P0/P1/P2 全零、索引同步检查 712 个索引零过期、README 链接与日志格式合规),完整结果以仓库 CI 为准 - [x] 已按需同步导航、链接、日志 - [x] 未提交敏感信息、大段上游原文或可重建产物 - [x] 变更保持最小、相关,并符合 CONTRIBUTING.md See merge request: cann/cannbot-knowledge!169 | 9 天前 | |
feat(model): 按 RFC #47 重构推理知识并增加可选 Scope 检索 Co-authored-by: qq_41667743<wangchao725@huawei.com> # message auto-generated for no-merge-commit merge: !143 merge modify_model_knowledge into master feat(model): 按 RFC #47 重构推理知识并增加可选 Scope 检索 Created-by: qq_41667743 Commit-by: qq_41667743 Merged-by: cann-robot Description: ## 变更说明 模型推理的机制、优化规则、实现案例和排障步骤混放在 experience 等路径中，同一主题有重复入口，查询也难以区分阶段、执行后端和模型特征。本 PR 按 [RFC #47](https://gitcode.com/cann/cannbot-knowledge/issues/47) 调整知识职责与导航，并增加显式、可选的模型推理 Scope 匹配。 ### 主要改动 1. 将 119 项 Optimization、21 张 Guide 迁出 experience，整理模型总览与其他 Concept；规范规则、案例、机制、操作流程和 Runbook 的职责，合并或拆分重复正文，同步导航、链接、Concept ID 引用与回归期望。旧外部路径会失效。 2. 基于已合入的 [PR171](https://gitcode.com/cann/cannbot-knowledge/merge_requests/171) 基础治理，在 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 实现、必要文档/导航/日志及可复用测试；一次性实验和审查记录在作者本地保留，不纳入代码差异。 ## 变更类型 <!-- 可多选。 --> - [x] 知识卡 - [x] 治理规则（Schema / Profile / Registry / Contract / Spec） - [ ] Knowledge Skill（Ingest / Query / Lint） - [x] 检索、评测或测试 - [ ] 安装、脚本、依赖或 CI - [x] 文档 - [ ] 其他： ## 验证 - [x] 已执行 bash check.sh，本轮结果如下；未宣称完整门禁通过。 - [x] 已按需同步导航、链接、日志、规则消费者、文档和测试 - [x] 未提交敏感信息、大段上游原文或 artifacts/ 等可重建产物 - [x] 变更保持最小、相关，并符合 CONTRIBUTING.md ### 本轮本地验证（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%）。这些结果不能证明整体决策质量提高或正式验收通过。 See merge request: cann/cannbot-knowledge!143 | 8 天前 | |
feat(runtime): 优化 runtime API 选型Skill，接入专用全平台检索 Co-authored-by: Hou_jialin<houjialin3@huawei.com> # message auto-generated for no-merge-commit merge: !193 merge br_runtime_api_knowledge_query into master feat(runtime): 优化 runtime API 选型Skill，接入专用全平台检索 Created-by: Hou_jialin Commit-by: Hou_jialin Merged-by: cann-robot Description: ## 变更说明 新增 Runtime API 只读推荐 Skill，按需求初筛同族接口、阅读全文核对关键差异，并用简洁结论给出主接口、必要配套和适用范围。支持场景选型、已知接口核对、接口比较及有映射证据的 CUDA 候选替代。关联 [RFC #83](https://gitcode.com/cann/cannbot-knowledge/issues/83)。 - 先按模块导航收口候选，再核对时序、接口层、参数、资源归属、调用顺序与平台范围；决定取舍的差异须由卡片正文支持。 - 复用既有标签区分公开 C 与 C++ 扩展；C++ 程序保留公开 C 候选。多个接口均满足需求时给出有依据的主推荐或条件分支，不强造唯一性。 - 回答按推荐结论、关键注意、平台注意、自验证组织，限制条数与行数，正文汉字参考上限 350，避免重复参数表和检索过程叙述；平台、补搜、迁移和样例细则放入 references。 - 明确或项目缺省平台优先；缺少可解析平台且无项目缺省时，使用 Runtime 专用全平台候选扩展。准确接口缺定义时独立跨平台复查，未定位草稿另查；区分未收录、支持待确认与来源明确不支持。 - Query 只新增受限的 Runtime 扩展，不改变其他领域的默认过滤；候选并集不证明目标产品可用，诊断 receipt 不作为目标平台 ready 依据。 - 接入安装器、项目路由和必要文档。新增 12 条确定性召回与接口层过滤回归，由 check.sh 单独运行，不并入通用质量阈值分母。 - 日志统一到 11-02 原有 Runtime 条目；不包含知识卡、CUDA 映射卡、Registry 变更、.gitcode 修改或本地问答评测产物。 ## 验证 当前提交： d6117bf74c1db82f78e4565b35cfa5df7a84488f；已同步源端 c7609c5a17d86c25a593fa96ea64e1d9f9e7f2ca，保持单提交。 - Linux 临时快照执行 bash check.sh，退出码 1：完整单测 469 项，仅 2 项源端同样失败、1 项跳过。两项分别为 Spec 文件数量和 374 张存量文档首标题检查，已在源端 c7609c5a17d86c25a593fa96ea64e1d9f9e7f2ca 的干净快照逐项复现；没有新增失败。 - 全库 Lint：9771，P0=0、P1=2、P2=0；两项 P1 是本 PR 未修改的 10-29/10-31 日志排序提示。757 个导航索引 stale=0；9014 张卡的索引构建与 full 校验通过。 - 通用检索 75 例通过质量门禁（Recall@k=0.582、MRR=0.490）；模型场景 217 例通过（1.000/0.951）；Runtime 选型召回与接口层过滤 12/12 通过（1.000/0.889）。 - 41 项定向检查、38 项 trace 回归、field-notes HARD 约束、Ruff、Shell 语法及官方归档 diff-check 均通过。 - 已通过当前 PR 的 compile 评论重新触发 CI，结果以流水线为准。 See merge request: cann/cannbot-knowledge!193 | 1 天前 |
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 6 天前 | ||
| 1 天前 | ||
| 2 小时前 | ||
| 9 天前 | ||
| 8 天前 | ||
| 1 天前 |