变更摘要

这是一个文档更新 PR，主要针对 Docker 部署说明进行补充。改动范围为 2 个文件，新增 2 行、删除 1 行。根据 PR 描述，此次更新新增了单机多容器部署说明以及 MPI 相关说明，旨在帮助用户更好地理解在多容器环境下以及使用 MPI 进行分布式运行的配置方式。

主要改动

• 新增单机多容器部署说明：在 Docker 相关文档中补充了单机环境下运行多个容器的配置指引。
• 新增 MPI 说明：增加了与 MPI（消息传递接口）相关的使用说明，以便用户在使用 MPI 进行分布式计算时参考。

代码审查

我已经仔细审查了两个变更文件的完整上下文。以下是我的分析：

文件 1: docs/zh/user_guide/constraints.md

变更内容： 在第 8 行新增了一条约束建议：单机多容器场景下建议所有容器配置相同的 IP 地址。

分析： 该文档是 HCCL（昇腾集合通信库）的系统约束与限制说明。这条建议处于"公共约束"章节，上下文是 HCCL 通信场景。在 HCCL 单机多容器部署中（例如使用 --network=host 模式时，所有容器共享宿主机网络栈），确保 HCCL 通信接口 IP 一致是为了让性能对比测试结果与裸机环境可比。这里的"IP 地址"指的是 HCCL 通信所使用的网络接口 IP（可通过 HCCL_IF_IP 等环境变量配置），而非一般意义上的容器独立 IP。该建议措辞在 HCCL 专业上下文中是合理的，不会导致安全性问题或生产环境误用。

文件 2: examples/05_custom_ops_allgather/README.md

变更内容： 在第 57 行将 MPI 环境说明从简单的一句话扩展为附带文档链接的完整说明，引导用户参考昇腾文档中心的 HCCL 性能测试工具使用指南中的 MPI 安装章节。

分析：

• 链接使用 HTTPS (https://hiascend.com/...)，指向华为昇腾官方文档中心，域名合法可信。
• 链接未引入不安全的命令或配置（如 chmod 777、禁用 TLS、暴露 0.0.0.0 等）。
• 内容为指导性文档链接，不涉及跳过测试、隐藏失败或误导用户的行为。
• URL 中 hiascend.com 与文件中第 47 行已有的 www.hiascend.com 存在微小不一致，但两者均指向同一官方站点，属于纯格式差异，不属于可报告问题。

审查结论

两个变更文件均为纯文档更新，未引入正确性、安全性、可靠性或破坏性变更问题。

整体风险判断： 无风险。本次变更是文档层面的补充说明，内容合理，无安全隐患，可以合并。

⚠️ 已识别出整体风险，但无法提取行内评论，请参考整体评估。

CLA Signature Pass

Leewis, thanks for your pull request. All authors of the commits have signed the CLA. 👍

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

PR Approval Progress

✅ Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

💡 Tip:

• Committer can comment /approve or /lgtm
• Commenting /approve implies both code review (lgtm) and intent to merge (approve)

/compile

流水线任务触发成功
任务链接 [69b94b1c009f486e9bb2dd4029dad61f][流水线指导]

[2026-07-16 10:02:53]    CI执行结束

/approve

/lgtm