合并受阻
变更摘要
这是一个纯文档类 PR(docs),为 torch_npu 分布式模块新增环境变量配置文档,共新增 24 个环境变量说明文档:集合通信(collective_communication/,19 个)、分布式启动(distributed_startup/,4 个,新目录)、内存管理(memory_management/,1 个),并同步更新环境变量总表 env_variable_list.md(新增 11 个分布式启动变量列表、增补表 3/4)及三个 _menu_*.md 菜单文件。文档按「本次新增 / 项目已有 / 由 CANN HCCL 库提供(指向 CANN 文档)/ 由 torchrun/elastic 注入(用户无需手动设置)」四类图例区分变量来源,且本 PR 不涉及接口变更。
主要改动
-
新增分布式启动环境变量文档(4 个,新目录
distributed_startup/):补充TORCH_NPU_USE_PARALLEL_TCPSTORE、TORCH_NPU_ELASTIC_USE_AGENT_STORE、ENABLE_TIERED_PARALLEL_TCPSTORE、PROXY_AGENT_PID_USE_LOCAL_SOCKET_PATH的说明与默认值,覆盖并行/分层 TCP Store 及 agent PID 本地 socket 路径等启动配置。 -
新增集合通信环境变量文档(19 个,
collective_communication/):覆盖 watchdog 与错误处理(TORCH_HCCL_HIGH_PRIORITY、TORCH_HCCL_ENABLE_MONITORING、TORCH_HCCL_HEARTBEAT_TIMEOUT_SEC、TORCH_HCCL_COORD_CHECK_MILSEC)、Flight Recorder 与 dump(TORCH_HCCL_TRACE_BUFFER_SIZE、TORCH_HCCL_TRACE_CPP_STACK、TORCH_HCCL_DUMP_ON_TIMEOUT、TORCH_HCCL_WAIT_TIMEOUT_DUMP_MILSEC、TORCH_HCCL_DEBUG_INFO_PIPE_FILE、TORCH_HCCL_DEBUG_INFO_TEMP_FILE)、状态保存与 NSLB/性能采样(TORCH_HCCL_STATUS_SAVE_ENABLE/TORCH_HCCL_STATUS_SAVE_PATH/TORCH_HCCL_STATUS_SAVE_INTERVAL、NSLB_CP、NSLB_MAX_RECORD_NUM、PERF_DUMP_CONFIG、PERF_DUMP_PATH)以及 RPC/DTensor/DDP 配置(TP_SOCKET_IFNAME、DDP_SET_LAST_BUCKET_CAP)等变量说明。 -
新增内存管理环境变量文档(1 个):补充对称内存堆大小变量
NPU_SHMEM_SYMMETRIC_SIZE(默认 1 GiB)的说明。 -
同步更新索引与菜单文件:更新
env_variable_list.md环境变量总表(新增 11 个分布式启动变量列表、增补表 3/4),并同步三个_menu_*.md菜单文件,保证文档入口与新增页面导航一致。


