Pull Request

描述

完成 AnnotatedArgsOp 地址刷新接口 Python 化。本 PR 仅保留核心实现与测试：

• Python 自定义算子通过 schema-bound declare_launch_args 生成 AnnotatedArgs TaskDef。
• 提供 AnnotatedArgsContext、Tensor、workspace、kernel args builder 等 Python 包装，覆盖作用域、签名校验、异常转换和 builder 消费语义。
• 编译期把最终选定的参数刷新方式写入 OpDesc 属性 _custom_task_args_mode；模型加载时以该显式模式为准。没有该属性的旧 OM 才使用 registry 查询和 args_format 兼容兜底。
• Python custom-op bridge C ABI 保持 v1；模型运行期只消费序列化模式和 TaskDef，不回调 Python。
• 提供显式 CustomTaskArgsMode，编译期记录最终刷新方式，运行期优先按该模式选择路径并兼容老 OM。
• 补充 Python、native binding、compiler builder 和静态模型加载路径的 UT/ST。

资料和可运行 example 已拆分至 PR 4316，本 PR 最终 diff 不再包含 docs/ 或 examples/：

• https://gitcode.com/cann/ge/pull/4316

本 PR 直接复用 develop 已合入的两个前置任务，不再重复实现：

• append_input / append_output 使用 input/output 实例平铺 index。
• workspace 使用两阶段申请及 task plan 缓存，后续任务物化复用缓存，不重复调用声明 callback。

变更类型

• ✨ 新功能
• ♻️ 无关重构
• 📦 构建过程或辅助工具变动
• 📝 文档更新（已拆分到 PR 4316）

关联 Issue

无。

验证结果

• 最新 develop 增量编译：ut_libge_multiparts_utest、graph_engine_test 构建通过。
• pre-commit：全部通过（clang-format、ruff、codespell、OAT 等）。
• C++ UT：2653 passed, 8 skipped。
• Python UT：651 passed, 1 skipped。
• Python AnnotatedArgs ST：5/5 通过，包含真实 Python -> pybind -> C++ callback 链路及异常分支校验。
• ASAN 定向用例：1/1 通过。
• build_fwk.sh 在 ASAN LD_PRELOAD 环境下的子进程 gcc 探测通过。
• 功能开发阶段已使用拆分前的相同核心实现和 example 完成 910B3 两轮真实 NPU 地址刷新验证；example 后续验证由 PR 4316 承载。

核对清单

• 代码遵循项目风格
• 已补充并执行自测
• 中英文文档已拆分到关联 PR 4316
• 按要求保留 [wip] 标记
• 已阅读并遵守贡献指南

本轮检视修复

• 增加稳定序列化枚举 CustomTaskArgsMode，显式区分 None、AnnotatedArgs 和 UpdateCallback，保留旧 OM 兼容路径。
• 恢复原有不可调用方法的注册行为，避免无关语义变化。
• bridge ABI 保持 v1，统一 context import，签名校验函数改名为 _validate_args_signature。
• 移除通用 engine/known-shape 文档中的 Python 特例及过程性文档；长期资料和 example 已拆分到 PR 4316。
• input/output instance index 越界异常输出实际索引和实例数量，并由端到端 Python callback 用例覆盖。
• 修复 ASAN 环境下 gcc 子进程继承 LD_PRELOAD 导致 Python CI 在 pytest 前退出的问题。
• 同步最新 develop 的 Python 自定义算子原型类型定义和 workspace 两阶段申请逻辑，PR 冲突已消除。