| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
docs: 新增 ONNX Plugin Python API 参考文档 Co-authored-by: gentle-knight<3045324663@qq.com> # message auto-generated for no-merge-commit merge: !4963 merge docs/onnx-plugin-python-api into develop docs: 新增 ONNX Plugin Python API 参考文档 Created-by: gentle-knight Commit-by: gentle-knight Merged-by: cann-robot Description: # Pull Request ## 描述 新增 ONNX Plugin 转 IR Python 化链路的 API 参考文档： - 新增 ge.onnx_plugin 模块文档 12 篇：onnx_plugin() 工厂函数、OnnxPlugin descriptor（parse_node/parse_operator/decompose 三类回调）、OnnxNode 只读值对象（name/origin_type/inputs/outputs/attrs）及模块简介（含插件部署语义）。 - 新增 ge.graph.Operator 文档 10 篇：算子属性读写（get_attr/set_attr）与端口注册（register_input/register_optional_input/register_output/register_dynamic_input/register_dynamic_output）。 - README 补齐 25 条索引，新增 3 个类入口页。 文档关键约束均与源码逐条核对：parse_operator 与 parse_node 同阶段二选一（前者优先）、source 算子只读语义、attribute JSON 序列化字段形态（标量 f 为 %g 字符串、列表为原生数值的不对称）、attrs 整体读取的复合类型限制、graph-only 场景约束、set_attr 不做属性名校验等。 ## 变更类型 - [x] 📝 文档内容更新 ## 关联的Issue 无 ## 如何测试 纯文档变更，无代码逻辑修改。已完成的验证： 1. 26 个文件内部全部相对链接有效性检查（0 断链），README 索引条目与磁盘文件一一对应； 2. 全部 7 个 Python 示例代码块 ast.parse 语法校验通过，import 齐全、变量均有定义； 3. pre-commit 等价检查通过（trailing-whitespace / end-of-file / merge-conflict / private-key / 拼写）；本地 pre-commit 环境损坏（virtualenv segfault），已按 hook 语义逐项人工执行。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 - 单 commit 交付（文档初版与评审修复合并），基于 0fa3324a9（upstream develop 历史内）切出。 - 文档经过三轮独立评审迭代（API 完备性、源码一致性、新用户可读性），全部实质问题已闭环。 See merge request: cann/ge!4963 | 1 个月前 |