贡献范围更新与提交前质量门禁协调
本 Issue 的拟贡献范围现冻结为 36 份 OKF 知识文件：25 份新增、11 份补充已有卡；22 份 Guide、14 份 Runbook。本评论更新后续贡献范围；原正文中九卡及 ef37 基线的通过记录保留为当时历史，不代表下面当前版本的验收结果。
内容覆盖数据搬运与对齐、接口和输出合同、数值语义与归约边界、UB 分配和生命周期、驻留与流式回退、构建注册及运行诊断。来源、适用范围和验证强度逐卡限定：固定官方来源、静态源码、CPU检查和历史运行观察分别陈述，不把历史完整提交成绩归因于某个单独机制，不补造平台、版本、verified或新的设备性能结论。
本批仅包含知识、必要导航和日志；检索、索引、评测、阈值及质量用例均保持上游原样，其他排序研究不纳入知识 PR。
当前复验
远程 master 本轮确认为 7ea0efbeb79f2559f121fa8514a9fe5c82245807，与原冻结基线一致。分别在干净固定上游及该上游加冻结36份贡献的独立副本上执行原始完整 bash check.sh。
| 副本 | 知识树Markdown文件 | Recall@5 | MRR | MISS | check.sh退出码 |
|---|---|---|---|---|---|
| 干净固定上游 | 8355 | 0.548 | 0.443 | 27 | 1 |
| 固定上游 + 冻结36份贡献 | 8380 | 0.548 | 0.443 | 27 | 1 |
原质量门要求 Recall@5 > 0.54、MRR > 0.45，使用原全部70例。
两个原始完整脚本的前置 Lint、导航、索引构建及 full verify 均通过；原脚本在检索质量段退出，后续阶段未由本次完整脚本执行。此前单独阶段的通过不拼接为本次完整通过，也未修改阈值或标注以放行。临时工具环境为 GNU Bash 5.2、Python 3.14、TMPDIR=/private/tmp；仅供说明复现环境，不改变仓库检查逻辑。
干净固定上游的最小复现（依赖已就绪时）：
git clone https://gitcode.com/cann/cannbot-knowledge.git
cd cannbot-knowledge
git checkout 7ea0efbeb79f2559f121fa8514a9fe5c82245807
bash check.sh
此前的历史对照已定位到两次上游 Triton 语料迁入后的排序变化：原标注目标在 manual_topk_tiles、manual_broadcast_mixed 中由第1降至第2，两个正例的倒数排名变化可解释 MRR 从约0.459290到0.442896的下降；Top5召回不变。这是固定语料与原评分的复现定位，不将新卡直接判为不相关，也不据此调整质量标注。
请维护者协助确认：该上游质量退化是否已有跟踪或推荐修复提交？我们将保持原阈值和70例质量用例，待修复基线确认后再对冻结知识贡献运行完整检查并提交关联PR；目前没有请求跳过失败门禁，也尚未创建PR。
冻结知识文件清单
新增 25 份
knowledge/ops/ascendc/guides/data_movement/aligned_subword_output_packing.md（Guide）knowledge/ops/ascendc/guides/data_movement/aligned_tile_copy_safe_tail.md（Guide）knowledge/ops/ascendc/guides/data_movement/bounded_index_prefetch_consumption.md（Guide）knowledge/ops/ascendc/guides/data_movement/independent_index_load_mlp.md（Guide）knowledge/ops/ascendc/guides/layouts/cumsum_axis_last_layout_closure.md（Guide）knowledge/ops/ascendc/guides/memory/independent_affine_parameter_storage.md（Guide）knowledge/ops/ascendc/guides/memory/nllloss_indexed_scalar_staging.md（Guide）knowledge/ops/ascendc/guides/performance/resident_working_set_and_streaming_fallback.md（Guide）knowledge/ops/ascendc/guides/performance/semantic_vector_pass_reduction.md（Guide）knowledge/ops/ascendc/guides/reductions/inter_core_reduction_contract.md（Guide）knowledge/ops/ascendc/guides/reductions/rfft_dft_vectorization_axes_and_buffer_budget.md（Guide）knowledge/ops/ascendc/guides/testing/moe_routing_interface_information_sufficiency.md（Guide）knowledge/ops/ascendc/guides/testing/undefined_placeholder_output_comparison_contract.md（Guide）knowledge/ops/ascendc/guides/tiling/target_row_ownership_for_duplicate_indices.md（Guide）knowledge/ops/ascendc/runbooks/performance/sigmoid_explicit_no_cost_advantage.md（Runbook）knowledge/ops/ascendc/runbooks/precision/fixed_negative_bias_breaks_bf16_midpoint_rounding.md（Runbook）knowledge/ops/ascendc/runbooks/precision/hf32_mode_requires_fresh_process_numeric_fingerprint.md（Runbook）knowledge/ops/ascendc/runbooks/precision/int64_bitplane_scalar_maximum.md（Runbook）knowledge/ops/ascendc/runbooks/precision/iou_half_reference_three_way_probe.md（Runbook）knowledge/ops/ascendc/runbooks/precision/l1_prefetch_subtile_controlled_failure.md（Runbook）knowledge/ops/ascendc/runbooks/precision/nms_fp16_input_does_not_define_iou_precision.md（Runbook）knowledge/ops/ascendc/runbooks/precision/sigmoid_positive_exp_rewrite_overflow.md（Runbook）knowledge/ops/ascendc/runbooks/precision/veltkamp_split_not_unconditional_rne11_quantizer.md（Runbook）knowledge/ops/ascendc/runbooks/precision/wide_nz_b_subtile_base_plane_stride_diagnostic.md（Runbook）knowledge/ops/ascendc/runbooks/runtime/co1_ready_reuse_event_diagnostic.md（Runbook）
补充已有卡 11 份
knowledge/ops/ascendc/guides/data_movement/datacopypad_rows_and_padding.md（Guide）knowledge/ops/ascendc/guides/memory/alignment_units_layout_stride_and_padding_values.md（Guide）knowledge/ops/ascendc/guides/precision/dsl_api_routing_and_numerical_scope.md（Guide）knowledge/ops/ascendc/guides/precision/elementary_stability_without_semantic_clamping.md（Guide）knowledge/ops/ascendc/guides/reductions/interface_and_storage_contracts.md（Guide）knowledge/ops/ascendc/guides/reductions/mse_lane_and_cross_core_reductions.md（Guide）knowledge/ops/ascendc/guides/torch_extensions/compilation_and_launch_boundary.md（Guide）knowledge/ops/ascendc/guides/vector/counter_mask_scope_and_tail_counts.md（Guide）knowledge/ops/ascendc/runbooks/compilation/dtype_conditional_ub_allocation_matches_tiling_budget.md（Runbook）knowledge/ops/ascendc/runbooks/precision/ordered_compare_alone_cannot_propagate_nan_prefix_state.md（Runbook）knowledge/ops/ascendc/runbooks/precision/rsqrt_fast_approximation_use_sqrt_reciprocal.md（Runbook）
36卡公开审阅证据包
为关联知识 PR 提供冻结证据与公开检查附件；代码提交为 5632b106b37f223c12b23732a365e195589ee186。
- 冻结来源与审阅包（36份OKF贡献、255份公开证据文件），SHA-256：
15662e91640ee0851b9056a3f2589e17a4baa539374b93ae612bcf810f55b556。 - 该提交及干净上游的公开检查记录，SHA-256：
0aa7b5abb32ef69f29a4a97f8cbdba4e631a6411367e49cf73fbbb1c1c1665af。
下载第一个 ZIP 后，以解压目录中的 evidence_public/ 为证据根，按卡面文件名、manifest、成员定位和SHA-256复核；既有许可与证据强度声明保留。包内“仅供本地审阅 / formal_PR_ready=false”等记录属于冻结时状态，提交 PR 不表示完整门禁通过或已获准合入。最终知识卡与该包逐字一致，提交仅去掉日志末尾一个多余空白行。内部源映射和原JSON汇总库不在附件中。
第二个 ZIP 保留两份完整脚本输出以及本次独立补充检查日志；仅将作者本地 checkout 绝对路径前缀替换为明确占位符，其他日志文字保留，并提供公开文件MANIFEST。
原始完整检查仍未通过：同一固定上游和36卡版本均为 Recall@5=0.548、MRR=0.443、70例、27 MISS、退出码1（要求MRR>0.45）。原阈值、用例及检索实现未改。质量段后的原命令已单独执行通过：305项unittest（跳过1项）、36项trace、field notes硬门、Ruff、Shell语法及归档差异检查；这些单项不拼接为完整脚本通过。当前先提交知识 PR 供内容评审，合入仍由committer按仓库要求判断。
PR 已提交与作者更正
已提交 PR #136，已关联本 Issue。范围为冻结36份知识贡献（25新增、11补充已有卡）及13份导航、2份日志。
当前提交为 a2f213ab84ddb39f014e08ff94368a223bc3c3cc，作者姓名按贡献者要求更正为 DRDebug。公开检查包记录的 5632b106b37f223c12b23732a365e195589ee186 是更正姓名前的实际检查提交；两者 Git 树均为 7f825922255aef8ae4ad5480d552a641d0ed77b0、内容差异为空，原检查记录与附件保持原样。
PR 正文保留完整检查的上游可复现 MRR 失败和独立补充检查结果，未改原阈值、原70例或检索实现。先进入内容评审，合入条件仍由 committer 按仓库要求检视。
知识缺口
使用场景：编写普通 Gather、逐元素和两阶段归约 kernel 时，需要同时核对索引取数、输出打包、预取值消费、主尾块搬运、中间 dtype 与 partial 初始化。只有抽象优化原则时，容易遗漏实际门控、尾部或调用上下文。
适用范围：AscendC 的静态源码模式及两项固定版本官方接口约束。九张均保留 draft，本轮不新增真机产品验收或单机制提速声明。八张保持未定位平台；既有 ReduceSum Guide 的 950/a2/a3 平台范围保留，其新增重载差异仅限定官方文档声明的 A2/A3。
已有检索与 Issue 查重
基线：cannbot-knowledge master ef37bed1bbec2782cb07d2b086e80361fc0ea3c0。已使用 knowledge-query 检索并阅读全文；查询分别包含“int8 连续输出 四字节 打包 对齐”“索引预取 消费关系 下一批”“索引 Gather 独立 load 展开 标量尾部”“完整块 安全尾块 DataCopyPad 循环”“分核 partial 初始化 参与者 归并”“SetValue DCache 64B”“ReduceSum sharedTmpBuffer A2 A3 count”等，AscendC、status=all；八张使用 include-unlocated，既有 ReduceSum Guide 使用 platform=a2、type=guides。
现有 alignment、interface_and_storage_contracts、dsl_api_routing_and_numerical_scope 三张 Guide 适合增量补充；不另建同职责卡。共享只读系数缓存已有覆盖，本轮不重复创建。已查看现有全部 50 个 Issue 标题，Gather 关键词搜索无命中，并阅读相关 Issue #39；其 API 组合范式范围与下列具体源码模式不同。
知识生产方案
处理方式：create 六张、update 三张，均位于 knowledge/ops/ascendc/guides/。
新增：
补充：
生产方法：通用 knowledge-ingest 人工蒸馏候选；将源码观察、官方接口事实和待验证假设分开。完整机制代码与调用条件随正文保留，源码工件以哈希和成员定位复核。独立审查已经核对九张最终候选的来源、代码、范围和 OKF Profile；不把整算子成绩归因于单项优化。
候选来源与边界
预期效果与验收
预期：通过具体机制查询找到完整条件、代码、回退与失效边界；明确静态观察可以证明什么、仍需验证什么。
验收：逐卡复核来源与完整代码；同一组问题比较贡献前后召回及正文依据；同步各级导航和当天日志；执行全库 knowledge-lint、索引 build/full verify、既有检索质量门槛和完整 bash check.sh。
已完成：九张最终卡片的独立来源/代码审查；全库 Lint（7873 文件，P0/P1/P2 均为 0）；662 份导航无陈旧；7211 卡索引 build/full verify；既有 70 场景质量门槛（recall@k=0.548、MRR=0.459）；完整 bash check.sh 退出码 0（305 项测试通过，按上游条件跳过 1 项；另 36 项轨迹测试通过）。检查使用临时依赖环境、GNU Bash 5.2 与规范 TMPDIR，未修改上游检查实现。
九个目标检索均召回：六张新增均 rank-1，DSL/ReduceSum 既有指南 rank-1，SetValue 补充所在指南 rank-4。ReduceSum 按既有平台 a2 与 Guide Profile 检索；先前误用 include-unlocated 的记录保留，不能据此声称排名缺陷。命中只说明可发现，技术结论仍以正文证据范围为准。
补丁在干净固定基线上应用与逐字复核后随本地审阅包提供。本 Issue 仅认领上述九张 draft 指南，暂未创建 PR；关联 PR 提交前由贡献者审阅最终正文和差异。