🤖 本次改动均为数据 / 生成 / 二进制文件(如测试用例、锁文件、媒体资源),没有可审查的代码逻辑,已跳过 AI 代码审查。


Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
PR Approval Progress
⚠️ This PR does not yet meet the following requirements:lgtm (requires ≥ 2 person(s) per module)、approve (requires ≥ 1 person(s) per module)
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| **/*.md | ❌ (0/2)(You can also ask: kisnwang, zyw-hw, liangsongwei, LQ1206, lyx324521) | ❌ (0/1)(You can also ask: wjlflyer, li_jing_hw, 楚浩田, zyw-hw, huangjingwei) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
ccyyccyyccyycc, thanks for your pull request. All authors of the commits have signed the CLA. 👍


Linking Issue Notice
@ccyyccyyccyycc , the pull request must be linked to at least one issue.
If an issue has already been linked, but the needs-issue label remains, you can remove the label by commenting /check-issue .


当前仓库存在以下 保护分支 :
| Protected Branch | Version | Release |
|---|---|---|
| master | ||
| v2.7.1 | ||
| v2.9.0 | ||
| v2.10.0 | ||
| v2.11.0 | ||
| v2.12.0 | ||
| v2.11.0-26.1.0 | ||
| v2.12.0-26.1.0 | ||
| v2.10.0-26.1.0 | ||
| v2.9.0-26.1.0 | ||
| v2.7.1-26.1.0 | ||
| ci-test |
评论 /sync <branch1> <branch2> ... 可将当前 PR 修改同步到其它分支(创建同步 PR):
a) 如果当前 PR 是 Open 状态,同步操作将延迟到 PR 被合并时执行
b) 如果当前 PR 已经 Merged,将立即执行同步操作
注意:
- /sync 命令可以指定同步到多个分支,仅最后一个 /sync 命令生效
- 如果创建的同步 PR 不正确,可通过向同步 PR 的源分支提交轻量级 PR 完善,或使用 /close 命令关闭


| 阶段 | 任务名 | 状态 | 详情 |
|---|---|---|---|
| 编译构建 | Build_X86 | 🛑 | >>> |
| Build_ARM | 🛑 | >>> | |
| Build_X86_torchair | 🛑 | >>> | |
| Build_ARM_torchair | 🛑 | >>> | |
| patch_test | 🛑 | >>> | |
| Build_X86_213 | 🛑 | >>> | |
| Build_ARM_213 | 🛑 | >>> | |
| 恶意代码检查 | Antipoison | ✅ | >>> |
| 编码安全与规范检查 | codecheck_pre-commit | ✅ | >>> |
| check_error | ✅ | >>> | |
| lintrunner | ✅ | >>> | |
| 开源片段检查 | SCA | ✅ | >>> |
| 开发者测试 | UT_ARM_A3_Part_01 | 🛑 | >>> |
| UT_ARM_A3_Part_02 | 🛑 | >>> | |
| UT_ARM_A2_Part_01 | 🛑 | >>> | |
| UT_ARM_A2_Part_02 | 🛑 | >>> | |
| UT_ARM_A2_Part_03 | 🛑 | >>> | |
| UT_inductor_Part_01 | 🛑 | >>> | |
| UT_inductor_Part_02 | 🛑 | >>> | |
| UT_inductor_Part_03 | 🛑 | >>> | |
| UT_inductor_Part_04 | 🛑 | >>> | |
| UT_DIST_ARM_Part_01 | 🛑 | >>> | |
| UT_DIST_ARM_Part_02 | 🛑 | >>> | |
| UT_DIST_ARM_Part_03 | 🛑 | >>> | |
| UT_DIST_ARM_Part_04 | 🛑 | >>> | |
| UT_ARM_A2_Select_Part_01 | 🛑 | >>> | |
| UT_ARM_A2_Select_Part_02 | 🛑 | >>> | |
| UT_ARM_A2_Part_01_213 | 🛑 | >>> | |
| UT_ARM_A2_Part_02_213 | 🛑 | >>> | |
| UT_ARM_A2_Part_03_213 | 🛑 | >>> | |
| UT_inductor_Part_01_213 | 🛑 | >>> | |
| UT_inductor_Part_02_213 | 🛑 | >>> | |
| UT_inductor_Part_03_213 | 🛑 | >>> | |
| UT_inductor_Part_04_213 | 🛑 | >>> | |
| UT_DIST_ARM_Part_01_213 | 🛑 | >>> | |
| UT_DIST_ARM_Part_02_213 | 🛑 | >>> | |
| UT_DIST_ARM_Part_03_213 | 🛑 | >>> | |
| UT_DIST_ARM_Part_04_213 | 🛑 | >>> | |
| UT_ARM_A2_Select_Part_01_213 | 🛑 | >>> | |
| UT_ARM_A2_Select_Part_02_213 | 🛑 | >>> | |
| 流水线 | PR-pipeline_pytorch | ✅ | >>> |
- compile、compile_inductor、compile_torchair : 运行流水线
- retry : 重试流水线所有失败子任务
- retry <任务名> : 仅重试指定失败子任务
- stop : 停止流水线


ascend docs pipeline is running...


✅ 跳过 docs ci 检查,没有需要检查的文档文件


【合入来源】
【修改方案】
不涉及
【资料变更】
分布式环境变量配置全景
1. 启动、rank 与 rendezvous
2. ProcessGroupHCCL 等待、watchdog 与错误处理
3. Flight Recorder 与 dump
4. HCCL 超时、算法与 communicator 配置
5. stream、allocator 与对称内存
6. 诊断、采样与静默检测(PTA 特有)
7. 其他:RPC、DTensor与DDP overlay
变更范围小结
collective_communication/19 个、distributed_startup/4 个(新目录)、memory_management/1 个。env_variable_list.md(新表 11 分布式启动 + 表 3/4 增补)、三个_menu_*.md菜单文件。【接口变更】
不涉及
【功能验证】
不涉及
【CheckList】