已合并
docs: add support status for proxy tensor api #34874
docs: add support status for proxy tensor api #34874
已合并
nwww创建于 5月2日
nwww
5月2日

【合入来源】

如有社区issue,请关联issue链接
请勿携带内部流程信息(需求链接、问题单、内部issue等)

关联 issue:https://gitcode.com/Ascend/pytorch/issues/1609

【修改方案】

请描述修改内容的具体实现,涉及哪些组件之间进行交互,可以用1、2、3、...进行罗列
如果是需求或者重构类的PR,需要补充详细设计文档(说明上下游组件关系、时序图、类图、DFX能力等内容)

本 PR 补充 torch.fx.experimental.proxy_tensor 相关 API 在 docs/zh/native_apis 中的支持状态。

本次补充 API 包括:

  • torch.fx.experimental.proxy_tensor.get_proxy_mode
  • torch.fx.experimental.proxy_tensor.handle_sym_dispatch
  • torch.fx.experimental.proxy_tensor.make_fx
  • torch.fx.experimental.proxy_tensor.maybe_disable_thunkify
  • torch.fx.experimental.proxy_tensor.maybe_enable_thunkify

一、资料支持情况检查说明

经检查,docs/zh/native_apis 中已有 torch.fx 相关 API 支持状态记录,但缺少本次任务涉及的 torch.fx.experimental.proxy_tensor 相关 API 支持状态。

其中,torch.fx.experimental.proxy_tensor 相关 API 在当前版本中已可正常 import,并已通过单独测试 PR 补充专项验证用例。因此,本 PR 对 docs/zh/native_apis/pytorch_*/torch-fx.md 中相关 API 支持状态进行补充。

本次资料补齐仅提交至 v2.7.1 分支,并刷新当前 docs/zh/native_apis 目录下已有版本的 torch-fx.md 支持状态,不新建当前目录下不存在的版本目录。

二、具体修改内容

  1. docs/zh/native_apis/pytorch_*/torch-fx.md 中补充如下 API:

    |torch.fx.experimental.proxy_tensor.get_proxy_mode|是|-|
    |torch.fx.experimental.proxy_tensor.handle_sym_dispatch|是|-|
    |torch.fx.experimental.proxy_tensor.make_fx|是|-|
    |torch.fx.experimental.proxy_tensor.maybe_disable_thunkify|是|-|
    |torch.fx.experimental.proxy_tensor.maybe_enable_thunkify|是|-|
    
  2. 上述 API 支持状态均标记为“是”;

  3. 限制与说明均为“-”,表示当前支持状态与 PyTorch 原生 API 保持一致,无额外限制说明;

  4. 本 PR 仅修改 docs/zh/native_apis/pytorch_*/torch-fx.md 文档文件,不涉及功能代码、测试代码、底层算子或客户可见接口修改;

  5. 相关 API 的专项测试用例已通过单独测试 PR 提交,本 PR 仅负责资料支持状态补齐;

  6. 已基于最新 v2.7.1 分支重新整理文档修改,确保本 PR 修改范围仅包含 docs/zh/native_apis/pytorch_*/torch-fx.md,用于解决目标分支更新后产生的文档冲突。

【资料变更】

请确认是否涉及资料变更。如涉及,需要在PR中体现,并简要说明修改内容。如不涉及,需填写“不涉及”

涉及。

本 PR 在 docs/zh/native_apis/pytorch_*/torch-fx.md 中补充 torch.fx.experimental.proxy_tensor 相关 API 的支持状态。

补充 API 包括:

  • torch.fx.experimental.proxy_tensor.get_proxy_mode
  • torch.fx.experimental.proxy_tensor.handle_sym_dispatch
  • torch.fx.experimental.proxy_tensor.make_fx
  • torch.fx.experimental.proxy_tensor.maybe_disable_thunkify
  • torch.fx.experimental.proxy_tensor.maybe_enable_thunkify

本 PR 仅修改资料文档,不涉及测试代码、功能代码、底层算子和客户可见接口修改。

【接口变更】

请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及,需要详细说明接口以及对应的变更内容,同时需要在资料中体现。如不涉及,需填写“不涉及”

不涉及。

本 PR 仅补充资料文档中的 API 支持状态,不修改客户可见接口,不修改 API 行为,不涉及跨仓接口变更。

【功能验证】

说明测试场景,测试方法。如果本次测试方式与常规单元测试不同,请详细说明您的测试步骤
新增/变更内容是否已新增/适配UT测试用例看护,并补充测试自验证截图

