51dcbca5创建于 7月27日历史提交

文件	最后提交记录	最后更新时间
en	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	1 个月前
zh	【docs】: 删除废弃的dflow资料 Co-authored-by: lwx1255555<liuxiaofang17@huawei-partners.com> # message auto-generated for no-merge-commit merge: !4146 merge develop into develop 【docs】: 删除废弃的dflow资料 Created-by: lwx1255555 Commit-by: lwx1255555 Merged-by: cann-robot Description: # Pull Request ## 描述删除废弃的dflow资料 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> 不涉及 ## 如何测试描述测试此变更的步骤和前提条件： 1.已经自检 2.已经使用doc tools检查 ## 核对清单 <!-- [x] 表示选中 --> - [ ] 我的代码遵循了项目的代码风格 - [ ] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [ ] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [ ] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/ge!4146	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	2 个月前
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	2 个月前

项目文档

目录结构

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