【合入来源】

• 需求
• 问题单
• issue/工单
• 重构优化
• 资料更新

关联 issue：

• 任务 issue：https://gitcode.com/Ascend/pytorch/issues/1634

【修改方案】

本 PR 新增 test/fx/test_fx_graph_api.py，补充 torch.fx Graph 相关 API / 内部 codegen 链路在 NPU 环境下可直接运行的轻量验证用例。测试中涉及 Tensor 的输入均通过 .to(device_type) 放到当前 accelerator 上执行。

任务 API 功能及上游社区用例情况如下：

主要开发思路：

1. 先复查 PyTorch 上游社区用例，确认 5 个任务 API / 内部链路的已有覆盖情况。
2. 对 torch.fx.Graph.lint，上游已有直接专项测试，因此本 PR 不重复新增 lint 测试。
3. 对 torch.fx.Graph.inserting_after，上游 quantization 用例会因当前 Kunpeng/ARM 环境不支持 FBGEMM 被 skip，因此参考其插入点使用方式新增轻量测试。
4. 对 torch.fx.Graph.inserting_before、torch.fx.graph.magic_methods.format、torch.fx.graph.inplace_methods.format，上游相关用例集中在 test/test_fx.py，该文件在当前环境存在 libtorchbind_test.so 依赖问题，因此新增独立小文件验证核心行为。
5. 新增测试聚焦 FX 图构建、Proxy 生成、节点 target、节点参数传递、codegen 文本以及 NPU Tensor 执行结果，不修改 API 实现。

本 PR 覆盖以下 4 个新增测试目标项：

本 PR 不新增 torch.fx.Graph.lint 专项测试，原因如下：

1. 复查 PyTorch 官方 test/test_fx.py，torch.fx.Graph.lint 已有直接专项测试覆盖，例如 TestFX.test_wrong_topo、TestFX.test_copy_no_remap 等。
2. 本 PR 新增的 4 个测试中也在构造或 trace 完 FX Graph 后调用 graph.lint()，用于校验测试图结构合法性，但不把它作为本 PR 的新增目标 API。

本 PR 不修改 API 实现，不修改 test/test_fx.py。新增独立测试文件 test/fx/test_fx_graph_api.py，避免受 test/test_fx.py 中历史环境依赖 libtorchbind_test.so 缺失问题影响。

新增测试文件：

test/fx/test_fx_graph_api.py

新增测试方法：

test_graph_inserting_after
test_graph_inserting_before
test_magic_methods_format_codegen
test_inplace_methods_format_codegen

各测试核心验证点如下：

【资料变更】

当前不涉及资料补齐 PR。三个公开 torch.fx.Graph.* API 已在 docs/zh/native_apis 中记录；两个 torch.fx.graph.*.format 项为内部 codegen 字典模板链路，不宜按普通公开 API 强行补入 native API 表。

【接口变更】

不涉及。

【功能验证】

执行命令：

cd /root
python /workspace/pytorch/test/fx/test_fx_graph_api.py

执行结果：

....
----------------------------------------------------------------------
Ran 4 tests in 7.673s

OK

最终验证结论：

1. 本 PR 新增 4 个轻量 NPU 测试，覆盖 inserting_after、inserting_before、magic_methods.format、inplace_methods.format。
2. 新增测试不仅验证 API 调用不崩溃，也验证 FX 图构建、Proxy 生成、节点 target、节点参数传递、codegen 文本和 NPU Tensor 执行结果。
3. torch.fx.Graph.lint 已有 PyTorch 官方直接专项测试覆盖，因此本 PR 不重复新增 lint 专项测试。
4. 本 PR 不修改 API 实现，不涉及资料变更和接口变更。

【CheckList】

• 代码注释完备，正确记录错误日志
• 代码实现进行了返回值、空指针等校验
• PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等
• PR持续集成流水线（CI）执行通过，代码检查无异常