已关闭
[Documentation|文档反馈]: 【2026 HCCL通信库创新大赛-华北赛区】【加利】通信域建链故障定位文档存在“仅需可以”语法冗余 #418
m0_73862320创建于  27 天前关闭于  10 天前
m0_73862320
m0_73862320
27 天前 创建

Thanks for sending an issue! Please fill in the following template to help quickly solve your problem.

Document Link(文档链接)

https://gitcode.com/cann/hccl/blob/master/docs/zh/user_guide/fault_diagnosis/cluster_info_nego.md

Issues Section(问题文档片段)

docs/zh/user_guide/fault_diagnosis/cluster_info_nego.md:199 的“定位思路”段落当前写作:

从该典型场景可以看出,当集群发生通信域创建建链超时时,无论是server节点还是已成功连接的节点,都可以从报错日志中快速确认未连接的rank,也就是报错的根节点,此时仅需可以重点排查未连接rank的失败原因即可,如常见的连接超时原因为未配置HCCL_SOCKET_IFNAME环境变量导致使用未连通的Host网卡。

其中存在以下表述:

此时仅需可以重点排查未连接rank的失败原因即可

Existing Issues(存在的问题)

“仅需”和“可以”在该句中语义叠加,形成“仅需可以”的语法冗余,导致故障定位建议读起来不通顺,也不符合技术文档准确、简洁的表达要求。

建议删除冗余的“可以”,将原文修改为:

此时仅需重点排查未连接rank的失败原因即可

修改后完整句子为:

从该典型场景可以看出,当集群发生通信域创建建链超时时,无论是server节点还是已成功连接的节点,都可以从报错日志中快速确认未连接的rank,也就是报错的根节点,此时仅需重点排查未连接rank的失败原因即可,如常见的连接超时原因为未配置HCCL_SOCKET_IFNAME环境变量导致使用未连通的Host网卡。

本次修改仅删除一个冗余词语,不改变故障定位流程、环境变量链接、文档结构或产品行为。

已于2026-07-24实时检索cann/hccl当前公开Issue和PR,查重关键词包括仅需可以cluster_info_nego未连接rank重点排查,未发现同题Issue或PR。

likedislike
m0_73862320m0_73862320
27 天前 修改了issue 的描述
m0_73862320m0_73862320
27 天前 修改了issue 的描述
m0_73862320m0_73862320
27 天前 修改标题为 “[Documentation|文档反馈]【2026 HCCL通信库创新大赛-华北赛区】【加利】: 通信域建链故障定位文档存在“仅需可以”语法冗余”,原标题为“【2026 HCCL通信库创新大赛-华北赛区】【加利】[Documentation|文档反馈]: 通信域建链故障定位文档存在“仅需可以”语法冗余”
m0_73862320m0_73862320
27 天前 修改标题为 “[Documentation|文档反馈]: 【2026 HCCL通信库创新大赛-华北赛区】【加利】通信域建链故障定位文档存在“仅需可以”语法冗余”,原标题为“[Documentation|文档反馈]【2026 HCCL通信库创新大赛-华北赛区】【加利】: 通信域建链故障定位文档存在“仅需可以”语法冗余”
Leewis成员
27 天前 评论:

感谢对于社区的关注与反馈,当前反馈的问题已收到,欢迎提交pr解决该问题;提交pr前需要签署CLA协议;提交pr后需要线上编译;详情请参见 https://gitcode.com/cann/hccl/wiki/2026 HCCL通信库创新大赛 Issue%2F2026 HCCL通信库创新大赛.md

likedislike
LLeewis成员
27 天前 将 m0_73862320 设为负责人
LLeewis成员
27 天前 添加了label:Accepted
LLeewis成员
26 天前 关联了看板:HCCL
LLeewis成员
10 天前 issue状态由 进行中 改变为 已完成
LLeewis成员
10 天前 关闭了 issue