| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
feat：支持融合结果上报的 Python 化 Co-authored-by: lfz2812<220252399@seu.edu.cn> # message auto-generated for no-merge-commit merge: !4070 merge develop into develop feat：支持融合结果上报的 Python 化 Created-by: lfz2812 Commit-by: lfz2812 Merged-by: cann-robot Description: # Pull Request ## 描述 在 PR3996 完成 can_fuse Python 化的基础上，本 PR 继续补齐 GE 融合结果上报能力，使 Python 融合 Pass 能够完成融合可行性 检查、改图和融合结果上报的完整流程。 本次修改包括： 1. 新增 report_fuse Python native 绑定： - 接收融合前、融合后的 Python Node 可迭代对象。 - 统一将 Python Node 转换为 C++ GNode 集合。 - 调用 GraphFuseInspectorUtils::ReportFuse 上报融合结果。 - 上报失败时将错误信息写入 PassContext，并向 Python 抛出 RuntimeError。 - 在 ge.passes 中公开 report_fuse，并补充类型声明。 2. 为 SubgraphRewriter.replace 增加带 context 的调用方式： - 原有 SubgraphRewriter.replace(boundary, replacement) 行为保持不变。 - 新增 SubgraphRewriter.replace(boundary, replacement, context=context)。 - 传入 context 后，由底层自动完成融合可行性检查、子图替换和融合结果上报。 - 执行失败时将错误信息写入 PassContext，并向 Python 抛出 RuntimeError。 3. 支持两种 Python 融合 Pass 改图流程： - 传统直接改图方式：用户依次调用 can_fuse、自定义 Graph 改图接口和 report_fuse。 - 基于子图替换的方式：用户传入 context 调用 SubgraphRewriter.replace，由底层统一完成检查、替换和上报。 4. 优化 Python 与 native 层的职责划分： - 节点可迭代对象的遍历、类型校验和 GNode 转换统一在 native 层完成，避免 Python 与 native 重复处理。 - can_fuse 保留 Python 包装，用 FuseCheckResult 封装检查结果。 - report_fuse 无需适配返回值，直接重导出 native 实现。 5. 更新 Python 融合 Pass 样例： - move_relu_before_concat_pass 使用带 context 的 SubgraphRewriter.replace。 - modify_conv_data_format_pass 演示 can_fuse、直接改图、report_fuse 和旧节点删除的调用顺序。 - 同步更新相关中英文 README。 6. 补充接口和设计文档： - 新增 report_fuse API 文档。 - 更新 SubgraphRewriter.replace API 文档，说明传入和不传入 context 时的行为差异。 - 更新 GE Python 中英文设计文档和 API 索引。 7. 补充和更新测试： - 校验 report_fuse 非法 PassContext 入参。 - 验证 Python Pass 通过 pybind 调用 report_fuse。 - 验证带 context 的融合结果上报流程。 - 保留 can_fuse 正常、异常和边界场景覆盖。 调用示例： python from ge.passes import can_fuse, report_fuse # 传统直接改图方式 result = can_fuse(nodes_before) if not result.ok: context.set_error_message(result.reason) return False # 用户直接调用Graph接口完成自定义改图。 report_fuse(nodes_before, nodes_after, context) from ge.passes import SubgraphRewriter # 基于子图替换的方式 SubgraphRewriter.replace( boundary, replacement, context=context, ) ## 变更类型 - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 关联 Issue：#299 ## 如何测试 1. 执行 Python UT： bash tests/run_test.sh --ut=python 2. 执行 ut_fusion_pass_executor_utest，验证 Python Pass 通过 pybind 调用 report_fuse，并检查 PythonFusionBasePass_PybindBridge_RunSuccess 用例。 3. 检查相关 Python 融合 Pass 样例和中英文文档。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit 的合并等 ## 其他信息 - 原有 SubgraphRewriter.replace(boundary, replacement) 接口保持兼容。 - 传统直接改图场景必须在旧节点被删除或失效前调用 report_fuse。 - 本次仅新增 Python 融合结果上报和带 context 的标准化子图替换能力，不改变原有 Python Pass 注册及执行机制。 See merge request: cann/ge!4070 | 2 个月前 | |
【doc】: dflow设计文档补充GraphPp编译配置 Co-authored-by: lining23666<lining.li@huawei.com> # message auto-generated for no-merge-commit merge: !4092 merge doc/dflow-dynamic-shape into develop 【doc】: dflow设计文档补充GraphPp编译配置 Created-by: lining23666 Commit-by: lining23666 Merged-by: cann-robot Description: # Pull Request ## 描述 在 dflow 设计文档（docs/zh/design/modules/dflow/dflow.md）中新增 3.5 节"GraphPp 编译配置"，补充遗漏的 GraphPp 编译配置特性。 原设计文档未介绍 GraphPp 的编译配置 JSON 文件入口，读者无法了解如何为 GraphPp 子图单独设置编译参数。本次补充内容位于第 3 节"对外接口"下，作为 3.5 节，与 3.1 C++ 构图接口、3.4 数据类型并列。 补充内容包含： - GraphPp 编译配置 JSON 入口（C++ SetCompileConfig / Python compile_config_path）及顶层两键 - **build_options**：键值对原样透传给 GE 编译器，GE 支持的图编译参数都可以在这里为 GraphPp 子图单独设置（具体 option 的名称和取值格式参考 GE 编译参数文档） - **inputs_tensor_desc**：dflow 私有配置，当原图 Data 节点的 dtype/format/shape 与预期编译不一致时（如原图静态 shape 需改为动态维度），通过此配置覆盖为正确值；原图描述已正确时无需设置 - 配置 JSON 示例（以动态 shape 编译为例，build_options 透传 GE 编译参数，inputs_tensor_desc 将原图静态 shape 覆盖为动态维度） - 与执行路径选择的关系（配置动态 shape → 走 ProxyDynamicModelExecutor 动态执行；未配置 → 走 task sink 静态执行，衔接 4.3.6 节） ## 变更类型 - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新 - [ ] ♻️ 重构 - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无 ## 如何测试 1. 文档变更，无需运行测试 2. 已通过 pre-commit 检查（codespell/clang-format/end-of-file-fixer 等 hooks 全部 Passed） ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签 - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定 See merge request: cann/ge!4092 | 2 个月前 | |
【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 | 2 个月前 | |
【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 | 2 个月前 |