50c8682f创建于 9月5日历史提交

文件	最后提交记录	最后更新时间
en	docs: 修正dflow设计文档与代码不一致处并补充UDF设备侧机制说明 Co-authored-by: lining23666<lining.li@huawei.com> # message auto-generated for no-merge-commit merge: !4716 merge docs/dflow-design-review into develop docs: 修正dflow设计文档与代码不一致处并补充UDF设备侧机制说明 Created-by: lining23666 Commit-by: lining23666 Merged-by: cann-robot Description: # Pull Request ## 描述基于对 `dflow/` 代码（不含 llm_datadist）与设计文档的逐模块核对，修正文档与代码不一致的描述，并补充两份文档均未覆盖的 UDF 执行器机制（中英文档同步修改）： dflow.md（17 处修正）： - 3.1 类图：补入 InnerPp 抽象层（ProcessPoint → InnerPp → ModelPp 实际继承链）；SetCompileConfigFile 修正为 protected - 4.3.2：删除代码中不存在的"daemon 重新 fork sub_deployer"机制，改为头节点心跳检测感知 - 4.6.3：多实例命名修正为四段（含 is_redundant 冗余标志段） - 2.4：澄清 flowGW 为独立于 GE 的数据网关进程 - 4.3.4：区分 executor 模型加载方式（udf_executor 经文件加载而非消息队列） - 4.2：内置 UDF 序列化产物修正为 UdfModelDef protobuf（非 OM buffer） - 3.4：拆分 EmptyDataFlowMsg 与 EOS 判定两个概念；MbufHeadMsg 补 worked_id 字段；RuntimeTensorDesc 补 original_shape - 4.1/3.5/3.3/4.5/4.6.1：修正 CPU 引擎 EXEC_PLACEMENT 注入主体、build_options 含 inputShape 时的派生行为、data_wrapper 枚举、Python 双路径零拷贝表述精确化（限定 df.alloc_tensor 产物）、resources 生效范围、msg_type 1024 约定语义、_npu_sched_model 消费路径、heavy_load 默认值位置等表述不精确处 udf.md（6 项补充）： - 2.2：新增 Python 侧配套能力表（df.alloc_tensor 零拷贝输出 / FlowMsgQueue / PyMetaParams / DfAbortException 协作式中止） - 4.5：补充挂起后的状态重置路径（Python wrapper 重建 vs C++ 回退释放重建） - 5.2：补充 host 侧直接操作 device 队列的封装说明（ProxyQueueWrapper） - 11：新增 UDF 数据 Dump 完整机制（配置项、step 过滤、host 侧自行落盘与 device 侧 AICPU 代理落盘的区分）；补充内存统计；注明 profiling 为预留能力 - 12：扩充执行器进程（host 与 device 复用同一实现）——模型加载方式、安全沙箱（seccomp 白名单 + 内置用户限制）、进程韧性（父进程监控/SIGTERM）、运行治理（esched 优先级/状态上报/指标/软调度/模型级配置） - 附录：文件索引同步补充 ## 变更类型 - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无 ## 如何测试 1. 文档变更，无代码逻辑改动 2. 所有新增/修正的类名、接口名、属性名、选项名已逐一与代码核对确认存在 3. 本地 pre-commit 检查（codespell 等 hooks）全部通过 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息无 See merge request: cann/ge!4716	1 个月前
zh	docs: 明确控核参数配置0的行为与取值约束 Co-authored-by: KenChow<zhouchen53@huawei.com> # message auto-generated for no-merge-commit merge: !4706 merge core_num_limit_doc_fix into develop docs: 明确控核参数配置0的行为与取值约束 Created-by: KenChow Commit-by: KenChow Merged-by: cann-robot Description: # Pull Request ## 描述 `ge.aicoreNum` / `--aicore_num` 的两段，以及算子级属性 `_op_aicore_num` / `_op_vectorcore_num`，配置为 `0` 时不会报错，但会被调用方当作未配置处理、不产生控核效果。现有文档只写了"需要大于0"，用户容易把 `0` 理解成"不限制"，本次补充说明。变更内容： - `--aicore_num.md`、`options_params/operator_and_graph_compilation.md`、`aclgrphBuildInitialize_config_params/operator_and_graph_compilation.md`：在"参数值约束/使用约束"中补充取值格式（不带前导零的十进制整数）、上界语义（取自 SoC `.ini` 的静态声明值，不随本次运行中实际可用核数变化），以及 Vector Core 段配置 `0` 的实际行为；明确只限制一类核时应将另一段留空（如 `"24\|"`、`"\|48"`），不要用 `0` 代替空段。 - `attribute_name_list.md`：为 `_op_aicore_num`、`_op_vectorcore_num` 补充配置 `0` 不报错但不生效的说明。说明按 `<!-- npu=... -->` 条件块分场景放置：Vector Core 相关描述只出现在场景1（950/A3/910b）产品的文档变体中，仅配置整数1的场景2 产品不受影响。 ## 变更类型 - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试本次仅涉及文档，无代码变更。 1. 本地 pre-commit 全部通过（trailing-whitespace、end-of-file-fixer、codespell、OAT Compliance Check 等）。 2. 人工核对：文中描述的行为与 `graph_metadef/register/core_num_utils.cc` 的 `ParseAndValidateCoreNum`（解析放行 `0`）及各调用方的 `if (core_num > 0)` 过滤一致；上界取自 `platform_config/*.ini` 的 `ai_core_cnt` / `vector_core_cnt`。 3. 人工核对：新增段落均位于对应的 `<!-- npu=... -->` 条件块内，不会渲染到不适用的产品文档变体。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息同步提交的还有 torchair、tensorflow 两个仓的同名分支，统一 `0` 的口径。 https://claude.ai/code/session_01CV2caT7YeZnqmCjpRrKfp5 See merge request: cann/ge!4706	1 个月前
README.md	【PR】:rename user-guides Co-authored-by: sophia1213<sophie.chen@huawei.com> # message auto-generated for no-merge-commit merge: !3814 merge develop into develop 【PR】:rename user-guides Created-by: sophia1213 Commit-by: sophia1213 Merged-by: cann-robot Description: # Pull Request ## 描述重命名docs目录下的user-guides为user_guides。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无 ## 如何测试根据最新目录进行测试 ## 核对清单 <!-- [x] 表示选中 --> - [ ] 我的代码遵循了项目的代码风格 - [ ] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [ ] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [ ] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/ge!3814	3 个月前
README_en.md	【PR】:rename user-guides Co-authored-by: sophia1213<sophie.chen@huawei.com> # message auto-generated for no-merge-commit merge: !3814 merge develop into develop 【PR】:rename user-guides Created-by: sophia1213 Commit-by: sophia1213 Merged-by: cann-robot Description: # Pull Request ## 描述重命名docs目录下的user-guides为user_guides。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无 ## 如何测试根据最新目录进行测试 ## 核对清单 <!-- [x] 表示选中 --> - [ ] 我的代码遵循了项目的代码风格 - [ ] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [ ] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [ ] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/ge!3814	3 个月前

项目文档

目录结构

└── zh
    ├── api/                    # API参考文档
    ├── contributions/          # 开发规范与指南
    ├── design/                 # 设计文档
    ├── figures/                # 图片资源
    ├── user_guides/            # 用户指南
    ├── build.md                # 源码构建
    └── quick_install.md        # 环境部署