From 2540738a142652c983bf671d4737337c38bd8602 Mon Sep 17 00:00:00 2001
From: Orange <2314753575@qq.com>
Date: Thu, 23 Jul 2026 16:36:57 +0800
Subject: [PATCH] docs: record WSL interface-name deviation

---
 .../2026-07-23-fastdds-164-network-change.md             | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/crucial_change/2026-07-23-fastdds-164-network-change.md b/docs/crucial_change/2026-07-23-fastdds-164-network-change.md
index e7743d0..7631437 100644
--- a/docs/crucial_change/2026-07-23-fastdds-164-network-change.md
+++ b/docs/crucial_change/2026-07-23-fastdds-164-network-change.md
@@ -959,3 +959,12 @@ unset _wsl_dds_profile
 - Fast DDS/RMW participant 实际创建：通过，输出 `RMW participant created`。
 - 环境摘要：Domain `22`、RMW `rmw_fastrtps_cpp`、本地 DDS 地址 `.151`、peer `.164`。
 - WSL 提交命令在工具等待窗口内没有返回，但后台提交随后正常完成；复核 commit `b8840ec9` 只包含两个批准的配置文件，原有 `.vscode` 暂存内容未进入该提交。
+
+### 实施偏差：WSL 接口名不稳定
+
+- 发现时间：2026-07-23 双向通信复核期间。
+- 复现：WSL 重启前 `.151` 位于 `eth4`；重启后仍为 `192.168.10.151/24`，但接口名变为 `eth3`。原脚本执行时返回 `ERROR: eth4 does not own 192.168.10.151`。
+- 根因：WSL 镜像网络接口编号会在实例重启后变化，接口名不是稳定标识。
+- 修正：WSL 环境脚本不再要求接口名为 `eth4`，改为在所有本地 IPv4 接口中查找 `192.168.10.151/`。Fast DDS XML 仍按稳定 IP `.151` 建立 interface whitelist，网络约束不变。
+- 范围：只修改 `/home/hikos/Yiliao2026/config/dds/use_wsl_dds_164_link.sh` 的前置检查和错误文本；不修改 XML、路由表、RDKx5 配置或 ROS package。
+- 失败保护：如果 `.151` 在任何接口上都不存在，脚本仍返回非零并拒绝启用 DDS 环境。