【合入来源】

• 需求

• 问题单

• issue/工单

• 重构优化

• 资料更新

• 任务来源：【社区任务】7月社区任务第四期-Ascend for PyTorch API 一致性开发（61）

• 结果记录：torch.serialization.default_restore_location 补齐结果

• 资料 PR：PR #45113

【分支范围】

本资料 PR 面向 master 目标分支。

当前 master/docs/zh/api/native_api 资料体系包含：

pytorch_2-7-1
pytorch_2-11-0
pytorch_2-12-0
pytorch_2-13-0

pytorch_2-9-0、pytorch_2-10-0 已不在当前 Native API 资料目录中，
本 PR 不涉及这两个版本。

资料分支：

源分支：docs/default-restore-location
目标分支：master
基线提交：ba2fae9d04c4909a34ca50312fe7a651ac77d7c9
Commit：d0399a5db9f6520a3a06bb83f0f0ba19b74d98ba
提交标题：docs: add torch.serialization.default_restore_location

本 PR 为 docs-only 单提交，未包含测试代码或功能代码修改。

【修改方案】

补充公开 API：

torch.serialization.default_restore_location(storage, location)

的 Native API 支持资料。

四套资料原有 Serialization 章节均已包含：

torch.save
torch.load

但补齐前均未登记：

torch.serialization.default_restore_location

因此本 PR 在各版本 torch.md 的 torch.load 之后、## Parallelism
之前增加目标 API 条目。

修改文件：

docs/zh/api/native_api/pytorch_2-7-1/torch.md
docs/zh/api/native_api/pytorch_2-11-0/torch.md
docs/zh/api/native_api/pytorch_2-12-0/torch.md
docs/zh/api/native_api/pytorch_2-13-0/torch.md

新增结构：

## Serialization
### torch.save
### torch.load
### torch.serialization.default_restore_location
## Parallelism

各版本分别链接对应 PyTorch 2.7、2.11、2.12、2.13 的原生文档页面。

【支持情况】

支持状态与各版本现有 torch.load Serialization 条目保持一致：

硬件	是否支持
Atlas A2 训练系列产品	✔
Atlas A3 训练系列产品	✔
Ascend 950DT	✔

torch.serialization.default_restore_location 为序列化位置恢复/调度类 API，
不属于 Tensor 数值计算接口，因此本 PR 不增加 fp16、fp32、bf16 等数据类型限制说明。

新增支持状态使用当前资料规范的 ✔ / ✘ 形式。

【社区用例与代码 PR 说明】

PyTorch 社区已有 torch.load(..., map_location=...) 的间接覆盖，但未发现直接调用：

torch.serialization.default_restore_location(storage, location)

并验证 NPU restore 行为的目标测试。

根据当前任务分类，代码侧在 Torch-NPU 已有测试文件：

test/npu/test_serialization.py

中补充直接 NPU 测试，代码 PR 分别面向：

master
v2.7.1
v2.11.0
v2.12.0

当前官方仓库未提供 v2.13.0 代码目标分支，因此不创建第五个 v2.13.0 代码 PR；
但 pytorch_2-13-0 Native API 资料目录已存在，因此本资料 PR 同步维护 2.13.0 资料。

本资料 PR 不依赖 test_upstream patch。

【接口变更】

不涉及。

本 PR 只更新 Native API 支持资料，不修改：

• torch.serialization.default_restore_location Python 实现；
• API 签名、返回值或异常契约；
• Torch-NPU Python/C++ 实现；
• NPU Kernel；
• Torch-NPU 单元测试；
• test_upstream patch。

【功能验证】

本 PR 为资料变更，已完成资料结构、修改范围和 Git diff 静态验证。

提交与远端验证：

branch=docs/default-restore-location
base=ba2fae9d04c4909a34ca50312fe7a651ac77d7c9
commit=d0399a5db9f6520a3a06bb83f0f0ba19b74d98ba
commit_file_count=4
test_file_count=0
worktree_status_count=0
cached_diff_check_rc=0
push_rc=0
remote_head=d0399a5db9f6520a3a06bb83f0f0ba19b74d98ba
REMOTE_VERIFY=PASS

目标 API 在四套资料中的位置：

pytorch_2-7-1：line 2128
pytorch_2-11-0：line 2100
pytorch_2-12-0：line 2100
pytorch_2-13-0：line 2100

【test_upstream patch】

不涉及。

本资料 PR 不修改 PyTorch 官方测试文件，也不新增或修改 Torch-NPU
test_upstream patch。

【流程规范说明】

本任务按当前 API 一致性要求独立维护各目标代码分支，并将资料补齐统一提交到
master 的独立 docs PR。

不使用同步创建其他版本 PR 的 /sync 流程。

【CheckList】

• PR 目标分支为 master
• 本 PR 为独立 docs-only PR
• 已关联任务来源 Issue #3543
• 已关联结果 Issue #3627
• 已检查 PyTorch 2.7.1、2.11.0、2.12.0、2.13.0 四套当前 Native API 资料
• 四套资料补齐前均缺少 torch.serialization.default_restore_location
• 四套资料均新增完整 API 名
• 四套资料均提供对应 PyTorch 原生文档链接
• 支持状态与同版本 torch.load 保持一致
• 支持状态使用 ✔ / ✘
• 非计算类 API 未增加 fp16、fp32、bf16 等 dtype 限制
• 未修改已移除的 PyTorch 2.9.0、2.10.0 资料
• 仅修改 4 个 torch.md
• 未修改任何 test/ 文件
• 未修改任何 test_upstream patch
• git diff --check 通过
• 单提交仅包含资料修改
• 资料分支已推送且远端 SHA 与本地一致
• 按当前规范不使用 /sync