已开启
【docs】补齐环境变量文档并优化分类与导航一致性 #4691
chenrayray创建于  12 天前
chenrayray
chenrayray成员
12 天前 创建

问题描述

master环境变量文档的新增和修改内容分散在PR #45521、PR #45307及环境变量梳理结果中,尚需统一整合。部分变量缺少独立详情入口,总列表、总目录和分类目录存在未同步的情况。

同时,原有“集合通信”“图模式”列表在补充变量后较长,日志、数值模式、设备初始化和同步超时的分类边界也需要明确。

预期修改

  1. 整合两个PR的环境变量文档修改,保留master已有的较新说明,处理旧项删除与新增列表的冲突。
  2. 为PYTORCH_HAL_BASED_NPU_CHECK、PYTORCH_ALLOC_CONF补充独立入口,核对FORCE_OVERFLOW_CHECK及TORCH_NPU_FALLBACK_CPU_DISABLE的已有说明。
  3. 按使用场景整理为10个主分类,对分布式通信和图编译增加二级分组;将TORCH_LOGS详情页移至日志与告警目录,同步全部导航入口。“特征值检测”保留标准名称及原有NPU_ASD变量范围,Inf/NaN模式和FORCE_OVERFLOW_CHECK归入算子执行与兼容性。
  4. 事实内容以来源PR和环境变量梳理表为准,整合HAL检测等补充内容,统一上游对比的展示方式。

验收标准

  • 100项环境变量详情与总列表、总目录、分类目录对应,无遗漏或重复。
  • 本地链接有效,无合并冲突标记,Markdown差异格式检查通过。
  • 本次仅修改环境变量文档,不涉及运行时接口及代码行为变更。

相关PR

likedislike
TorchNPU-BotTorchNPU-Bot成员
12 天前 添加了label:triage-review
TorchNPU-Bot
TorchNPU-Bot成员
12 天前 评论:

issue待分派,添加triage-review标签

likedislike
chenrayraychenrayray成员
12 天前 关联了pull request:【docs】整合环境变量文档更新并重构分类导航
TorchNPU-BotTorchNPU-Bot成员
12 天前 添加了label:bot-triaged;删除了label:triage-review
TorchNPU-Bot
TorchNPU-Bot成员
12 天前 评论:

检测到当前 issue 已关联 PR,自动添加标签:bot-triaged

likedislike
chenrayraychenrayray成员
12 天前 修改了issue 的描述
chenrayraychenrayray成员
11 天前 修改了issue 的描述
chenrayraychenrayray成员
10 天前 修改了issue 的描述
Yyucaopanmu成员
9 天前 关联了pull request:[docs] 更新并新增API模块相关环境变量文档
Yyucaopanmu成员
6 天前 关联了pull request:[docs] 删除重复的 TorchNPU 特有说明
Yyucaopanmu成员
3 天前 关联了pull request:[docs] 更新多个环境变量文档,移除重复的特有声明注释
ChrisChris成员
3 天前 关联了pull request:[fix] distributed env fix
ChrisChris成员
11 小时前 关联了pull request:[fix] distribute env docs fix
ChrisChris成员
11 小时前 关联了pull request:[fix] distribute env docs fix