【合入来源】

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

【任务背景】

本 PR 对应 pytorch-vllm 开源实习项目中的 Torch-NPU API 一致性对齐任务，公开 issue：
https://gitcode.com/Ascend/pytorch/issues/1628

本 PR 是该 issue 的资料补齐 PR，用于在 docs/zh/native_apis 的 torch-fx.md 支持矩阵中补充 torch.fx.experimental.symbolic_shapes 相关 API 的支持状态。同组交付 PR 如下：

• v2.7.1 用例：https://gitcode.com/Ascend/pytorch/pull/36792
• v2.9.0 用例：https://gitcode.com/Ascend/pytorch/pull/36799
• v2.10.0 用例：https://gitcode.com/Ascend/pytorch/pull/36804
• v2.11.0 用例：https://gitcode.com/Ascend/pytorch/pull/36815
• v2.12.0 用例：https://gitcode.com/Ascend/pytorch/pull/36818
• master 用例：https://gitcode.com/Ascend/pytorch/pull/36820
• 资料支持状态：https://gitcode.com/Ascend/pytorch/pull/36822

【API 功能介绍】

【上游社区测试情况】

已基于当前分支基线检索 test 目录中的相关覆盖情况：

• 上游/基线中存在部分间接覆盖，例如 StatelessSymbolicContext 在 dynamo export/subclass 场景中被使用，ShapeEnvSettings 出现在 public API allowlist 中。
• 未发现覆盖本任务 5 个 API 的集中直接 UT，尤其缺少 ShapeEnv.size_hint、ShapeEnv.suppress_guards、ShapeEnvSettings 字段构造、StatefulSymbolicContext/StatelessSymbolicContext 默认状态的直接行为断言。
• 因此同组测试 PR 在各目标分支补充了自写 UT；本 PR 只负责同步资料支持状态。

【修改方案】

在 docs/zh/native_apis 当前已有的 PyTorch 版本目录中，向 torch-fx.md 支持矩阵追加上述 5 个 API，支持状态标记为“是”，限制与说明为“-”，表示与原生 API 支持度保持一致。

本 PR 覆盖以下资料文件：

docs/zh/native_apis/pytorch_2-7-1/torch-fx.md
docs/zh/native_apis/pytorch_2-9-0/torch-fx.md
docs/zh/native_apis/pytorch_2-10-0/torch-fx.md
docs/zh/native_apis/pytorch_2-11-0/torch-fx.md
docs/zh/native_apis/pytorch_2-12-0/torch-fx.md

【完备性分析】

• 当前 docs/zh/native_apis 下存在的 PyTorch 版本目录均已补充这 5 个 API 支持状态。
• 每个版本目录均追加同一组 API，链接指向对应 PyTorch 版本的官方文档页面。
• 本 PR 仅变更资料支持矩阵，不涉及 API 功能实现、NPU 算子开发、跨仓接口或运行时行为变更。
• 当前结论：不需要新增 API 实现；需要新增测试用例，已由同组测试 PR 覆盖；需要资料补齐，已在本 PR 完成。

【资料变更】

涉及资料变更。补充 torch.fx.experimental.symbolic_shapes 相关 API 的支持状态说明。

【接口变更】

不涉及。未修改跨仓接口或客户可见接口行为。

【功能验证】

本 PR 仅涉及资料更新，已确认提交只包含资料文件变更：

docs/zh/native_apis/pytorch_2-7-1/torch-fx.md
docs/zh/native_apis/pytorch_2-9-0/torch-fx.md
docs/zh/native_apis/pytorch_2-10-0/torch-fx.md
docs/zh/native_apis/pytorch_2-11-0/torch-fx.md
docs/zh/native_apis/pytorch_2-12-0/torch-fx.md

已基于最新 upstream/v2.7.1 解决资料文件冲突并重新推送，当前提交为：

e3ec8d460 docs: add support status for symbolic shapes APIs
5 files changed, 25 insertions(+)

本地校验：

git diff --check
# 无输出，表示未发现空白格式问题

每个 torch-fx.md 文件均包含 5 个目标 API 条目，未残留冲突标记。

PR 状态复查结果：

mergeable: true
conflict_passed: true
ci_state_passed: true

【测试效果 / 日志说明】

• 本 PR 为资料补齐，不新增可执行测试代码。
• 同组测试 PR 已在各目标分支验证新增 5 个 API 用例均通过。
• 资料冲突已通过重新基于最新 v2.7.1 底座 cherry-pick 单个文档提交解决，当前 PR 分支保持 squash 后的单提交形态。

【CheckList】

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