Pull Request

描述

支持 Python 自定义算子原型从 Python descriptor 到 GE OperatorFactory 的注册，并完善 Python 自定义算子实现的 bridge 注册、校验和生命周期管理。

主要变更：

• 根据 Python 函数签名收集输入、属性、输出及 mutates_args，生成并深拷贝 Python custom op proto。
• 将 Python proto 注册为 OperatorFactory creator，并通过公开 IR 查询接口获取 canonical IR。
• 按 proto 注册、canonical IR 收集、impl 签名校验、Adapter 注册的顺序完成加载。
• 支持 proto-only、proto + Python impl、C++ proto + Python impl 以及 legacy impl。
• 完善 Adapter descriptor、runtime registry 和 holder 的所有权管理。
• 支持重复加载幂等、runtime lease pending cleanup 和注册失败回滚。
• 增加 Python proto、descriptor、bridge loader、Adapter 以及 ST/UT 覆盖。
• 当前阶段不执行 Python infer_meta，暂不覆盖编译期 Meta 推导和 RT2 runtime infer。
• 同步更新中英文 Python custom op 设计文档。

变更类型

请选择本次引入的变更类型：

• 🐛 Bug 修复
• ✨ 新功能
• 💄 代码风格更新（格式化，局部变量）
• ♻️ 重构（既不修复错误也不增加功能的代码变动）
• 📦 构建过程或辅助工具的变动
• 📝 文档内容更新

关联的Issue

#299

如何测试

本次补充和扩展以下测试：

1. Python UT：

   • proto/impl descriptor 快照和关联关系。
   • proto-only、proto + schema-bound impl、C++ proto + Python impl 和 legacy impl 场景。
   • canonical IR 与 execute 签名校验。
   • schema-bound 输入和属性绑定、执行上下文作用域及失效检查。
   • plugin 和 bridge/native artifact 加载检查。

2. C++ UT：

   • proto C POD view 解析和 owning 数据转换。
   • 支持的属性类型及默认值转换。
   • Operator creator 注册、冲突保护和卸载。
   • Adapter capability、runtime entry、holder 和 callback 生命周期。
   • loader 注册事务、失败回滚、幂等加载及 pending cleanup。

3. ST：

   • Python proto 和 impl 注册、创建及卸载。
   • Python 自定义算子文件加载失败。
   • 不可访问的非 Python自定义算子路径跳过处理。

建议执行：

bash tests/run_test.sh --ut=python
cmake --build build_ut --target ut_libge_multiparts_utest -j4
ctest --test-dir build_ut -R ut_libge_multiparts_utest --output-on-failure
git diff --check

核对清单

• 我的代码遵循了项目的代码风格
• 我已对代码进行了自测
• 我已更新了相关的文档
• 我在标题中使用了合适的类型标签（如：feat:, fix:）
• 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等

其他信息

• 本次完成 Python 原型到 C++ OperatorFactory 的注册，以及 Python 实现到 CustomOpFactory 的 Adapter 注册。
• 本次不执行 Python infer_meta，不包含 infer callback、编译期 shape/data type 回写或 RT2 runtime infer 链路；这些内容由后续 PR 完成。
• 本次保持 schema-bound execute 和迁移期 legacy execute(ctx) 的现有行为。
• Bridge ABI 当前按同批构建和整体替换使用，不承诺不同版本 V1 artifact 混用。
• 本次未修改公开 API，也未修改 build_fwk.sh 等公共构建脚本。