验证方式:

  1. 检查 docs/zh/native_apis/pytorch_*/torch-fx.md 中已补充以下 API 支持状态:

    • torch.fx.experimental.proxy_tensor.get_proxy_mode
    • torch.fx.experimental.proxy_tensor.handle_sym_dispatch
    • torch.fx.experimental.proxy_tensor.make_fx
    • torch.fx.experimental.proxy_tensor.maybe_disable_thunkify
    • torch.fx.experimental.proxy_tensor.maybe_enable_thunkify
  2. 检查新增内容格式符合 native_apis 表格格式:

    |API 名称|是否支持|限制与说明|
    
  3. 检查本 PR 修改范围仅包含:

    docs/zh/native_apis/pytorch_*/torch-fx.md
    
  4. 检查本 PR 不涉及以下目录或文件修改:

    test/
    torch_npu/
    third_party/
    benchmarks/
    ci/
    cmake/
    
  5. 已基于最新 v2.7.1 分支重新提交文档修改,用于处理目标分支更新后产生的冲突。

  6. 等待 CI 文档检查和代码检查通过。

说明:

本 PR 为资料补齐 PR,不新增或修改测试用例。相关 API 的专项测试用例已通过单独测试 PR 提交。

【CheckList】

PR提交人对以下CheckList自检项进行全量自检,自检通过或不涉及,均修改 [ ] 为 [x]

likedislike
Pull Request已成功合入, 合并人@ascend-robot
(感谢 nwww 的贡献)
Nnwww
5月2日 创建了 pull request,commit 0843f39f
ascend-robot
ascend-robot成员
5月2日 评论:

Thanks for your pull-request.
The full list of commands accepted by me can be found at here
You can get sig-info at here


PR Approval Progress

Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

module lgtm status approve status
docs 李伟, molly123321 (2/2) 李伟 (1/1)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

nannan-2026, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
ascend-robotascend-robot成员
5月2日 添加了label:ascend-cla/yes
ascend-robot
ascend-robot成员
5月2日 评论:

当前仓库存在以下 保护分支

Protected Branch Version Release
master
v2.7.1
v2.9.0
v2.11.0
v2.10.0

评论 /sync <branch1> <branch2> ... 可将当前 PR 修改同步到其它分支(创建同步 PR):
a) 如果当前 PR 是 Open 状态,同步操作将延迟到 PR 被合并时执行
b) 如果当前 PR 已经 Merged,将立即执行同步操作

注意:

  1. /sync 命令可以指定同步到多个分支,仅最后一个 /sync 命令生效
  2. 如果创建的同步 PR 不正确,可通过向同步 PR 的源分支提交轻量级 PR 完善,或使用 /close 命令关闭
likedislike
此处折叠了102条消息 查看更多
ascend-robotascend-robot成员
6月9日 删除了label:ci-pipeline-running
ascend-robotascend-robot成员
6月9日 添加了label:ci-pipeline-passed
ascend-robot
ascend-robot成员
6月9日 评论:
流水线 PR-pipeline_pytorch#30541 [ commitID:feebddfa ] 已完成
阶段 任务名 状态 详情
编译构建 Build_X86 🛑 >>>
Build_ARM 🛑 >>>
Build_LibTorch_x86 🛑 >>>
Build_LibTorch_ARM 🛑 >>>
Build_X86_torchair 🛑 >>>
Build_ARM_torchair 🛑 >>>
patch_test 🛑 >>>
恶意代码检查 Antipoison >>>
编码安全与规范检查 CodeCheck >>>
check_error >>>
CodeCheck_lintrunner >>>
开源片段检查 SCA >>>
开发者测试 UT_X86_Part_01 🛑 >>>
UT_X86_Part_02 🛑 >>>
UT_ARM_A3_Part_01 🛑 >>>
UT_ARM_A3_Part_02 🛑 >>>
UT_ARM_A2_Part_01 🛑 >>>
UT_ARM_A2_Part_02 🛑 >>>
UT_ARM_A2_Part_03 🛑 >>>
UT_inductor_Part_01 🛑 >>>
UT_inductor_Part_02 🛑 >>>
UT_inductor_Part_03 🛑 >>>
UT_inductor_Part_04 🛑 >>>
UT_DIST_ARM_Part_01 🛑 >>>
UT_DIST_ARM_Part_02 🛑 >>>
UT_DIST_ARM_Part_03 🛑 >>>
UT_DIST_ARM_Part_04 🛑 >>>
UT_ARM_A2_Select_Part_01 🛑 >>>
UT_ARM_A2_Select_Part_02 🛑 >>>
流水线 PR-pipeline_pytorch >>>
likedislike
ascend-robotascend-robot成员
6月9日 合入了pull request
ascend-robot
ascend-robot成员
6月9日 评论:
流水线 pytorch_gitcode_PR_multiVersion#10270 [ commitID:feebddfa ] 已完成
likedislike