已关闭
[Documentation|文档反馈]: 【2026 HCCL通信库创新大赛-华北赛区】【加利】通信域建链故障定位文档存在“仅需可以”语法冗余 #418
m0_73862320创建于 27 天前关闭于 10 天前
27 天前 修改了issue 的描述
27 天前 修改了issue 的描述
27 天前 修改标题为 “[Documentation|文档反馈]【2026 HCCL通信库创新大赛-华北赛区】【加利】: 通信域建链故障定位文档存在“仅需可以”语法冗余”,原标题为“【2026 HCCL通信库创新大赛-华北赛区】【加利】[Documentation|文档反馈]: 通信域建链故障定位文档存在“仅需可以”语法冗余”
27 天前 修改标题为 “[Documentation|文档反馈]【2026 HCCL通信库创新大赛-华北赛区】【加利】: 通信域建链故障定位文档存在“仅需可以”语法冗余”,原标题为“【2026 HCCL通信库创新大赛-华北赛区】【加利】[Documentation|文档反馈]: 通信域建链故障定位文档存在“仅需可以”语法冗余”
27 天前 修改标题为 “[Documentation|文档反馈]: 【2026 HCCL通信库创新大赛-华北赛区】【加利】通信域建链故障定位文档存在“仅需可以”语法冗余”,原标题为“[Documentation|文档反馈]【2026 HCCL通信库创新大赛-华北赛区】【加利】: 通信域建链故障定位文档存在“仅需可以”语法冗余”
27 天前 修改标题为 “[Documentation|文档反馈]: 【2026 HCCL通信库创新大赛-华北赛区】【加利】通信域建链故障定位文档存在“仅需可以”语法冗余”,原标题为“[Documentation|文档反馈]【2026 HCCL通信库创新大赛-华北赛区】【加利】: 通信域建链故障定位文档存在“仅需可以”语法冗余”
Leewis
27 天前 评论:
27 天前 评论:
感谢对于社区的关注与反馈,当前反馈的问题已收到,欢迎提交pr解决该问题;提交pr前需要签署CLA协议;提交pr后需要线上编译;详情请参见 https://gitcode.com/cann/hccl/wiki/2026 HCCL通信库创新大赛 Issue%2F2026 HCCL通信库创新大赛.md


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。