aca70078创建于 1月15日历史提交

文件	最后提交记录	最后更新时间
api	【PR】: 补充ES API支持数值输入的设计说明 Co-authored-by: du-hua1024<duhua2@huawei.com> # message auto-generated for no-merge-commit merge: !51 merge master into master 【PR】: 补充ES API支持数值输入的设计说明 Created-by: du-hua1024 Commit-by: du-hua1024 Merged-by: cann-robot Description: # Pull Request ## 描述补充ES API支持数值输入的设计说明 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue NA ## 如何测试 NA ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 NA See merge request: cann/ge!51	6 个月前
design	【PR】: 清除so中的RPATH Co-authored-by: kobemini<gengchao4@huawei.com> # message auto-generated for no-merge-commit merge: !131 merge bugfix into 8.5.0 【PR】: 清除so中的RPATH Created-by: kobemini Commit-by: kobemini Merged-by: cann-robot Description: # Pull Request ## 描述清除so中的RPATH ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [ ] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试 NA ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/ge!131	6 个月前
rfc	【PR】: 简要描述 refactor es docs Co-authored-by: kobemini<gengchao4@huawei.com> # message auto-generated for no-merge-commit merge: !25 merge es_doc_001 into master 【PR】: 简要描述 refactor es docs Created-by: kobemini Commit-by: kobemini Merged-by: cann-robot Description: # Pull Request ## 描述 ES DOC目录的整理 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [x] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/ge!25	7 个月前
tools	【PR】: 简要描述 refactor es docs Co-authored-by: kobemini<gengchao4@huawei.com> # message auto-generated for no-merge-commit merge: !25 merge es_doc_001 into master 【PR】: 简要描述 refactor es docs Created-by: kobemini Commit-by: kobemini Merged-by: cann-robot Description: # Pull Request ## 描述 ES DOC目录的整理 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [x] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/ge!25	7 个月前
README.md	【PR】: 简要描述 fix es docs Co-authored-by: kobemini<gengchao4@huawei.com> # message auto-generated for no-merge-commit merge: !41 merge issue_fix into master 【PR】: 简要描述 fix es docs Created-by: kobemini Commit-by: kobemini Merged-by: cann-robot Description: # Pull Request ## 描述请清晰准确地描述本次 Pull Request 的意图和变更内容。 - ge python目录从es目录剥离出来 - es的readme添加路标规划 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/ge!41	7 个月前

ES (Eager Style)文档

概述

ES (Eager Style)是 GraphEngine 中用于构建计算图的函数式接口模块，提供了便捷的图构建功能。ES 模块支持多种编程语言（C、C++、Python），为用户提供了灵活且易用的图构建方式。

ES 系列 API 核心特点：

自动生成：API 并非手写，而是基于算子原型定义自动生成，减少算子开发者负担，特别是自定义算子也需要使用ES的API的构图场景。
多语言支持：原生支持 C、C++，并可扩展支持 Python，满足不同开发习惯。
全维度兼容：通过良好的API设计和代码生成机制，结合IR语义兼容处理，从源头实现了前后向API,ABI的兼容性保障。

ES 三大关键组件：

ES 基础数据结构（GE仓/GE包）：提供 EsGraphBuilder（图构建器）、EsTensorHolder（张量持有者）等核心基础设施，是构图的基石。
ES Code Generator（GE仓/GE包）：核心工具 gen_esb，负责读取算子原型定义，自动化生成每个算子对应的构图 API 代码。
Generated ES API（OPP包）：由生成器构建的最终产物，包含在算子包中，是用户直接调用的函数接口。

快速导航

API 参考文档

Python API - Eager Style Graph Builder Python 接口文档
- GraphBuilder、TensorHolder 等基础类的主要接口
C++/C API - Eager Style Graph Builder C++/C 接口文档
- EsGraphBuilder、EsTensorHolder 等基础类的主要接口

设计文档

整体架构设计 - ES模块整体架构设计说明
所有权关系分析 - ES模块Python 层和 C++ 层资源管理机制说明

工具文档

gen_esb 代码生成工具 - ES 代码生成工具使用说明
- 工具功能说明
- 使用方法和参数说明
generate_es_package.cmake - ES 代码生成、构建、安装一键式 cmake 函数
- 函数功能说明
- 使用方法和参数说明

RFC 文档

RFC 目录 - 设计提案文档
- 新功能提案
- 架构改进方案
- API 变更建议

文档结构

docs/es/
├── README.md                    # 本文件，文档导航入口
├── api/                         # API 参考文档
├── design/                      # 设计和技术分析文档
├── tools/                       # 工具使用文档
└── rfc/                         # RFC 提案文档

sample

开发路线图

已完成 ✅

核心架构：主体功能已设计完成并落地，支持全量原型的代码生成和多语言构图
API 集成：math 分包已完成集成
示例代码：已提供多语言的 sample，涵盖常见使用场景

进行中 🚧

API 集成：nn、cv、transformer、hcom 分包预计 2026 年 Q1 完成集成
示例完善：更多 sample 持续添加中

计划中 📋

历史原型库：C++ API的后向兼容依赖于此，目前处于设计阶段，预计 2026 年 Q1 完成落地
自定义算子工程：ascendc 自定义算子工程集成 ES 的代码生成能力，暂无规划

使用说明

在全量原型打包到算子分包之前，如需使用 ES API，可以参考工具文档中的 generate_es_package.cmake 进行代码生成和集成。