| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
[docs][fix]TORCH_LOGS.md Co-authored-by: AACAES<liuyan7892@163.com> # message auto-generated for no-merge-commit merge: !46345 merge doc/env-vars-inductor into master [docs][fix]TORCH_LOGS.md Created-by: AACAES Commit-by: AACAES Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > <font color="red">**如有社区issue，请关联issue链接**</font>\ > <font color="red">**请勿携带内部流程信息（需求链接、问题单、内部issue等）**</font> - [x] 需求 - [ ] 问题单 - [ ] issue/工单 - [ ] 重构优化 - [ ] 资料更新 https://gitcode.com/Ascend/pytorch/issues/4435 # 【修改方案】 > 请描述修改内容的具体实现，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列\ > 如果是需求或者重构类的PR，需要补充详细设计文档（说明上下游组件关系、时序图、类图、DFX能力等内容） 规范TORCH_LOGS.md内容格式 # 【资料变更】 > 请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及” 规范TORCH_LOGS.md内容格式 # 【接口变更】 > 请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及，需要详细说明接口以及对应的变更内容，同时需要在资料中体现。如不涉及，需填写“不涉及” 不涉及 # 【功能验证】 > 说明测试场景，测试方法。如果本次测试方式与常规单元测试不同，请详细说明您的测试步骤\ > 新增/变更内容是否已新增/适配UT测试用例看护，并补充测试自验证截图 不涉及 # 【CheckList】 > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!46345 | 21 天前 | |
[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 | 2 个月前 | |
【docs】整合环境变量文档更新并重构分类导航 Co-authored-by: Xinrui Chen<chenxinrui11@huawei.com> # message auto-generated for no-merge-commit merge: !46030 merge codex/integrate-env-docs-master into master 【docs】整合环境变量文档更新并重构分类导航 Created-by: chenrayray Commit-by: Xinrui Chen Merged-by: ascend-robot Description: # 【合入来源】 - [x] issue/工单 - [x] 重构优化 - [x] 资料更新 关联Issue：https://gitcode.com/Ascend/pytorch/issues/4691 整合来源：[PR #45521](https://gitcode.com/Ascend/pytorch/pull/45521)、[PR #45307](https://gitcode.com/Ascend/pytorch/pull/45307)、[PR #45973](https://gitcode.com/Ascend/pytorch/pull/45973)及环境变量梳理结果。 # 【修改方案】 补齐分散的环境变量文档及导航入口，使100项环境变量能在总列表、总目录和分类目录中一致检索。 1. 在master基线上三方整合两个PR，纳入Inductor、分布式通信、启动和对称内存配置，保留master较新的说明，按#45521移除MFusion、AKG旧详情页。 2. 新增PYTORCH_HAL_BASED_NPU_CHECK和PYTORCH_ALLOC_CONF独立详情；补充溢出检测的版本不足告警行为，保留来源中的HAL失败回退Runtime及分配器配置互斥约束。 3. 导航按使用场景整理为设备初始化与管理、算子执行与兼容性、单算子编译与缓存、内存管理、分布式启动与建链、分布式通信与诊断、日志与告警、特征值检测、性能优化与采集、图编译共10类。 4. 分布式通信细分为通信执行与同步、超时监控与故障记录、状态与性能采集、DDP与RPC四组；图编译细分为编译模式与回退、缓存与编译并发、算子融合与自动调优、图优化与调度、调试日志与精度检查五组。 5. 将60个详情页的PyTorch对照说明融入功能描述，存在实际差异时通过提示块突出默认值或实现差异；新增统一的PyTorch环境变量对照表，按同名变量、异名或相关变量、配置项对照三组集中展示38项已有对照说明，并接入总目录和变量列表。 6. 补入PR #45973的HAL检测细节：解析ASCEND_RT_VISIBLE_DEVICES、动态加载libascend_hal.so，以及Runtime首次非零设备数缓存行为。该变量详情页、总列表和两级目录入口已包含，保留上游对应关系说明。 分类设计： TORCH_LOGS归入“日志与告警”，详情文件位于alarm_message_printing/TORCH_LOGS.md，与分类对应；图编译分类仅保留交叉引用。“特征值检测”保留标准名称及原有NPU_ASD变量范围，Inf/NaN模式和FORCE_OVERFLOW_CHECK归入算子执行与兼容性。每项变量只有一个主分类，领域专用的诊断配置保留在通信或图编译分类。TORCH_LOGS详情页移至日志目录，并同步总列表、总目录、分类目录和对照表链接；旧同步超时目录保留兼容入口。PYTORCH_ALLOC_CONF链接到原分配器参数页，避免维护两份参数说明。 事实内容以三个来源PR和环境变量梳理表为准，保留master已有的较新说明，统一分类、导航及上游对比的展示方式。 # 【资料变更】 按环境变量梳理：文档新增收录54项、更新已有7项、移除旧项2项，整合后共收录100项。各变量的用途和本次修改内容如下。 ## 新增收录的环境变量（54项） ### 分布式通信与诊断（19项） | 环境变量 | 用途 | | --- | --- | | [DDP_SET_LAST_BUCKET_CAP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/DDP_SET_LAST_BUCKET_CAP.md) | 通过此环境变量可控制DDP的bucket重建顺序。 | | [NSLB_CP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_CP.md) | 通过此环境变量可配置HCCL NSLB采样记录的目录路径。 | | [NSLB_MAX_RECORD_NUM](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_MAX_RECORD_NUM.md) | 通过此环境变量可配置每个PG的最大NSLB采样记录数量。 | | [PERF_DUMP_CONFIG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_CONFIG.md) | 通过此环境变量可配置HCCL操作的性能数据记录功能。 | | [PERF_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_PATH.md) | 通过此环境变量可配置HCCL性能dump文件的输出目录。 | | [TORCH_HCCL_COORD_CHECK_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_COORD_CHECK_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置WatchDog轮询检查Store dump signal的间隔时间。 | | [TORCH_HCCL_DEBUG_INFO_PIPE_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_PIPE_FILE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置命名管道文件，用于外部触发Flight Recorder dump。 | | [TORCH_HCCL_DEBUG_INFO_TEMP_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_TEMP_FILE.md) | 通过此环境变量可配置HCCL dump文件的名称前缀。 | | [TORCH_HCCL_DUMP_ON_TIMEOUT](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DUMP_ON_TIMEOUT.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制超时或错误时是否自动触发Flight Recorder dump。 | | [TORCH_HCCL_ENABLE_MONITORING](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_ENABLE_MONITORING.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否启动heartbeat monitor线程。 | | [TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置heartbeat monitor判定WatchDog卡死的超时时间。 | | [TORCH_HCCL_HIGH_PRIORITY](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HIGH_PRIORITY.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否强制使用高优先级NPU stream。 | | [TORCH_HCCL_STATUS_SAVE_ENABLE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_ENABLE.md) | 通过此环境变量可控制HCCL进程组状态信息的周期性保存。 | | [TORCH_HCCL_STATUS_SAVE_INTERVAL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_INTERVAL.md) | 通过此环境变量可配置HCCL状态保存的间隔时间。 | | [TORCH_HCCL_STATUS_SAVE_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_PATH.md) | 通过此环境变量可配置HCCL状态文件的保存目录。 | | [TORCH_HCCL_TRACE_BUFFER_SIZE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_BUFFER_SIZE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置Flight Recorder环形缓冲区最大事件数，默认关闭。 | | [TORCH_HCCL_TRACE_CPP_STACK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_CPP_STACK.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制在记录事件时是否采集C++调用栈。 | | [TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置monitor等待异步dump完成的最大时间。 | | [TP_SOCKET_IFNAME](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TP_SOCKET_IFNAME.md) | 通过此环境变量可指定TensorPipe RPC传输层使用的网络接口名称。 | ### 设备初始化与管理（1项） | 环境变量 | 用途 | | --- | --- | | [PYTORCH_HAL_BASED_NPU_CHECK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/device_management/PYTORCH_HAL_BASED_NPU_CHECK.md) | 选择NPU可用性检测路径，配置为1时优先通过Ascend HAL查询设备数量，失败时回退到Runtime。 | ### 分布式启动与建链（4项） | 环境变量 | 用途 | | --- | --- | | [ENABLE_TIERED_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/ENABLE_TIERED_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制ParallelStore是否启用分层建链优化模式。 | | [PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH.md) | 通过此环境变量可将agent PID传递给ParallelStore，用于本地socket路径生成。 | | [TORCH_NPU_ELASTIC_USE_AGENT_STORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_ELASTIC_USE_AGENT_STORE.md) | 通过此环境变量可控制是否使用agent已启动的ParallelStore。 | | [TORCH_NPU_USE_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_USE_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制是否启用ParallelStore作为分布式存储后端，提升建链性能。 | ### 日志与告警（1项） | 环境变量 | 用途 | | --- | --- | | [TORCH_LOGS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/alarm_message_printing/TORCH_LOGS.md) | 通过此环境变量可控制PyTorch各模块的日志输出级别，与PyTorch上游行为一致。 | ### 图编译（27项） | 环境变量 | 用途 | | --- | --- | | [CATLASS_EPILOGUE_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/CATLASS_EPILOGUE_FUSION.md) | 通过此环境变量可控制是否开启Catlass epilogue融合功能，与PyTorch上游的CUTLASS_EPILOGUE_FUSION对应。 | | [ENABLE_INPLACE_BUFFERS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_INPLACE_BUFFERS.md) | 通过此环境变量可控制是否启用原地缓冲区优化。 | | [ENABLE_PARALLEL_SCHEDULER](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_PARALLEL_SCHEDULER.md) | 通过此环境变量可控制是否启用并行调度器FX pass。 | | [FX_SUBGRAPH_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/FX_SUBGRAPH_DUMP_PATH.md) | 通过此环境变量可配置DVM模式下FX子图的dump路径。 | | [INDUCTOR_ASCEND_DEBUG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DEBUG.md) | 通过此环境变量可控制Triton编译时是否启用调试模式。 | | [INDUCTOR_ASCEND_DUMP_FX_GRAPH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DUMP_FX_GRAPH.md) | 通过此环境变量可控制在Inductor降层时是否导出FX图。 | | [INDUCTOR_ASCEND_FX_GRAPH_CACHE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_FX_GRAPH_CACHE.md) | 通过此环境变量可配置Inductor降层时FX图缓存的目录路径。 | | [INDUCTOR_ASCEND_LOG_LEVEL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_LOG_LEVEL.md) | 通过此环境变量可配置Inductor模块的日志级别。 | | [INDUCTOR_DVM_ENABLE_MATMUL_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_DVM_ENABLE_MATMUL_FUSION.md) | 通过此环境变量可开启DVM MatMul template融合，将矩阵乘算子融合为DVM template kernel。 | | [NPU_INDUCTOR_DYNAMIC_FX_PASS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/NPU_INDUCTOR_DYNAMIC_FX_PASS.md) | 通过此环境变量可控制图优化FX pass是否使用动态shape模式。 | | [PARALLEL_SCHEDULER_NODES_MIN](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/in See merge request: Ascend/pytorch!46030 | 27 天前 | |
【docs】整合环境变量文档更新并重构分类导航 Co-authored-by: Xinrui Chen<chenxinrui11@huawei.com> # message auto-generated for no-merge-commit merge: !46030 merge codex/integrate-env-docs-master into master 【docs】整合环境变量文档更新并重构分类导航 Created-by: chenrayray Commit-by: Xinrui Chen Merged-by: ascend-robot Description: # 【合入来源】 - [x] issue/工单 - [x] 重构优化 - [x] 资料更新 关联Issue：https://gitcode.com/Ascend/pytorch/issues/4691 整合来源：[PR #45521](https://gitcode.com/Ascend/pytorch/pull/45521)、[PR #45307](https://gitcode.com/Ascend/pytorch/pull/45307)、[PR #45973](https://gitcode.com/Ascend/pytorch/pull/45973)及环境变量梳理结果。 # 【修改方案】 补齐分散的环境变量文档及导航入口，使100项环境变量能在总列表、总目录和分类目录中一致检索。 1. 在master基线上三方整合两个PR，纳入Inductor、分布式通信、启动和对称内存配置，保留master较新的说明，按#45521移除MFusion、AKG旧详情页。 2. 新增PYTORCH_HAL_BASED_NPU_CHECK和PYTORCH_ALLOC_CONF独立详情；补充溢出检测的版本不足告警行为，保留来源中的HAL失败回退Runtime及分配器配置互斥约束。 3. 导航按使用场景整理为设备初始化与管理、算子执行与兼容性、单算子编译与缓存、内存管理、分布式启动与建链、分布式通信与诊断、日志与告警、特征值检测、性能优化与采集、图编译共10类。 4. 分布式通信细分为通信执行与同步、超时监控与故障记录、状态与性能采集、DDP与RPC四组；图编译细分为编译模式与回退、缓存与编译并发、算子融合与自动调优、图优化与调度、调试日志与精度检查五组。 5. 将60个详情页的PyTorch对照说明融入功能描述，存在实际差异时通过提示块突出默认值或实现差异；新增统一的PyTorch环境变量对照表，按同名变量、异名或相关变量、配置项对照三组集中展示38项已有对照说明，并接入总目录和变量列表。 6. 补入PR #45973的HAL检测细节：解析ASCEND_RT_VISIBLE_DEVICES、动态加载libascend_hal.so，以及Runtime首次非零设备数缓存行为。该变量详情页、总列表和两级目录入口已包含，保留上游对应关系说明。 分类设计： TORCH_LOGS归入“日志与告警”，详情文件位于alarm_message_printing/TORCH_LOGS.md，与分类对应；图编译分类仅保留交叉引用。“特征值检测”保留标准名称及原有NPU_ASD变量范围，Inf/NaN模式和FORCE_OVERFLOW_CHECK归入算子执行与兼容性。每项变量只有一个主分类，领域专用的诊断配置保留在通信或图编译分类。TORCH_LOGS详情页移至日志目录，并同步总列表、总目录、分类目录和对照表链接；旧同步超时目录保留兼容入口。PYTORCH_ALLOC_CONF链接到原分配器参数页，避免维护两份参数说明。 事实内容以三个来源PR和环境变量梳理表为准，保留master已有的较新说明，统一分类、导航及上游对比的展示方式。 # 【资料变更】 按环境变量梳理：文档新增收录54项、更新已有7项、移除旧项2项，整合后共收录100项。各变量的用途和本次修改内容如下。 ## 新增收录的环境变量（54项） ### 分布式通信与诊断（19项） | 环境变量 | 用途 | | --- | --- | | [DDP_SET_LAST_BUCKET_CAP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/DDP_SET_LAST_BUCKET_CAP.md) | 通过此环境变量可控制DDP的bucket重建顺序。 | | [NSLB_CP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_CP.md) | 通过此环境变量可配置HCCL NSLB采样记录的目录路径。 | | [NSLB_MAX_RECORD_NUM](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_MAX_RECORD_NUM.md) | 通过此环境变量可配置每个PG的最大NSLB采样记录数量。 | | [PERF_DUMP_CONFIG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_CONFIG.md) | 通过此环境变量可配置HCCL操作的性能数据记录功能。 | | [PERF_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_PATH.md) | 通过此环境变量可配置HCCL性能dump文件的输出目录。 | | [TORCH_HCCL_COORD_CHECK_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_COORD_CHECK_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置WatchDog轮询检查Store dump signal的间隔时间。 | | [TORCH_HCCL_DEBUG_INFO_PIPE_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_PIPE_FILE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置命名管道文件，用于外部触发Flight Recorder dump。 | | [TORCH_HCCL_DEBUG_INFO_TEMP_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_TEMP_FILE.md) | 通过此环境变量可配置HCCL dump文件的名称前缀。 | | [TORCH_HCCL_DUMP_ON_TIMEOUT](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DUMP_ON_TIMEOUT.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制超时或错误时是否自动触发Flight Recorder dump。 | | [TORCH_HCCL_ENABLE_MONITORING](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_ENABLE_MONITORING.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否启动heartbeat monitor线程。 | | [TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置heartbeat monitor判定WatchDog卡死的超时时间。 | | [TORCH_HCCL_HIGH_PRIORITY](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HIGH_PRIORITY.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否强制使用高优先级NPU stream。 | | [TORCH_HCCL_STATUS_SAVE_ENABLE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_ENABLE.md) | 通过此环境变量可控制HCCL进程组状态信息的周期性保存。 | | [TORCH_HCCL_STATUS_SAVE_INTERVAL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_INTERVAL.md) | 通过此环境变量可配置HCCL状态保存的间隔时间。 | | [TORCH_HCCL_STATUS_SAVE_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_PATH.md) | 通过此环境变量可配置HCCL状态文件的保存目录。 | | [TORCH_HCCL_TRACE_BUFFER_SIZE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_BUFFER_SIZE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置Flight Recorder环形缓冲区最大事件数，默认关闭。 | | [TORCH_HCCL_TRACE_CPP_STACK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_CPP_STACK.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制在记录事件时是否采集C++调用栈。 | | [TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置monitor等待异步dump完成的最大时间。 | | [TP_SOCKET_IFNAME](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TP_SOCKET_IFNAME.md) | 通过此环境变量可指定TensorPipe RPC传输层使用的网络接口名称。 | ### 设备初始化与管理（1项） | 环境变量 | 用途 | | --- | --- | | [PYTORCH_HAL_BASED_NPU_CHECK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/device_management/PYTORCH_HAL_BASED_NPU_CHECK.md) | 选择NPU可用性检测路径，配置为1时优先通过Ascend HAL查询设备数量，失败时回退到Runtime。 | ### 分布式启动与建链（4项） | 环境变量 | 用途 | | --- | --- | | [ENABLE_TIERED_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/ENABLE_TIERED_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制ParallelStore是否启用分层建链优化模式。 | | [PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH.md) | 通过此环境变量可将agent PID传递给ParallelStore，用于本地socket路径生成。 | | [TORCH_NPU_ELASTIC_USE_AGENT_STORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_ELASTIC_USE_AGENT_STORE.md) | 通过此环境变量可控制是否使用agent已启动的ParallelStore。 | | [TORCH_NPU_USE_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_USE_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制是否启用ParallelStore作为分布式存储后端，提升建链性能。 | ### 日志与告警（1项） | 环境变量 | 用途 | | --- | --- | | [TORCH_LOGS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/alarm_message_printing/TORCH_LOGS.md) | 通过此环境变量可控制PyTorch各模块的日志输出级别，与PyTorch上游行为一致。 | ### 图编译（27项） | 环境变量 | 用途 | | --- | --- | | [CATLASS_EPILOGUE_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/CATLASS_EPILOGUE_FUSION.md) | 通过此环境变量可控制是否开启Catlass epilogue融合功能，与PyTorch上游的CUTLASS_EPILOGUE_FUSION对应。 | | [ENABLE_INPLACE_BUFFERS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_INPLACE_BUFFERS.md) | 通过此环境变量可控制是否启用原地缓冲区优化。 | | [ENABLE_PARALLEL_SCHEDULER](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_PARALLEL_SCHEDULER.md) | 通过此环境变量可控制是否启用并行调度器FX pass。 | | [FX_SUBGRAPH_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/FX_SUBGRAPH_DUMP_PATH.md) | 通过此环境变量可配置DVM模式下FX子图的dump路径。 | | [INDUCTOR_ASCEND_DEBUG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DEBUG.md) | 通过此环境变量可控制Triton编译时是否启用调试模式。 | | [INDUCTOR_ASCEND_DUMP_FX_GRAPH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DUMP_FX_GRAPH.md) | 通过此环境变量可控制在Inductor降层时是否导出FX图。 | | [INDUCTOR_ASCEND_FX_GRAPH_CACHE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_FX_GRAPH_CACHE.md) | 通过此环境变量可配置Inductor降层时FX图缓存的目录路径。 | | [INDUCTOR_ASCEND_LOG_LEVEL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_LOG_LEVEL.md) | 通过此环境变量可配置Inductor模块的日志级别。 | | [INDUCTOR_DVM_ENABLE_MATMUL_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_DVM_ENABLE_MATMUL_FUSION.md) | 通过此环境变量可开启DVM MatMul template融合，将矩阵乘算子融合为DVM template kernel。 | | [NPU_INDUCTOR_DYNAMIC_FX_PASS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/NPU_INDUCTOR_DYNAMIC_FX_PASS.md) | 通过此环境变量可控制图优化FX pass是否使用动态shape模式。 | | [PARALLEL_SCHEDULER_NODES_MIN](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/in See merge request: Ascend/pytorch!46030 | 27 天前 | |
【docs】整合环境变量文档更新并重构分类导航 Co-authored-by: Xinrui Chen<chenxinrui11@huawei.com> # message auto-generated for no-merge-commit merge: !46030 merge codex/integrate-env-docs-master into master 【docs】整合环境变量文档更新并重构分类导航 Created-by: chenrayray Commit-by: Xinrui Chen Merged-by: ascend-robot Description: # 【合入来源】 - [x] issue/工单 - [x] 重构优化 - [x] 资料更新 关联Issue：https://gitcode.com/Ascend/pytorch/issues/4691 整合来源：[PR #45521](https://gitcode.com/Ascend/pytorch/pull/45521)、[PR #45307](https://gitcode.com/Ascend/pytorch/pull/45307)、[PR #45973](https://gitcode.com/Ascend/pytorch/pull/45973)及环境变量梳理结果。 # 【修改方案】 补齐分散的环境变量文档及导航入口，使100项环境变量能在总列表、总目录和分类目录中一致检索。 1. 在master基线上三方整合两个PR，纳入Inductor、分布式通信、启动和对称内存配置，保留master较新的说明，按#45521移除MFusion、AKG旧详情页。 2. 新增PYTORCH_HAL_BASED_NPU_CHECK和PYTORCH_ALLOC_CONF独立详情；补充溢出检测的版本不足告警行为，保留来源中的HAL失败回退Runtime及分配器配置互斥约束。 3. 导航按使用场景整理为设备初始化与管理、算子执行与兼容性、单算子编译与缓存、内存管理、分布式启动与建链、分布式通信与诊断、日志与告警、特征值检测、性能优化与采集、图编译共10类。 4. 分布式通信细分为通信执行与同步、超时监控与故障记录、状态与性能采集、DDP与RPC四组；图编译细分为编译模式与回退、缓存与编译并发、算子融合与自动调优、图优化与调度、调试日志与精度检查五组。 5. 将60个详情页的PyTorch对照说明融入功能描述，存在实际差异时通过提示块突出默认值或实现差异；新增统一的PyTorch环境变量对照表，按同名变量、异名或相关变量、配置项对照三组集中展示38项已有对照说明，并接入总目录和变量列表。 6. 补入PR #45973的HAL检测细节：解析ASCEND_RT_VISIBLE_DEVICES、动态加载libascend_hal.so，以及Runtime首次非零设备数缓存行为。该变量详情页、总列表和两级目录入口已包含，保留上游对应关系说明。 分类设计： TORCH_LOGS归入“日志与告警”，详情文件位于alarm_message_printing/TORCH_LOGS.md，与分类对应；图编译分类仅保留交叉引用。“特征值检测”保留标准名称及原有NPU_ASD变量范围，Inf/NaN模式和FORCE_OVERFLOW_CHECK归入算子执行与兼容性。每项变量只有一个主分类，领域专用的诊断配置保留在通信或图编译分类。TORCH_LOGS详情页移至日志目录，并同步总列表、总目录、分类目录和对照表链接；旧同步超时目录保留兼容入口。PYTORCH_ALLOC_CONF链接到原分配器参数页，避免维护两份参数说明。 事实内容以三个来源PR和环境变量梳理表为准，保留master已有的较新说明，统一分类、导航及上游对比的展示方式。 # 【资料变更】 按环境变量梳理：文档新增收录54项、更新已有7项、移除旧项2项，整合后共收录100项。各变量的用途和本次修改内容如下。 ## 新增收录的环境变量（54项） ### 分布式通信与诊断（19项） | 环境变量 | 用途 | | --- | --- | | [DDP_SET_LAST_BUCKET_CAP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/DDP_SET_LAST_BUCKET_CAP.md) | 通过此环境变量可控制DDP的bucket重建顺序。 | | [NSLB_CP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_CP.md) | 通过此环境变量可配置HCCL NSLB采样记录的目录路径。 | | [NSLB_MAX_RECORD_NUM](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_MAX_RECORD_NUM.md) | 通过此环境变量可配置每个PG的最大NSLB采样记录数量。 | | [PERF_DUMP_CONFIG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_CONFIG.md) | 通过此环境变量可配置HCCL操作的性能数据记录功能。 | | [PERF_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_PATH.md) | 通过此环境变量可配置HCCL性能dump文件的输出目录。 | | [TORCH_HCCL_COORD_CHECK_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_COORD_CHECK_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置WatchDog轮询检查Store dump signal的间隔时间。 | | [TORCH_HCCL_DEBUG_INFO_PIPE_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_PIPE_FILE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置命名管道文件，用于外部触发Flight Recorder dump。 | | [TORCH_HCCL_DEBUG_INFO_TEMP_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_TEMP_FILE.md) | 通过此环境变量可配置HCCL dump文件的名称前缀。 | | [TORCH_HCCL_DUMP_ON_TIMEOUT](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DUMP_ON_TIMEOUT.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制超时或错误时是否自动触发Flight Recorder dump。 | | [TORCH_HCCL_ENABLE_MONITORING](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_ENABLE_MONITORING.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否启动heartbeat monitor线程。 | | [TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置heartbeat monitor判定WatchDog卡死的超时时间。 | | [TORCH_HCCL_HIGH_PRIORITY](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HIGH_PRIORITY.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否强制使用高优先级NPU stream。 | | [TORCH_HCCL_STATUS_SAVE_ENABLE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_ENABLE.md) | 通过此环境变量可控制HCCL进程组状态信息的周期性保存。 | | [TORCH_HCCL_STATUS_SAVE_INTERVAL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_INTERVAL.md) | 通过此环境变量可配置HCCL状态保存的间隔时间。 | | [TORCH_HCCL_STATUS_SAVE_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_PATH.md) | 通过此环境变量可配置HCCL状态文件的保存目录。 | | [TORCH_HCCL_TRACE_BUFFER_SIZE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_BUFFER_SIZE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置Flight Recorder环形缓冲区最大事件数，默认关闭。 | | [TORCH_HCCL_TRACE_CPP_STACK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_CPP_STACK.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制在记录事件时是否采集C++调用栈。 | | [TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置monitor等待异步dump完成的最大时间。 | | [TP_SOCKET_IFNAME](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TP_SOCKET_IFNAME.md) | 通过此环境变量可指定TensorPipe RPC传输层使用的网络接口名称。 | ### 设备初始化与管理（1项） | 环境变量 | 用途 | | --- | --- | | [PYTORCH_HAL_BASED_NPU_CHECK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/device_management/PYTORCH_HAL_BASED_NPU_CHECK.md) | 选择NPU可用性检测路径，配置为1时优先通过Ascend HAL查询设备数量，失败时回退到Runtime。 | ### 分布式启动与建链（4项） | 环境变量 | 用途 | | --- | --- | | [ENABLE_TIERED_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/ENABLE_TIERED_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制ParallelStore是否启用分层建链优化模式。 | | [PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH.md) | 通过此环境变量可将agent PID传递给ParallelStore，用于本地socket路径生成。 | | [TORCH_NPU_ELASTIC_USE_AGENT_STORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_ELASTIC_USE_AGENT_STORE.md) | 通过此环境变量可控制是否使用agent已启动的ParallelStore。 | | [TORCH_NPU_USE_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_USE_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制是否启用ParallelStore作为分布式存储后端，提升建链性能。 | ### 日志与告警（1项） | 环境变量 | 用途 | | --- | --- | | [TORCH_LOGS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/alarm_message_printing/TORCH_LOGS.md) | 通过此环境变量可控制PyTorch各模块的日志输出级别，与PyTorch上游行为一致。 | ### 图编译（27项） | 环境变量 | 用途 | | --- | --- | | [CATLASS_EPILOGUE_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/CATLASS_EPILOGUE_FUSION.md) | 通过此环境变量可控制是否开启Catlass epilogue融合功能，与PyTorch上游的CUTLASS_EPILOGUE_FUSION对应。 | | [ENABLE_INPLACE_BUFFERS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_INPLACE_BUFFERS.md) | 通过此环境变量可控制是否启用原地缓冲区优化。 | | [ENABLE_PARALLEL_SCHEDULER](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_PARALLEL_SCHEDULER.md) | 通过此环境变量可控制是否启用并行调度器FX pass。 | | [FX_SUBGRAPH_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/FX_SUBGRAPH_DUMP_PATH.md) | 通过此环境变量可配置DVM模式下FX子图的dump路径。 | | [INDUCTOR_ASCEND_DEBUG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DEBUG.md) | 通过此环境变量可控制Triton编译时是否启用调试模式。 | | [INDUCTOR_ASCEND_DUMP_FX_GRAPH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DUMP_FX_GRAPH.md) | 通过此环境变量可控制在Inductor降层时是否导出FX图。 | | [INDUCTOR_ASCEND_FX_GRAPH_CACHE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_FX_GRAPH_CACHE.md) | 通过此环境变量可配置Inductor降层时FX图缓存的目录路径。 | | [INDUCTOR_ASCEND_LOG_LEVEL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_LOG_LEVEL.md) | 通过此环境变量可配置Inductor模块的日志级别。 | | [INDUCTOR_DVM_ENABLE_MATMUL_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_DVM_ENABLE_MATMUL_FUSION.md) | 通过此环境变量可开启DVM MatMul template融合，将矩阵乘算子融合为DVM template kernel。 | | [NPU_INDUCTOR_DYNAMIC_FX_PASS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/NPU_INDUCTOR_DYNAMIC_FX_PASS.md) | 通过此环境变量可控制图优化FX pass是否使用动态shape模式。 | | [PARALLEL_SCHEDULER_NODES_MIN](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/in See merge request: Ascend/pytorch!46030 | 27 天前 | |
docs(asd): update checksum linkage dtype support to bf16/fp32 Co-authored-by: wuyouqi1<wuyouqi1@h-partners.com> # message auto-generated for no-merge-commit merge: !46144 merge docs/asd-checksum-dtype into master docs(asd): update checksum linkage dtype support to bf16/fp32 Created-by: wuyouqi1 Commit-by: wuyouqi1 Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > <font color="red">**如有社区issue，请关联issue链接**</font>\ > <font color="red">**请勿携带内部流程信息（需求链接、问题单、内部issue等）**</font> - [x] 需求 https://gitcode.com/Ascend/pytorch/issues/4730 - [ ] 问题单 - [ ] issue/工单 - [ ] 重构优化 - [x] 资料更新 # 【修改方案】 > 请描述修改内容的具体实现，涉及哪些组件之间是如何交互的，可以用1、2、3、...进行罗列\ > 如果是需求或者重构类的PR，需要补充详细设计文档（说明上下游组件关系、时序图、类图、DFX能力等内容） ASD 特征值检测的 checksum 联动功能已扩展支持 FP32（对应代码合入 torch_npu/asd/checksum.py 与 torch_npu/asd/asd.py：matmul checksum 支持 BF16/FP32，with_checksum 自动注入 hook 的 dtype 门禁由 BF16 放宽为 BF16/FP32）。同步更新文档中“使用约束”的相关描述： 1. docs/zh/api/environment_variable/eigenvalue_detection/NPU_ASD_CONFIG.md：“checksum联动仅支持**BF16**的数据类型”→“仅支持**BF16**或**FP32**的数据类型”。 2. docs/en/api/environment_variable/NPU_ASD_CONFIG.md：同步英文表述（only **BF16** → only **BF16** and **FP32**）。 3. docs/zh/developer_notes/fault_diagnosis/feature_value_detection.md 与 docs/en/developer_notes/framework_feature_guide_pytorch/feature_value_detection.md：约束说明中的同一句同步更新（该文档被 NPU_ASD_CONFIG 环境变量页超链接引用，保持口径一致）。 FP16 无算子侧推荐 e_max，维持不支持，表述保留“仅/only”。 # 【资料变更】 > 请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及” 涉及：本 PR 即资料修改，共 4 个文档文件、每文件 1 行（checksum 联动支持的 dtype 约束 BF16 → BF16/FP32），中英文一致。 # 【接口变更】 > 请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及，需要详细说明接口以及对应的变更内容，同时需要在资料中体现。如不涉及，需填写“不涉及” 不涉及（无代码改动；torch_npu.matmul_checksum 的 dtype 支持扩展由代码 PR 单独合入，本 PR 仅同步资料）。 # 【功能验证】 > 说明测试场景，测试方法。如果本次测试方式与常规单元测试不同，请详细说明您的测试步骤\ > 新增/变更内容是否已新增/适配UT测试用例看护，并补充测试自验证截图 纯文档修改。自验： 1. 中英文 4 个文件已全量检索，无遗漏的“checksum联动仅支持BF16”类表述（grep -rn "checksum" docs/zh docs/en 复核）。 2. 修改仅限“使用约束/约束说明”小节的 1 行措辞，不改变文档结构与超链接目标。 3. 与代码行为一致性：torch_npu/asd/asd.py 中 _MATMUL_CHECKSUM_DTYPES = (torch.bfloat16, torch.float32)，torch_npu/asd/checksum.py 校验 bf16/fp32、fp16 TypeError。 # 【CheckList】 > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!46144 | 21 天前 | |
docs: Add_inductor_envs_master Co-authored-by: qiaoyaodan<qiaoyaodan@huawei.com> # message auto-generated for no-merge-commit merge: !46154 merge env_docs into master docs: Add_inductor_envs_master Created-by: qiaoyaodan888 Commit-by: qiaoyaodan Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > <font color="red">**如有社区issue，请关联issue链接**</font>\ > <font color="red">**请勿携带内部流程信息（需求链接、问题单、内部issue等）**</font> - [x] 需求 - [ ] 问题单 - [ ] issue/工单 - [ ] 重构优化 - [x] 资料更新 # 【修改方案】 1、添加下面5个环境变量的相关文档 INDUCTOR_ASCEND_AGGRESSIVE_AUTOTUNE INDUCTOR_ASCEND_SYMBOLIC_GROUP_AUTOTUNE INDUCTOR_ASCEND_SYMBOLIC_GROUP_TEMPLATES INDUCTOR_ASCEND_ENABLE_COSTMODEL INDUCTOR_ASCEND_COSTMODEL_RATIO 2、同步更新索引/导航文件（env_variable_list.md、_menu_environment_variable.md、_menu_inductor.md） 3、更新torch_npu/_inductor/docs/installation/installation.md中 PyTorch 版本支持说明（2.7.1 和 2.9.0） # 【资料变更】 > 请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及” # 【接口变更】 > 请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及，需要详细说明接口以及对应的变更内容，同时需要在资料中体现。如不涉及，需填写“不涉及” # 【功能验证】 > 说明测试场景，测试方法。如果本次测试方式与常规单元测试不同，请详细说明您的测试步骤\ > 新增/变更内容是否已新增/适配UT测试用例看护，并补充测试自验证截图 # 【CheckList】 > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!46154 | 22 天前 | |
【docs】整合环境变量文档更新并重构分类导航 Co-authored-by: Xinrui Chen<chenxinrui11@huawei.com> # message auto-generated for no-merge-commit merge: !46030 merge codex/integrate-env-docs-master into master 【docs】整合环境变量文档更新并重构分类导航 Created-by: chenrayray Commit-by: Xinrui Chen Merged-by: ascend-robot Description: # 【合入来源】 - [x] issue/工单 - [x] 重构优化 - [x] 资料更新 关联Issue：https://gitcode.com/Ascend/pytorch/issues/4691 整合来源：[PR #45521](https://gitcode.com/Ascend/pytorch/pull/45521)、[PR #45307](https://gitcode.com/Ascend/pytorch/pull/45307)、[PR #45973](https://gitcode.com/Ascend/pytorch/pull/45973)及环境变量梳理结果。 # 【修改方案】 补齐分散的环境变量文档及导航入口，使100项环境变量能在总列表、总目录和分类目录中一致检索。 1. 在master基线上三方整合两个PR，纳入Inductor、分布式通信、启动和对称内存配置，保留master较新的说明，按#45521移除MFusion、AKG旧详情页。 2. 新增PYTORCH_HAL_BASED_NPU_CHECK和PYTORCH_ALLOC_CONF独立详情；补充溢出检测的版本不足告警行为，保留来源中的HAL失败回退Runtime及分配器配置互斥约束。 3. 导航按使用场景整理为设备初始化与管理、算子执行与兼容性、单算子编译与缓存、内存管理、分布式启动与建链、分布式通信与诊断、日志与告警、特征值检测、性能优化与采集、图编译共10类。 4. 分布式通信细分为通信执行与同步、超时监控与故障记录、状态与性能采集、DDP与RPC四组；图编译细分为编译模式与回退、缓存与编译并发、算子融合与自动调优、图优化与调度、调试日志与精度检查五组。 5. 将60个详情页的PyTorch对照说明融入功能描述，存在实际差异时通过提示块突出默认值或实现差异；新增统一的PyTorch环境变量对照表，按同名变量、异名或相关变量、配置项对照三组集中展示38项已有对照说明，并接入总目录和变量列表。 6. 补入PR #45973的HAL检测细节：解析ASCEND_RT_VISIBLE_DEVICES、动态加载libascend_hal.so，以及Runtime首次非零设备数缓存行为。该变量详情页、总列表和两级目录入口已包含，保留上游对应关系说明。 分类设计： TORCH_LOGS归入“日志与告警”，详情文件位于alarm_message_printing/TORCH_LOGS.md，与分类对应；图编译分类仅保留交叉引用。“特征值检测”保留标准名称及原有NPU_ASD变量范围，Inf/NaN模式和FORCE_OVERFLOW_CHECK归入算子执行与兼容性。每项变量只有一个主分类，领域专用的诊断配置保留在通信或图编译分类。TORCH_LOGS详情页移至日志目录，并同步总列表、总目录、分类目录和对照表链接；旧同步超时目录保留兼容入口。PYTORCH_ALLOC_CONF链接到原分配器参数页，避免维护两份参数说明。 事实内容以三个来源PR和环境变量梳理表为准，保留master已有的较新说明，统一分类、导航及上游对比的展示方式。 # 【资料变更】 按环境变量梳理：文档新增收录54项、更新已有7项、移除旧项2项，整合后共收录100项。各变量的用途和本次修改内容如下。 ## 新增收录的环境变量（54项） ### 分布式通信与诊断（19项） | 环境变量 | 用途 | | --- | --- | | [DDP_SET_LAST_BUCKET_CAP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/DDP_SET_LAST_BUCKET_CAP.md) | 通过此环境变量可控制DDP的bucket重建顺序。 | | [NSLB_CP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_CP.md) | 通过此环境变量可配置HCCL NSLB采样记录的目录路径。 | | [NSLB_MAX_RECORD_NUM](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_MAX_RECORD_NUM.md) | 通过此环境变量可配置每个PG的最大NSLB采样记录数量。 | | [PERF_DUMP_CONFIG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_CONFIG.md) | 通过此环境变量可配置HCCL操作的性能数据记录功能。 | | [PERF_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_PATH.md) | 通过此环境变量可配置HCCL性能dump文件的输出目录。 | | [TORCH_HCCL_COORD_CHECK_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_COORD_CHECK_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置WatchDog轮询检查Store dump signal的间隔时间。 | | [TORCH_HCCL_DEBUG_INFO_PIPE_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_PIPE_FILE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置命名管道文件，用于外部触发Flight Recorder dump。 | | [TORCH_HCCL_DEBUG_INFO_TEMP_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_TEMP_FILE.md) | 通过此环境变量可配置HCCL dump文件的名称前缀。 | | [TORCH_HCCL_DUMP_ON_TIMEOUT](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DUMP_ON_TIMEOUT.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制超时或错误时是否自动触发Flight Recorder dump。 | | [TORCH_HCCL_ENABLE_MONITORING](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_ENABLE_MONITORING.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否启动heartbeat monitor线程。 | | [TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置heartbeat monitor判定WatchDog卡死的超时时间。 | | [TORCH_HCCL_HIGH_PRIORITY](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HIGH_PRIORITY.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否强制使用高优先级NPU stream。 | | [TORCH_HCCL_STATUS_SAVE_ENABLE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_ENABLE.md) | 通过此环境变量可控制HCCL进程组状态信息的周期性保存。 | | [TORCH_HCCL_STATUS_SAVE_INTERVAL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_INTERVAL.md) | 通过此环境变量可配置HCCL状态保存的间隔时间。 | | [TORCH_HCCL_STATUS_SAVE_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_PATH.md) | 通过此环境变量可配置HCCL状态文件的保存目录。 | | [TORCH_HCCL_TRACE_BUFFER_SIZE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_BUFFER_SIZE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置Flight Recorder环形缓冲区最大事件数，默认关闭。 | | [TORCH_HCCL_TRACE_CPP_STACK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_CPP_STACK.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制在记录事件时是否采集C++调用栈。 | | [TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置monitor等待异步dump完成的最大时间。 | | [TP_SOCKET_IFNAME](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TP_SOCKET_IFNAME.md) | 通过此环境变量可指定TensorPipe RPC传输层使用的网络接口名称。 | ### 设备初始化与管理（1项） | 环境变量 | 用途 | | --- | --- | | [PYTORCH_HAL_BASED_NPU_CHECK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/device_management/PYTORCH_HAL_BASED_NPU_CHECK.md) | 选择NPU可用性检测路径，配置为1时优先通过Ascend HAL查询设备数量，失败时回退到Runtime。 | ### 分布式启动与建链（4项） | 环境变量 | 用途 | | --- | --- | | [ENABLE_TIERED_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/ENABLE_TIERED_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制ParallelStore是否启用分层建链优化模式。 | | [PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH.md) | 通过此环境变量可将agent PID传递给ParallelStore，用于本地socket路径生成。 | | [TORCH_NPU_ELASTIC_USE_AGENT_STORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_ELASTIC_USE_AGENT_STORE.md) | 通过此环境变量可控制是否使用agent已启动的ParallelStore。 | | [TORCH_NPU_USE_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_USE_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制是否启用ParallelStore作为分布式存储后端，提升建链性能。 | ### 日志与告警（1项） | 环境变量 | 用途 | | --- | --- | | [TORCH_LOGS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/alarm_message_printing/TORCH_LOGS.md) | 通过此环境变量可控制PyTorch各模块的日志输出级别，与PyTorch上游行为一致。 | ### 图编译（27项） | 环境变量 | 用途 | | --- | --- | | [CATLASS_EPILOGUE_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/CATLASS_EPILOGUE_FUSION.md) | 通过此环境变量可控制是否开启Catlass epilogue融合功能，与PyTorch上游的CUTLASS_EPILOGUE_FUSION对应。 | | [ENABLE_INPLACE_BUFFERS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_INPLACE_BUFFERS.md) | 通过此环境变量可控制是否启用原地缓冲区优化。 | | [ENABLE_PARALLEL_SCHEDULER](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_PARALLEL_SCHEDULER.md) | 通过此环境变量可控制是否启用并行调度器FX pass。 | | [FX_SUBGRAPH_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/FX_SUBGRAPH_DUMP_PATH.md) | 通过此环境变量可配置DVM模式下FX子图的dump路径。 | | [INDUCTOR_ASCEND_DEBUG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DEBUG.md) | 通过此环境变量可控制Triton编译时是否启用调试模式。 | | [INDUCTOR_ASCEND_DUMP_FX_GRAPH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DUMP_FX_GRAPH.md) | 通过此环境变量可控制在Inductor降层时是否导出FX图。 | | [INDUCTOR_ASCEND_FX_GRAPH_CACHE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_FX_GRAPH_CACHE.md) | 通过此环境变量可配置Inductor降层时FX图缓存的目录路径。 | | [INDUCTOR_ASCEND_LOG_LEVEL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_LOG_LEVEL.md) | 通过此环境变量可配置Inductor模块的日志级别。 | | [INDUCTOR_DVM_ENABLE_MATMUL_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_DVM_ENABLE_MATMUL_FUSION.md) | 通过此环境变量可开启DVM MatMul template融合，将矩阵乘算子融合为DVM template kernel。 | | [NPU_INDUCTOR_DYNAMIC_FX_PASS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/NPU_INDUCTOR_DYNAMIC_FX_PASS.md) | 通过此环境变量可控制图优化FX pass是否使用动态shape模式。 | | [PARALLEL_SCHEDULER_NODES_MIN](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/in See merge request: Ascend/pytorch!46030 | 27 天前 | |
[docs] 更新并新增API模块相关环境变量文档 Co-authored-by: yucaopanmu<yangpeng276@h-partners.com> # message auto-generated for no-merge-commit merge: !46207 merge docs/sort-environment-variables into master [docs] 更新并新增API模块相关环境变量文档 Created-by: yucaopanmu Commit-by: yucaopanmu Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 - [x] 需求 - [ ] 问题单 - [x] issue/工单 [#4691](https://gitcode.com/Ascend/pytorch/issues/4691) - [ ] 重构优化 - [x] 资料更新 # 【修改方案】 本次对 docs/zh/api/environment_variable/ 目录下与API模块有关的环境变量文档进行全面梳理和规范化，主要涉及以下 3 类修改： 新增缺失的环境变量文档（4 个文件） ACL_OP_INIT_MODE.md：新增算子编译初始化模式环境变量文档，覆盖 0/1/2 三种模式的详细说明、默认值规则、使用约束 ACLNN_EXTENSION_SWITCH.md：新增 ACLNN 扩展代码路径开关文档 ACLNN_EXTENSION_PATH.md：新增 ACLNN 扩展代码搜索路径文档 PYTORCH_CUSTOM_DERIVATIVES_PATH.md：新增自定义算子自动微分定义文件路径文档 补齐统一文档结构（11 个文件） 添加 NOTE 告警块：为 11 个缺失 > [!NOTE] 块的文档统一补充"此功能为torch_npu特有，PyTorch社区无直接对应变量"说明，涉及的文件包括 ACL_OP_COMPILER_CACHE_DIR.md、ACL_OP_COMPILER_CACHE_MODE.md、ASCEND_LAUNCH_BLOCKING.md（含 PyTorch 社区 CUDA_LAUNCH_BLOCKING 差异对比）、COMBINED_ENABLE.md、FORCE_OVERFLOW_CHECK.md、INF_NAN_MODE_ENABLE.md、INF_NAN_MODE_FORCE_DISABLE.md、TASK_QUEUE_ENABLE.md、TORCH_NPU_FALLBACK_CPU_DISABLE.md、TORCH_NPU_LEGACY_IMPL_LIST.md、TORCH_NPU_USE_COMPATIBLE_IMPL.md 补充使用约束：将 COMBINED_ENABLE.md、INF_NAN_MODE_ENABLE.md、INF_NAN_MODE_FORCE_DISABLE.md 中"使用约束"为"无"的文档补充为具体的约束条款 修正格式和内容问题（多个文件） 标题转义修复：TORCH_NPU_FALLBACK_CPU_DISABLE.md、TORCH_NPU_LEGACY_IMPL_LIST.md、TORCH_NPU_USE_COMPATIBLE_IMPL.md 标题中下划线未转义（TORCH_NPU_X → TORCH\_NPU\_X） 正文转义修复：INF_NAN_MODE_ENABLE.md、FORCE_OVERFLOW_CHECK.md 中 INF_NAN 未转义为 INF\_NAN 交叉链接补充：ACL_OP_COMPILER_CACHE_DIR.md 中 ACL_OP_COMPILER_CACHE_MODE 由纯文本改为超链接 缩进修复：TASK_QUEUE_ENABLE.md 中默认值描述缩进修正 内容完善：COMBINED_ENABLE.md 功能描述由"通过此环境变量可设置combined标志"重写为完整描述 简述更新：env_variable_list.md 中 COMBINED_ENABLE 简述更新 菜单和列表同步：_menu_op_compilation.md 和 env_variable_list.md 添加 4 个新增环境变量条目 # 【资料变更】 涉及资料变更，修改内容如下： 新增文档（4 个）： docs/zh/api/environment_variable/op_compilation/ACL_OP_INIT_MODE.md docs/zh/api/environment_variable/op_compilation/ACLNN_EXTENSION_SWITCH.md docs/zh/api/environment_variable/op_compilation/ACLNN_EXTENSION_PATH.md docs/zh/api/environment_variable/op_compilation/PYTORCH_CUSTOM_DERIVATIVES_PATH.md 修改文档（13 个）： docs/zh/api/environment_variable/op_compilation/ACL_OP_COMPILER_CACHE_DIR.md：添加 NOTE 告警块，补充交叉链接 docs/zh/api/environment_variable/op_compilation/ACL_OP_COMPILER_CACHE_MODE.md：添加 NOTE 告警块 docs/zh/api/environment_variable/op_execution/ASCEND_LAUNCH_BLOCKING.md：添加 NOTE 告警块（含 PyTorch 社区差异对比），删除多余空行 docs/zh/api/environment_variable/op_execution/COMBINED_ENABLE.md：重写功能描述，添加 NOTE 告警块，补充使用约束 docs/zh/api/environment_variable/op_execution/FORCE_OVERFLOW_CHECK.md：修复 INF_NAN 转义，添加 NOTE 告警块 docs/zh/api/environment_variable/op_execution/INF_NAN_MODE_ENABLE.md：修复 INF_NAN 转义，添加 NOTE 告警块，补充使用约束 docs/zh/api/environment_variable/op_execution/INF_NAN_MODE_FORCE_DISABLE.md：添加 NOTE 告警块，补充使用约束 docs/zh/api/environment_variable/op_execution/TASK_QUEUE_ENABLE.md：修复默认值描述缩进，添加 NOTE 告警块 docs/zh/api/environment_variable/op_execution/TORCH_NPU_FALLBACK_CPU_DISABLE.md：修复标题转义，添加 NOTE 告警块 docs/zh/api/environment_variable/op_execution/TORCH_NPU_LEGACY_IMPL_LIST.md：修复标题转义，添加 NOTE 告警块 docs/zh/api/environment_variable/op_execution/TORCH_NPU_USE_COMPATIBLE_IMPL.md：修复标题转义，添加 NOTE 告警块 docs/zh/api/environment_variable/op_compilation/_menu_op_compilation.md：添加 4 个新增环境变量菜单条目 docs/zh/api/environment_variable/env_variable_list.md：更新 COMBINED_ENABLE 简述，添加 4 个新增环境变量列表条目 # 【接口变更】 不涉及 # 【功能验证】 不涉及 # 【CheckList】 - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!46207 | 25 天前 | |
fix(test): skip float_status UTs on Ascend950 and clarify FORCE_OVERFLOW_CHECK doc SOC support Co-authored-by: wuyouqi1<wuyouqi1@h-partners.com> # message auto-generated for no-merge-commit merge: !46182 merge fix/force-overflow-check-a5-master into master fix(test): skip float_status UTs on Ascend950 and clarify FORCE_OVERFLOW_CHECK doc SOC support Created-by: wuyouqi1 Commit-by: wuyouqi1 Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > **如有社区issue，请关联issue链接**> **请勿携带内部流程信息（需求链接、问题单、内部issue等）** - [ ] 需求 - [ ] 问题单 - [x] issue/工单 https://gitcode.com/Ascend/pytorch/issues/4374 - [ ] 重构优化 - [ ] 资料更新 # 【修改方案】 测试发现 <term>Ascend 950DT</term> 上 npu_get_float_status / npu_alloc_float_status / npu_clear_float_status 算子不支持（op-plugin 文档产品支持表未包含 950），需调整 MR !44962 引入的 UT 与文档： 1. test/npu/test_check_over_flow.py：新增 FLOAT_STATUS_DEVICES（Ascend910B/910C/910_93，float_status 算子文档支持范围与 CI 机器池的交集）；test_check_over_flow / test_float_status_detection / test_npu_check_overflow_register_path 三个用例统一使用 @SupportedDevices(FLOAT_STATUS_DEVICES) 过滤，Ascend950 上跳过（寄存器检测路径依赖的 float_status 算子不支持）；环境变量负向用例（子进程，不触算子）保持 NON_SATURATION_DEVICES 不变。 2. docs/zh/api/environment_variable/op_execution/FORCE_OVERFLOW_CHECK.md：将"值为1"条目精简为开关语义，接口可用性说明独立成段；示例标注为 <term>Atlas A2 训练系列产品</term>/<term>Atlas A3 训练系列产品</term> 上的示例；NOTICE 块（移至示例后）说明 <term>Ascend 950DT</term> 不支持使用 get_npu_overflow_flag 等溢出检测接口、开启该开关后可通过 plog 中 aclrtSetStreamOverflowSwitch 相关日志（ASCEND_GLOBAL_LOG_LEVEL=1）确认开关已生效；删除"针对 Atlas 训练/推理系列及 Atlas 200I/500 A2 仅支持饱和模式、该环境变量不生效"的冗余说明；"支持的型号"表保留 <term>Ascend 950DT</term>（环境变量本身在 950DT 上生效）。 # 【资料变更】 docs/zh/api/environment_variable/op_execution/FORCE_OVERFLOW_CHECK.md（随本 MR 一并修改，见修改方案第 2 点）。 # 【接口变更】 无。 # 【功能验证】 - Ascend910B2 + CANN 9.2.0：python test/npu/test_check_over_flow.py -v 6/6 通过，确认非 950 设备覆盖不受影响； - Ascend950：三个依赖 float_status 算子的用例按 FLOAT_STATUS_DEVICES 过滤跳过，环境变量负向用例（子进程，不触算子）正常执行； - plog 验证（CANN 9.2.0）：ASCEND_GLOBAL_LOG_LEVEL=1 时可观察到 aclrtSetStreamOverflowSwitchImpl: successfully execute rtSetStreamOverflowSwitch, flag is 1 INFO 日志，确认文档中开关状态确认方式有效。 See merge request: Ascend/pytorch!46182 | 20 天前 | |
【docs】整合环境变量文档更新并重构分类导航 Co-authored-by: Xinrui Chen<chenxinrui11@huawei.com> # message auto-generated for no-merge-commit merge: !46030 merge codex/integrate-env-docs-master into master 【docs】整合环境变量文档更新并重构分类导航 Created-by: chenrayray Commit-by: Xinrui Chen Merged-by: ascend-robot Description: # 【合入来源】 - [x] issue/工单 - [x] 重构优化 - [x] 资料更新 关联Issue：https://gitcode.com/Ascend/pytorch/issues/4691 整合来源：[PR #45521](https://gitcode.com/Ascend/pytorch/pull/45521)、[PR #45307](https://gitcode.com/Ascend/pytorch/pull/45307)、[PR #45973](https://gitcode.com/Ascend/pytorch/pull/45973)及环境变量梳理结果。 # 【修改方案】 补齐分散的环境变量文档及导航入口，使100项环境变量能在总列表、总目录和分类目录中一致检索。 1. 在master基线上三方整合两个PR，纳入Inductor、分布式通信、启动和对称内存配置，保留master较新的说明，按#45521移除MFusion、AKG旧详情页。 2. 新增PYTORCH_HAL_BASED_NPU_CHECK和PYTORCH_ALLOC_CONF独立详情；补充溢出检测的版本不足告警行为，保留来源中的HAL失败回退Runtime及分配器配置互斥约束。 3. 导航按使用场景整理为设备初始化与管理、算子执行与兼容性、单算子编译与缓存、内存管理、分布式启动与建链、分布式通信与诊断、日志与告警、特征值检测、性能优化与采集、图编译共10类。 4. 分布式通信细分为通信执行与同步、超时监控与故障记录、状态与性能采集、DDP与RPC四组；图编译细分为编译模式与回退、缓存与编译并发、算子融合与自动调优、图优化与调度、调试日志与精度检查五组。 5. 将60个详情页的PyTorch对照说明融入功能描述，存在实际差异时通过提示块突出默认值或实现差异；新增统一的PyTorch环境变量对照表，按同名变量、异名或相关变量、配置项对照三组集中展示38项已有对照说明，并接入总目录和变量列表。 6. 补入PR #45973的HAL检测细节：解析ASCEND_RT_VISIBLE_DEVICES、动态加载libascend_hal.so，以及Runtime首次非零设备数缓存行为。该变量详情页、总列表和两级目录入口已包含，保留上游对应关系说明。 分类设计： TORCH_LOGS归入“日志与告警”，详情文件位于alarm_message_printing/TORCH_LOGS.md，与分类对应；图编译分类仅保留交叉引用。“特征值检测”保留标准名称及原有NPU_ASD变量范围，Inf/NaN模式和FORCE_OVERFLOW_CHECK归入算子执行与兼容性。每项变量只有一个主分类，领域专用的诊断配置保留在通信或图编译分类。TORCH_LOGS详情页移至日志目录，并同步总列表、总目录、分类目录和对照表链接；旧同步超时目录保留兼容入口。PYTORCH_ALLOC_CONF链接到原分配器参数页，避免维护两份参数说明。 事实内容以三个来源PR和环境变量梳理表为准，保留master已有的较新说明，统一分类、导航及上游对比的展示方式。 # 【资料变更】 按环境变量梳理：文档新增收录54项、更新已有7项、移除旧项2项，整合后共收录100项。各变量的用途和本次修改内容如下。 ## 新增收录的环境变量（54项） ### 分布式通信与诊断（19项） | 环境变量 | 用途 | | --- | --- | | [DDP_SET_LAST_BUCKET_CAP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/DDP_SET_LAST_BUCKET_CAP.md) | 通过此环境变量可控制DDP的bucket重建顺序。 | | [NSLB_CP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_CP.md) | 通过此环境变量可配置HCCL NSLB采样记录的目录路径。 | | [NSLB_MAX_RECORD_NUM](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_MAX_RECORD_NUM.md) | 通过此环境变量可配置每个PG的最大NSLB采样记录数量。 | | [PERF_DUMP_CONFIG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_CONFIG.md) | 通过此环境变量可配置HCCL操作的性能数据记录功能。 | | [PERF_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_PATH.md) | 通过此环境变量可配置HCCL性能dump文件的输出目录。 | | [TORCH_HCCL_COORD_CHECK_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_COORD_CHECK_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置WatchDog轮询检查Store dump signal的间隔时间。 | | [TORCH_HCCL_DEBUG_INFO_PIPE_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_PIPE_FILE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置命名管道文件，用于外部触发Flight Recorder dump。 | | [TORCH_HCCL_DEBUG_INFO_TEMP_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_TEMP_FILE.md) | 通过此环境变量可配置HCCL dump文件的名称前缀。 | | [TORCH_HCCL_DUMP_ON_TIMEOUT](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DUMP_ON_TIMEOUT.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制超时或错误时是否自动触发Flight Recorder dump。 | | [TORCH_HCCL_ENABLE_MONITORING](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_ENABLE_MONITORING.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否启动heartbeat monitor线程。 | | [TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置heartbeat monitor判定WatchDog卡死的超时时间。 | | [TORCH_HCCL_HIGH_PRIORITY](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HIGH_PRIORITY.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否强制使用高优先级NPU stream。 | | [TORCH_HCCL_STATUS_SAVE_ENABLE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_ENABLE.md) | 通过此环境变量可控制HCCL进程组状态信息的周期性保存。 | | [TORCH_HCCL_STATUS_SAVE_INTERVAL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_INTERVAL.md) | 通过此环境变量可配置HCCL状态保存的间隔时间。 | | [TORCH_HCCL_STATUS_SAVE_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_PATH.md) | 通过此环境变量可配置HCCL状态文件的保存目录。 | | [TORCH_HCCL_TRACE_BUFFER_SIZE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_BUFFER_SIZE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置Flight Recorder环形缓冲区最大事件数，默认关闭。 | | [TORCH_HCCL_TRACE_CPP_STACK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_CPP_STACK.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制在记录事件时是否采集C++调用栈。 | | [TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置monitor等待异步dump完成的最大时间。 | | [TP_SOCKET_IFNAME](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TP_SOCKET_IFNAME.md) | 通过此环境变量可指定TensorPipe RPC传输层使用的网络接口名称。 | ### 设备初始化与管理（1项） | 环境变量 | 用途 | | --- | --- | | [PYTORCH_HAL_BASED_NPU_CHECK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/device_management/PYTORCH_HAL_BASED_NPU_CHECK.md) | 选择NPU可用性检测路径，配置为1时优先通过Ascend HAL查询设备数量，失败时回退到Runtime。 | ### 分布式启动与建链（4项） | 环境变量 | 用途 | | --- | --- | | [ENABLE_TIERED_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/ENABLE_TIERED_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制ParallelStore是否启用分层建链优化模式。 | | [PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH.md) | 通过此环境变量可将agent PID传递给ParallelStore，用于本地socket路径生成。 | | [TORCH_NPU_ELASTIC_USE_AGENT_STORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_ELASTIC_USE_AGENT_STORE.md) | 通过此环境变量可控制是否使用agent已启动的ParallelStore。 | | [TORCH_NPU_USE_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_USE_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制是否启用ParallelStore作为分布式存储后端，提升建链性能。 | ### 日志与告警（1项） | 环境变量 | 用途 | | --- | --- | | [TORCH_LOGS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/alarm_message_printing/TORCH_LOGS.md) | 通过此环境变量可控制PyTorch各模块的日志输出级别，与PyTorch上游行为一致。 | ### 图编译（27项） | 环境变量 | 用途 | | --- | --- | | [CATLASS_EPILOGUE_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/CATLASS_EPILOGUE_FUSION.md) | 通过此环境变量可控制是否开启Catlass epilogue融合功能，与PyTorch上游的CUTLASS_EPILOGUE_FUSION对应。 | | [ENABLE_INPLACE_BUFFERS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_INPLACE_BUFFERS.md) | 通过此环境变量可控制是否启用原地缓冲区优化。 | | [ENABLE_PARALLEL_SCHEDULER](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_PARALLEL_SCHEDULER.md) | 通过此环境变量可控制是否启用并行调度器FX pass。 | | [FX_SUBGRAPH_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/FX_SUBGRAPH_DUMP_PATH.md) | 通过此环境变量可配置DVM模式下FX子图的dump路径。 | | [INDUCTOR_ASCEND_DEBUG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DEBUG.md) | 通过此环境变量可控制Triton编译时是否启用调试模式。 | | [INDUCTOR_ASCEND_DUMP_FX_GRAPH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DUMP_FX_GRAPH.md) | 通过此环境变量可控制在Inductor降层时是否导出FX图。 | | [INDUCTOR_ASCEND_FX_GRAPH_CACHE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_FX_GRAPH_CACHE.md) | 通过此环境变量可配置Inductor降层时FX图缓存的目录路径。 | | [INDUCTOR_ASCEND_LOG_LEVEL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_LOG_LEVEL.md) | 通过此环境变量可配置Inductor模块的日志级别。 | | [INDUCTOR_DVM_ENABLE_MATMUL_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_DVM_ENABLE_MATMUL_FUSION.md) | 通过此环境变量可开启DVM MatMul template融合，将矩阵乘算子融合为DVM template kernel。 | | [NPU_INDUCTOR_DYNAMIC_FX_PASS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/NPU_INDUCTOR_DYNAMIC_FX_PASS.md) | 通过此环境变量可控制图优化FX pass是否使用动态shape模式。 | | [PARALLEL_SCHEDULER_NODES_MIN](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/in See merge request: Ascend/pytorch!46030 | 27 天前 | |
【docs】整合环境变量文档更新并重构分类导航 Co-authored-by: Xinrui Chen<chenxinrui11@huawei.com> # message auto-generated for no-merge-commit merge: !46030 merge codex/integrate-env-docs-master into master 【docs】整合环境变量文档更新并重构分类导航 Created-by: chenrayray Commit-by: Xinrui Chen Merged-by: ascend-robot Description: # 【合入来源】 - [x] issue/工单 - [x] 重构优化 - [x] 资料更新 关联Issue：https://gitcode.com/Ascend/pytorch/issues/4691 整合来源：[PR #45521](https://gitcode.com/Ascend/pytorch/pull/45521)、[PR #45307](https://gitcode.com/Ascend/pytorch/pull/45307)、[PR #45973](https://gitcode.com/Ascend/pytorch/pull/45973)及环境变量梳理结果。 # 【修改方案】 补齐分散的环境变量文档及导航入口，使100项环境变量能在总列表、总目录和分类目录中一致检索。 1. 在master基线上三方整合两个PR，纳入Inductor、分布式通信、启动和对称内存配置，保留master较新的说明，按#45521移除MFusion、AKG旧详情页。 2. 新增PYTORCH_HAL_BASED_NPU_CHECK和PYTORCH_ALLOC_CONF独立详情；补充溢出检测的版本不足告警行为，保留来源中的HAL失败回退Runtime及分配器配置互斥约束。 3. 导航按使用场景整理为设备初始化与管理、算子执行与兼容性、单算子编译与缓存、内存管理、分布式启动与建链、分布式通信与诊断、日志与告警、特征值检测、性能优化与采集、图编译共10类。 4. 分布式通信细分为通信执行与同步、超时监控与故障记录、状态与性能采集、DDP与RPC四组；图编译细分为编译模式与回退、缓存与编译并发、算子融合与自动调优、图优化与调度、调试日志与精度检查五组。 5. 将60个详情页的PyTorch对照说明融入功能描述，存在实际差异时通过提示块突出默认值或实现差异；新增统一的PyTorch环境变量对照表，按同名变量、异名或相关变量、配置项对照三组集中展示38项已有对照说明，并接入总目录和变量列表。 6. 补入PR #45973的HAL检测细节：解析ASCEND_RT_VISIBLE_DEVICES、动态加载libascend_hal.so，以及Runtime首次非零设备数缓存行为。该变量详情页、总列表和两级目录入口已包含，保留上游对应关系说明。 分类设计： TORCH_LOGS归入“日志与告警”，详情文件位于alarm_message_printing/TORCH_LOGS.md，与分类对应；图编译分类仅保留交叉引用。“特征值检测”保留标准名称及原有NPU_ASD变量范围，Inf/NaN模式和FORCE_OVERFLOW_CHECK归入算子执行与兼容性。每项变量只有一个主分类，领域专用的诊断配置保留在通信或图编译分类。TORCH_LOGS详情页移至日志目录，并同步总列表、总目录、分类目录和对照表链接；旧同步超时目录保留兼容入口。PYTORCH_ALLOC_CONF链接到原分配器参数页，避免维护两份参数说明。 事实内容以三个来源PR和环境变量梳理表为准，保留master已有的较新说明，统一分类、导航及上游对比的展示方式。 # 【资料变更】 按环境变量梳理：文档新增收录54项、更新已有7项、移除旧项2项，整合后共收录100项。各变量的用途和本次修改内容如下。 ## 新增收录的环境变量（54项） ### 分布式通信与诊断（19项） | 环境变量 | 用途 | | --- | --- | | [DDP_SET_LAST_BUCKET_CAP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/DDP_SET_LAST_BUCKET_CAP.md) | 通过此环境变量可控制DDP的bucket重建顺序。 | | [NSLB_CP](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_CP.md) | 通过此环境变量可配置HCCL NSLB采样记录的目录路径。 | | [NSLB_MAX_RECORD_NUM](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/NSLB_MAX_RECORD_NUM.md) | 通过此环境变量可配置每个PG的最大NSLB采样记录数量。 | | [PERF_DUMP_CONFIG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_CONFIG.md) | 通过此环境变量可配置HCCL操作的性能数据记录功能。 | | [PERF_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/PERF_DUMP_PATH.md) | 通过此环境变量可配置HCCL性能dump文件的输出目录。 | | [TORCH_HCCL_COORD_CHECK_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_COORD_CHECK_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置WatchDog轮询检查Store dump signal的间隔时间。 | | [TORCH_HCCL_DEBUG_INFO_PIPE_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_PIPE_FILE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置命名管道文件，用于外部触发Flight Recorder dump。 | | [TORCH_HCCL_DEBUG_INFO_TEMP_FILE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DEBUG_INFO_TEMP_FILE.md) | 通过此环境变量可配置HCCL dump文件的名称前缀。 | | [TORCH_HCCL_DUMP_ON_TIMEOUT](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_DUMP_ON_TIMEOUT.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制超时或错误时是否自动触发Flight Recorder dump。 | | [TORCH_HCCL_ENABLE_MONITORING](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_ENABLE_MONITORING.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否启动heartbeat monitor线程。 | | [TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置heartbeat monitor判定WatchDog卡死的超时时间。 | | [TORCH_HCCL_HIGH_PRIORITY](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_HIGH_PRIORITY.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制是否强制使用高优先级NPU stream。 | | [TORCH_HCCL_STATUS_SAVE_ENABLE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_ENABLE.md) | 通过此环境变量可控制HCCL进程组状态信息的周期性保存。 | | [TORCH_HCCL_STATUS_SAVE_INTERVAL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_INTERVAL.md) | 通过此环境变量可配置HCCL状态保存的间隔时间。 | | [TORCH_HCCL_STATUS_SAVE_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_STATUS_SAVE_PATH.md) | 通过此环境变量可配置HCCL状态文件的保存目录。 | | [TORCH_HCCL_TRACE_BUFFER_SIZE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_BUFFER_SIZE.md) | 当使用HCCL作为通信后端时，通过此环境变量可配置Flight Recorder环形缓冲区最大事件数，默认关闭。 | | [TORCH_HCCL_TRACE_CPP_STACK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_TRACE_CPP_STACK.md) | 当使用HCCL作为通信后端时，通过此环境变量可控制在记录事件时是否采集C++调用栈。 | | [TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC.md) | 当使用HCCL作为通信后端时，通过此环境变量可设置monitor等待异步dump完成的最大时间。 | | [TP_SOCKET_IFNAME](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/collective_communication/TP_SOCKET_IFNAME.md) | 通过此环境变量可指定TensorPipe RPC传输层使用的网络接口名称。 | ### 设备初始化与管理（1项） | 环境变量 | 用途 | | --- | --- | | [PYTORCH_HAL_BASED_NPU_CHECK](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/device_management/PYTORCH_HAL_BASED_NPU_CHECK.md) | 选择NPU可用性检测路径，配置为1时优先通过Ascend HAL查询设备数量，失败时回退到Runtime。 | ### 分布式启动与建链（4项） | 环境变量 | 用途 | | --- | --- | | [ENABLE_TIERED_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/ENABLE_TIERED_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制ParallelStore是否启用分层建链优化模式。 | | [PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH.md) | 通过此环境变量可将agent PID传递给ParallelStore，用于本地socket路径生成。 | | [TORCH_NPU_ELASTIC_USE_AGENT_STORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_ELASTIC_USE_AGENT_STORE.md) | 通过此环境变量可控制是否使用agent已启动的ParallelStore。 | | [TORCH_NPU_USE_PARALLEL_TCPSTORE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/distributed_startup/TORCH_NPU_USE_PARALLEL_TCPSTORE.md) | 通过此环境变量可控制是否启用ParallelStore作为分布式存储后端，提升建链性能。 | ### 日志与告警（1项） | 环境变量 | 用途 | | --- | --- | | [TORCH_LOGS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/alarm_message_printing/TORCH_LOGS.md) | 通过此环境变量可控制PyTorch各模块的日志输出级别，与PyTorch上游行为一致。 | ### 图编译（27项） | 环境变量 | 用途 | | --- | --- | | [CATLASS_EPILOGUE_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/CATLASS_EPILOGUE_FUSION.md) | 通过此环境变量可控制是否开启Catlass epilogue融合功能，与PyTorch上游的CUTLASS_EPILOGUE_FUSION对应。 | | [ENABLE_INPLACE_BUFFERS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_INPLACE_BUFFERS.md) | 通过此环境变量可控制是否启用原地缓冲区优化。 | | [ENABLE_PARALLEL_SCHEDULER](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/ENABLE_PARALLEL_SCHEDULER.md) | 通过此环境变量可控制是否启用并行调度器FX pass。 | | [FX_SUBGRAPH_DUMP_PATH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/FX_SUBGRAPH_DUMP_PATH.md) | 通过此环境变量可配置DVM模式下FX子图的dump路径。 | | [INDUCTOR_ASCEND_DEBUG](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DEBUG.md) | 通过此环境变量可控制Triton编译时是否启用调试模式。 | | [INDUCTOR_ASCEND_DUMP_FX_GRAPH](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_DUMP_FX_GRAPH.md) | 通过此环境变量可控制在Inductor降层时是否导出FX图。 | | [INDUCTOR_ASCEND_FX_GRAPH_CACHE](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_FX_GRAPH_CACHE.md) | 通过此环境变量可配置Inductor降层时FX图缓存的目录路径。 | | [INDUCTOR_ASCEND_LOG_LEVEL](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_ASCEND_LOG_LEVEL.md) | 通过此环境变量可配置Inductor模块的日志级别。 | | [INDUCTOR_DVM_ENABLE_MATMUL_FUSION](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/INDUCTOR_DVM_ENABLE_MATMUL_FUSION.md) | 通过此环境变量可开启DVM MatMul template融合，将矩阵乘算子融合为DVM template kernel。 | | [NPU_INDUCTOR_DYNAMIC_FX_PASS](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/inductor/NPU_INDUCTOR_DYNAMIC_FX_PASS.md) | 通过此环境变量可控制图优化FX pass是否使用动态shape模式。 | | [PARALLEL_SCHEDULER_NODES_MIN](https://gitcode.com/chenrayray/pytorch/blob/codex/integrate-env-docs-master/docs/zh/api/environment_variable/in See merge request: Ascend/pytorch!46030 | 27 天前 | |
docs: Add_inductor_envs_master Co-authored-by: qiaoyaodan<qiaoyaodan@huawei.com> # message auto-generated for no-merge-commit merge: !46154 merge env_docs into master docs: Add_inductor_envs_master Created-by: qiaoyaodan888 Commit-by: qiaoyaodan Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > <font color="red">**如有社区issue，请关联issue链接**</font>\ > <font color="red">**请勿携带内部流程信息（需求链接、问题单、内部issue等）**</font> - [x] 需求 - [ ] 问题单 - [ ] issue/工单 - [ ] 重构优化 - [x] 资料更新 # 【修改方案】 1、添加下面5个环境变量的相关文档 INDUCTOR_ASCEND_AGGRESSIVE_AUTOTUNE INDUCTOR_ASCEND_SYMBOLIC_GROUP_AUTOTUNE INDUCTOR_ASCEND_SYMBOLIC_GROUP_TEMPLATES INDUCTOR_ASCEND_ENABLE_COSTMODEL INDUCTOR_ASCEND_COSTMODEL_RATIO 2、同步更新索引/导航文件（env_variable_list.md、_menu_environment_variable.md、_menu_inductor.md） 3、更新torch_npu/_inductor/docs/installation/installation.md中 PyTorch 版本支持说明（2.7.1 和 2.9.0） # 【资料变更】 > 请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及” # 【接口变更】 > 请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及，需要详细说明接口以及对应的变更内容，同时需要在资料中体现。如不涉及，需填写“不涉及” # 【功能验证】 > 说明测试场景，测试方法。如果本次测试方式与常规单元测试不同，请详细说明您的测试步骤\ > 新增/变更内容是否已新增/适配UT测试用例看护，并补充测试自验证截图 # 【CheckList】 > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!46154 | 22 天前 | |
docs: Add_inductor_envs_master Co-authored-by: qiaoyaodan<qiaoyaodan@huawei.com> # message auto-generated for no-merge-commit merge: !46154 merge env_docs into master docs: Add_inductor_envs_master Created-by: qiaoyaodan888 Commit-by: qiaoyaodan Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > <font color="red">**如有社区issue，请关联issue链接**</font>\ > <font color="red">**请勿携带内部流程信息（需求链接、问题单、内部issue等）**</font> - [x] 需求 - [ ] 问题单 - [ ] issue/工单 - [ ] 重构优化 - [x] 资料更新 # 【修改方案】 1、添加下面5个环境变量的相关文档 INDUCTOR_ASCEND_AGGRESSIVE_AUTOTUNE INDUCTOR_ASCEND_SYMBOLIC_GROUP_AUTOTUNE INDUCTOR_ASCEND_SYMBOLIC_GROUP_TEMPLATES INDUCTOR_ASCEND_ENABLE_COSTMODEL INDUCTOR_ASCEND_COSTMODEL_RATIO 2、同步更新索引/导航文件（env_variable_list.md、_menu_environment_variable.md、_menu_inductor.md） 3、更新torch_npu/_inductor/docs/installation/installation.md中 PyTorch 版本支持说明（2.7.1 和 2.9.0） # 【资料变更】 > 请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及” # 【接口变更】 > 请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及，需要详细说明接口以及对应的变更内容，同时需要在资料中体现。如不涉及，需填写“不涉及” # 【功能验证】 > 说明测试场景，测试方法。如果本次测试方式与常规单元测试不同，请详细说明您的测试步骤\ > 新增/变更内容是否已新增/适配UT测试用例看护，并补充测试自验证截图 # 【CheckList】 > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!46154 | 22 天前 | |
update inductor docs Co-authored-by: AACAES<liuyan7892@163.com> # message auto-generated for no-merge-commit merge: !46147 merge doc/env-vars-inductor into master update inductor docs Created-by: AACAES Commit-by: AACAES Merged-by: ascend-robot Description: <!-- PR描述模板更新日期：20260203 --> # 【合入来源】 > <font color="red">**如有社区issue，请关联issue链接**</font>\ > <font color="red">**请勿携带内部流程信息（需求链接、问题单、内部issue等）**</font> https://gitcode.com/Ascend/pytorch/issues/4435 - [ ] 需求 - [ ] 问题单 - [x] issue/工单 - [ ] 重构优化 - [ ] 资料更新 # 【修改方案】 > 请描述修改内容的具体实现，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列\ > 如果是需求或者重构类的PR，需要补充详细设计文档（说明上下游组件关系、时序图、类图、DFX能力等内容） 更新图模式资料 # 【资料变更】 > 请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及” 更新图模式资料 # 【接口变更】 > 请确认是否涉及跨代码仓或者客户面可见的接口变更。如涉及，需要详细说明接口以及对应的变更内容，同时需要在资料中体现。如不涉及，需填写“不涉及” 不涉及 # 【功能验证】 > 说明测试场景，测试方法。如果本次测试方式与常规单元测试不同，请详细说明您的测试步骤\ > 新增/变更内容是否已新增/适配UT测试用例看护，并补充测试自验证截图 不涉及 # 【CheckList】 > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] - [x] 代码注释完备，正确记录错误日志 - [x] 代码实现进行了返回值、空指针等校验 - [x] PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等 - [x] PR持续集成流水线（CI）执行通过，代码检查无异常 See merge request: Ascend/pytorch!46147 | 22 天前 |
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 21 天前 | ||
| 2 个月前 | ||
| 27 天前 | ||
| 27 天前 | ||
| 27 天前 | ||
| 21 天前 | ||
| 22 天前 | ||
| 27 天前 | ||
| 25 天前 | ||
| 20 天前 | ||
| 27 天前 | ||
| 27 天前 | ||
| 22 天前 | ||
| 22 天前 | ||
| 22 天前 |