| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
[Docs]move docs to master Co-authored-by: Xinrui Chen<chenxinrui11@huawei.com> # message auto-generated for no-merge-commit merge: !42515 merge master-docs into master [Docs]move docs to master Created-by: chenrayray Commit-by: Xinrui Chen Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > <font color="red">**如有社区issue，请关联issue链接**</font>\ > <font color="red">**请勿携带内部流程信息（需求链接、问题单、内部issue等）**</font> - [ ] 需求 - [ ] 问题单 - [x] issue/工单 - [ ] 重构优化 - [x] 资料更新 # 【修改方案】 > 请描述修改内容的具体实现，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列\ > 如果是需求或者重构类的PR，需要补充详细设计文档（说明上下游组件关系、时序图、类图、DFX能力等内容） 将主干docs文档从v2.7.1移动至master # 【资料变更】 > 请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及” 涉及 # 【接口变更】 > 请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及，需要详细说明接口以及对应的变更内容，同时需要在资料中体现。如不涉及，需填写“不涉及” 不涉及 # 【功能验证】 > 说明测试场景，测试方法。如果本次测试方式与常规单元测试不同，请详细说明您的测试步骤\ > 新增/变更内容是否已新增/适配UT测试用例看护，并补充测试自验证截图 不涉及 # 【CheckList】 > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!42515 | 1 个月前 | |
docs: add Generator.clone_state support Co-authored-by: qq_65095566<1922937030@qq.com> # message auto-generated for no-merge-commit merge: !43350 merge docs-generator-clone-state-master into master docs: add Generator.clone_state support Created-by: qq_65095566 Commit-by: qq_65095566 Merged-by: ascend-robot Description: # 【合入来源】 ## issue：[【社区任务】7月社区任务第三期-Ascend for PyTorch API 一致性开发（124） #3235](https://gitcode.com/Ascend/pytorch/issues/3235) ## issue：[[Usage]: torch.Generator.clone_state NPU一致性验证 #3476](https://gitcode.com/Ascend/pytorch/issues/3476) - [ ] 需求 - [ ] 问题单 - [x] issue/工单 - [ ] 重构优化 - [x] 资料更新 # 【修改方案】 ## 1. 资料检查结论 本次针对 torch.Generator.clone_state 进行资料补齐检查。 torch.Generator.clone_state 为 PyTorch Generator 公开接口，不属于 PyTorch 私有接口。该 API 用于克隆当前 Generator 的随机数状态，返回一个新的 Generator 对象。克隆后的 Generator 应保持与原 Generator 克隆时一致的 RNG 状态，用于保证后续随机数生成结果可复现。 已在 NPU 环境下完成基础功能验证，torch.Generator.clone_state 实际支持 NPU： text [PASS] torch.Generator.clone_state basic NPU behavior generator device: npu clone device: npu 因此需要检查并补齐 master 分支下的资料目录： text docs/zh/api/native_api 根据 master 分支最新资料目录规则，资料补齐已转移到 master 分支下统一处理；同时 pytorch_2-9-0 与 pytorch_2-10-0 目录已删除，新增 pytorch_2-13-0 目录，需要按 master 最新目录中实际存在的版本同步刷新 API 支持情况。 检查发现，现有各版本 torch.md 中已存在 ## Generators 章节，并已记录 torch.Generator 及其部分方法，但缺少 clone_state() 条目。因此，本次需要在各版本已有 torch.md 的 Generators 章节中补充 torch.Generator.clone_state 支持情况。 ## 2. 本次修改内容 本次按照机器人检视意见和最新资料结构进行调整： 1. 不再新增独立的 torch-Generator.md 文件； 2. 删除此前新增的 torch-Generator.md 文件，避免形成孤儿页面； 3. 不修改各版本索引文件； 4. 将 clone_state() 直接补充到各版本已有 torch.md 的 ## Generators 章节中； 5. 补充位置放在 set_state() 之后，保持 torch.Generator 相关 API 说明集中在同一文档位置。 本次修改范围为 master 最新资料目录中实际存在版本对应的 torch.md 文件，例如： text 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 说明： - pytorch_2-9-0 与 pytorch_2-10-0 已从 master 最新资料目录中删除，本次不再补充； - pytorch_2-13-0 为新增资料目录，本次同步补齐； - 以 master 分支 docs/zh/api/native_api 当前实际存在的版本目录为准进行刷新。 ## 3. 资料内容说明 本次在各版本 torch.md 的 ## Generators 章节中补充如下条目： md > <font size="3">clone_state()</font> <div style="margin-left: 2em"> **原生文档**：[torch.Generator.clone_state](https://pytorch.org/docs/版本号/generated/torch.Generator.html#torch.Generator.clone_state) **是否支持**：是 **限制与说明**：- </div> torch.Generator.clone_state 属于 Generator 状态类 API，非计算类 API，与具体数据类型无关，因此未填写 fp16、fp32 等数据类型支持信息，限制与说明按最新格式填写为：- ## 4. 文档结构调整说明 此前方案新增了独立的 torch-Generator.md 文件，但各版本索引文件未包含该文件入口，容易导致新增页面成为孤儿页面。 同时，各版本 torch.md 中已经存在 ## Generators 章节，并已记录 torch.Generator 相关方法。若再单独新增 torch-Generator.md，会导致 torch.Generator 资料分散在两个文件中，不利于用户通过正常文档路径查阅。 因此，本次按检视意见调整为： text 不新增 torch-Generator.md 直接在 torch.md 的 Generators 章节补充 clone_state() 这样可以保证 torch.Generator 相关 API 资料集中在同一位置，避免文档碎片化和孤儿页面问题。 # 【资料变更】 涉及资料变更。 本 PR 在 master 分支下补充 torch.Generator.clone_state 的资料支持情况，修改范围为 master 最新资料目录中实际存在版本的 torch.md 文件。 补充原因： 1. torch.Generator.clone_state 为 PyTorch Generator 公开接口，不属于私有接口； 2. 该 API 在 NPU 环境下已验证实际支持； 3. master 分支 docs/zh/api/native_api 下现有版本资料中缺少该 API 条目； 4. 当前资料补齐已转移到 master 分支下，因此本次仅提交 master 资料 PR； 5. pytorch_2-9-0 与 pytorch_2-10-0 已从最新 master 资料目录中删除，本次不再补充； 6. 新增的 pytorch_2-13-0 目录已同步检查并补齐； 7. 本次未新增独立 torch-Generator.md，而是将 clone_state() 补充到已有 torch.md 的 Generators 章节中。 # 【接口变更】 不涉及。 本次仅补充资料文件，不修改代码实现，不涉及跨代码仓接口变更，也不涉及客户可见接口功能变更。 # 【功能验证】 ## 1. 资料目录检查 检查 master 分支资料目录： bash cd /workspace/torch-npu-master DOC_ROOT="docs/zh/api/native_api" ls -ld "${DOC_ROOT}" find "${DOC_ROOT}" -maxdepth 1 -type d | sort 确认以 master 分支当前实际存在的版本目录为准进行补齐；其中 pytorch_2-9-0 与 pytorch_2-10-0 已删除，pytorch_2-13-0 已新增并同步检查。 ## 2. 补充前资料检查 补充前执行以下命令检查 torch.Generator.clone_state 是否已存在： bash cd /workspace/torch-npu-master DOC_ROOT="docs/zh/api/native_api" grep -Rnw \ -E "torch\.Generator\.clone_state|Generator\.clone_state|clone_state" \ "${DOC_ROOT}" \ --include="*.md" \ || true 检查结果显示：master 最新资料目录中现有版本的 torch.md 均缺少 torch.Generator.clone_state / clone_state() 条目，因此需要补齐。 ## 3. 补充后资料检查 补充资料后执行以下命令检查新增条目： bash cd /workspace/torch-npu-master grep -Rnw \ -E "torch\.Generator\.clone_state|clone_state\(\)" \ docs/zh/api/native_api/pytorch_*/torch.md 预期结果： text 各版本 docs/zh/api/native_api/pytorch_*/torch.md 中均存在 clone_state() 条目 ## 4. 格式检查 执行： bash cd /workspace/torch-npu-master git diff --check git diff --stat git status --short 确认资料文件格式检查无异常，修改范围仅包含本次资料补齐相关的 torch.md 文件。 # 【CheckList】 - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!43350 | 1 个月前 | |
[Docs]Optimize README Co-authored-by: Xinrui Chen<chenxinrui11@huawei.com> # message auto-generated for no-merge-commit merge: !42070 merge master-docs into master [Docs]Optimize README Created-by: chenrayray Commit-by: Xinrui Chen Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > <font color="red">**如有社区issue，请关联issue链接**</font>\ > <font color="red">**请勿携带内部流程信息（需求链接、问题单、内部issue等）**</font> - [ ] 需求 - [ ] 问题单 - [x] issue/工单 - [x] 重构优化 - [x] 资料更新 # 【修改方案】 > 请描述修改内容的具体实现，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列\ > 如果是需求或者重构类的PR，需要补充详细设计文档（说明上下游组件关系、时序图、类图、DFX能力等内容） 对首页readme进行了整改，主要改动为： 1. 头部：居中标题 + 副标题 + 语言切换 + 导航栏 + badges 2. 移除：删除过时的流水线状态、参考文档表以及多余文件 3. 新增：核心特性、最新动态、社区交流 (SIG 表)、致谢 4. 重构：安装（软件包安装 + 源码编译安装）、快速开始（初始化环境 + 运行示例） 5. 简化：安全声明、License、免责声明 6. 摘出：版本配套表、PyTorch/Python 版本表、分支维护策略、PyTorch 维护策略、硬件支持提取到单独文件 # 【资料变更】 > 请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及” 涉及 # 【接口变更】 > 请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及，需要详细说明接口以及对应的变更内容，同时需要在资料中体现。如不涉及，需填写“不涉及” 不涉及 # 【功能验证】 > 说明测试场景，测试方法。如果本次测试方式与常规单元测试不同，请详细说明您的测试步骤\ > 新增/变更内容是否已新增/适配UT测试用例看护，并补充测试自验证截图 不涉及 # 【CheckList】 > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!42070 | 1 个月前 |