| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
#66: 新增芯片别名/NpuArch 映射、产品平台标签、内存与执行术语、SIMD/SIMT 混合编程边界知识卡 Co-authored-by: bianque<huangshihe2@hisilicon.com> # message auto-generated for no-merge-commit merge: !159 merge bianque/review-147 into master #66: 新增芯片别名/NpuArch 映射、产品平台标签、内存与执行术语、SIMD/SIMT 混合编程边界知识卡 Created-by: bianque Commit-by: bianque Merged-by: cann-robot Description: # Pull Request 说明 ## 变更说明 - 关联 Issue：Issue #66 - 主要改动： - knowledge/common/glossaries/ascendc_memory_and_execution_terminology.md：新增 AscendC 存储层次、执行单元与 CopyIn/Compute/CopyOut 术语定义，区分物理存储与 TPosition 逻辑位置；来源为固定提交 e680c34c09ba6919b3cebd2b7ec027f4ff6f0f22 的官方 glossary。 - knowledge/common/glossaries/ascendc_simt_and_regbase_terminology.md：整理 SIMT、SIMD/SIMT 混合、RegBase、线程层次、执行空间限定符、VF 调用、UB 分区和 __NPU_ARCH__ 术语；来源为固定提交中的 SIMT programming model、hybrid programming model、限定符、kernel config 与 NPU architecture guide。 - knowledge/common/platforms/concepts/ascendc_chip_alias_and_npu_arch_map.md：登记芯片调用名、产品系列别名、SocVersion 与 __NPU_ARCH__ 映射，并保留“能力存在不等于 API 支持”的边界；来源为固定提交中的 NPU architecture guide。 - knowledge/common/platforms/concepts/ascendc_product_label_to_platform_values.md：整理 API 内容页 npu 产品标签到知识卡 platforms 枚举的受控映射，覆盖 910b、a2 与 310b 的登记边界；来源为固定提交中的芯片与标签映射参考。 - knowledge/ops/ascendc/concepts/programming_model/simd_simt_hybrid_programming_boundaries.md：说明 SIMD/SIMT 混合编程的入口形态、调用层级、VF/Kernel 启动、地址空间、线程与 UB 约束及适用边界；来源为固定提交中的 hybrid programming model 与相关限定符/kernel config 文档。 - 同步 knowledge/common/glossaries/index.md、knowledge/common/index.md、knowledge/common/platforms/concepts/index.md、knowledge/ops/ascendc/concepts/index.md、knowledge/ops/ascendc/concepts/programming_model/index.md 的导航及 logs/2026-10-28.md；在 evals/test_governance.py 补充可选 route 有卡片且索引完整的接受/拒绝测试。 - 补充说明： - 内容限定为来源可核验的定义、映射和机制边界；未将能力映射扩展为 API 支持声明，也未把收益表述写成无条件结论。 - 处理决定为 create；原 Issue #66 的五个主题分别落实为上述五张卡。来源证据固定到 asc-devkit 提交 e680c34c09ba6919b3cebd2b7ec027f4ff6f0f22 的 docs/zh/guide/technical_appendix/concepts_and_terms/glossary.md、docs/zh/api/SIMT-API/ 下编程模型与限定符文档、.agent/skills/asc-npu-arch/references/npu-arch-guide.md 及 .agent/skills/asc-doc-checker/references/芯片与标签映射关系.md。310b 对应 Atlas 200I/500 A2 推理产品，本仓未登记相应 platforms 枚举值，不借用 a2 或 310p。 ## 变更类型 - [x] 知识卡 - [ ] 治理规则（Schema / Profile / Registry / Contract / Spec） - [ ] Knowledge Skill（Ingest / Query / Lint） - [x] 检索、评测或测试 - [ ] 安装、脚本、依赖或 CI - [ ] 文档 - [ ] 其他： ## 验证 - [ ] bash check.sh 已通过 - [x] 已按需同步导航、链接、日志、规则消费者、文档和测试 - [x] 未提交敏感信息、大段上游原文或 artifacts/ 等可重建产物 - [x] 变更保持最小、相关，并符合 CONTRIBUTING.md See merge request: cann/cannbot-knowledge!159 | 4 天前 | |
#66: 校正 dtype 视图与平台支持概念卡 Co-authored-by: bianque<huangshihe2@hisilicon.com> # message auto-generated for no-merge-commit merge: !164 merge bianque/review-152 into master #66: 校正 dtype 视图与平台支持概念卡 Created-by: bianque Commit-by: bianque Merged-by: cann-robot Description: # Pull Request 说明 ## 变更说明 - 关联 Issue：[#66](https://gitcode.com/cann/cannbot-knowledge/issues/66) - 主要改动： - 新增 knowledge/common/platforms/concepts/ascendc_dtype_views_and_platform_support.md 一张 Concept 卡，区分文档 dtype 简写、真实 C++ / 逻辑类型、打包存储单元和产品支持清单四个视图；说明 S4 对应的逻辑 int4b_t 不等于存储 int4x2_t，FP4 与 S4 打包后两个 4-bit 值占一个 8-bit 单元。 - 按存储单元字节数给出 32B 长度对应的 32 / 16 / 8 / 4 个单元；仅在具体 API 要求时检查 count * size_bytes % 32 == 0，首地址对齐另行核对。对照固定原文中 Ascend 950PR/950DT 的 23 项与 Atlas A2/A3 各 14 项清单，包括两边的 bool、int4b_t；派生 JSON 的 950 清单缺 int4b_t，A2/A3 清单缺 bool、int4b_t，清单缺项不能作为具体 API 不支持的反证。复数以原文限定的 950PR/950DT 为准，并注明派生 guide 的“910_95”口径差异。 - 同步直属导航 knowledge/common/platforms/concepts/index.md 和当天 logs/2026-10-28.md；不修改其他知识卡、治理规则或 Skill。 - 补充说明：处理决定为 create；目标 Concept 在 master 不存在。主要依据为 asc-devkit 固定提交 e680c34c09ba6919b3cebd2b7ec027f4ff6f0f22 的 docs/zh/api/SIMD-API/basic_api/data_structures/builtin_data_types.md，并对照同提交的 .agent/skills/asc-npu-arch/references/npu-arch-facts.json 与 .agent/skills/asc-npu-arch/references/npu-arch-guide.md。本卡只讨论 dtype 层判断，具体 API 的声明和实现仍需单独核对。 ## 变更类型 - [x] 知识卡 - [ ] 治理规则（Schema / Profile / Registry / Contract / Spec） - [ ] Knowledge Skill（Ingest / Query / Lint） - [ ] 检索、评测或测试 - [ ] 安装、脚本、依赖或 CI - [ ] 文档 - [ ] 其他： ## 验证 - [ ] bash check.sh 已通过 - [x] 已按需同步导航、链接、日志、规则消费者、文档和测试 - [x] 未提交敏感信息、大段上游原文或 artifacts/ 等可重建产物 - [x] 变更保持最小、相关，并符合 CONTRIBUTING.md See merge request: cann/cannbot-knowledge!164 | 3 天前 | |
#66: 新增目标架构与构建环境选择 Concept Co-authored-by: bianque<huangshihe2@hisilicon.com> # message auto-generated for no-merge-commit merge: !165 merge bianque/review-153 into master #66: 新增目标架构与构建环境选择 Concept Created-by: bianque Commit-by: bianque Merged-by: cann-robot Description: # Pull Request 说明 ## 变更说明 - 关联 Issue：#66 - 主要改动： - 新增 knowledge/common/toolchains/concepts/ascendc_target_arch_and_build_env_selection.md，按产品型号核对已有官方 dav 架构映射，再确定 bisheng 的 --npu-arch=dav-<版本号>；明确 __NPU_ARCH__ 数值宏、具体工程 SoC 注册串和 Skill 输入 SOC_ARCH 不可互换。所引映射表没有给出 Kirin X90/9030 的 dav 编号，不从产品支持列表推测。 - 区分 asc-ar-dev Skill 的 DEVKIT_PATH、CANN_PATH、SOC_ARCH、TASK_GOAL 解析约定与通用编译器要求；按固定来源说明环境变量探针、可复现的 bisheng hello_world.asc --npu-arch=dav-2201 -o demo 样例和 CMake 构建入口。示例架构必须依实际产品替换；.asc 可为 Device-only、Host-only 或混合代码。 - 对照固定脚本限定 kernel_info_infer.py、compile_op.py、ascendc_compile_base.py、ascendc_compile_dfx.py 的可证明行为，区分参考资料中的 printf/assert 概述与编译/链接分支的源码证据，不推断全部产物或运行时调测必然生效。按环境解析、CMake 配置、源码收集/Device 编译、链接与元信息阶段解释失败信号；具体修复仍由相邻 Runbook 承担。 - 同步 knowledge/common/index.md、knowledge/common/toolchains/index.md、knowledge/common/toolchains/concepts/index.md及当天知识日志；复用 master 已有的可选 route 结构正反测试。 - 补充说明：处理决定为 create，范围只涉及这一张 Concept、必要导航和日志；可选 route 正反测试已由 master 提供；主要来源固定在 asc-devkit 提交 e680c34c09ba6919b3cebd2b7ec027f4ff6f0f22 的 Skill 参考、官方说明和构建脚本。不修改无关知识、治理规则或 Skill；未执行编译或运行时验证。 ## 变更类型 - [x] 知识卡 - [ ] 治理规则（Schema / Profile / Registry / Contract / Spec） - [ ] Knowledge Skill（Ingest / Query / Lint） - [ ] 检索、评测或测试 - [ ] 安装、脚本、依赖或 CI - [ ] 文档 - [ ] 其他： ## 验证 - [ ] bash check.sh 已通过 - [x] 已按需同步导航、链接、日志、规则消费者、文档和测试 - [x] 未提交敏感信息、大段上游原文或 artifacts/ 等可重建产物 - [x] 变更保持最小、相关，并符合 CONTRIBUTING.md See merge request: cann/cannbot-knowledge!165 | 3 天前 | |
#66: 新增目标架构与构建环境选择 Concept Co-authored-by: bianque<huangshihe2@hisilicon.com> # message auto-generated for no-merge-commit merge: !165 merge bianque/review-153 into master #66: 新增目标架构与构建环境选择 Concept Created-by: bianque Commit-by: bianque Merged-by: cann-robot Description: # Pull Request 说明 ## 变更说明 - 关联 Issue：#66 - 主要改动： - 新增 knowledge/common/toolchains/concepts/ascendc_target_arch_and_build_env_selection.md，按产品型号核对已有官方 dav 架构映射，再确定 bisheng 的 --npu-arch=dav-<版本号>；明确 __NPU_ARCH__ 数值宏、具体工程 SoC 注册串和 Skill 输入 SOC_ARCH 不可互换。所引映射表没有给出 Kirin X90/9030 的 dav 编号，不从产品支持列表推测。 - 区分 asc-ar-dev Skill 的 DEVKIT_PATH、CANN_PATH、SOC_ARCH、TASK_GOAL 解析约定与通用编译器要求；按固定来源说明环境变量探针、可复现的 bisheng hello_world.asc --npu-arch=dav-2201 -o demo 样例和 CMake 构建入口。示例架构必须依实际产品替换；.asc 可为 Device-only、Host-only 或混合代码。 - 对照固定脚本限定 kernel_info_infer.py、compile_op.py、ascendc_compile_base.py、ascendc_compile_dfx.py 的可证明行为，区分参考资料中的 printf/assert 概述与编译/链接分支的源码证据，不推断全部产物或运行时调测必然生效。按环境解析、CMake 配置、源码收集/Device 编译、链接与元信息阶段解释失败信号；具体修复仍由相邻 Runbook 承担。 - 同步 knowledge/common/index.md、knowledge/common/toolchains/index.md、knowledge/common/toolchains/concepts/index.md及当天知识日志；复用 master 已有的可选 route 结构正反测试。 - 补充说明：处理决定为 create，范围只涉及这一张 Concept、必要导航和日志；可选 route 正反测试已由 master 提供；主要来源固定在 asc-devkit 提交 e680c34c09ba6919b3cebd2b7ec027f4ff6f0f22 的 Skill 参考、官方说明和构建脚本。不修改无关知识、治理规则或 Skill；未执行编译或运行时验证。 ## 变更类型 - [x] 知识卡 - [ ] 治理规则（Schema / Profile / Registry / Contract / Spec） - [ ] Knowledge Skill（Ingest / Query / Lint） - [ ] 检索、评测或测试 - [ ] 安装、脚本、依赖或 CI - [ ] 文档 - [ ] 其他： ## 验证 - [ ] bash check.sh 已通过 - [x] 已按需同步导航、链接、日志、规则消费者、文档和测试 - [x] 未提交敏感信息、大段上游原文或 artifacts/ 等可重建产物 - [x] 变更保持最小、相关，并符合 CONTRIBUTING.md See merge request: cann/cannbot-knowledge!165 | 3 天前 |