# 协作复盘 · V4-1865 网络模块重排 + 新增 LAN Setting（内部分享）

**日期**：2026-06-09　**作者**：Nancy Zeng　**任务量级**：小（US-5 局部调整 + 1 模块新增）

> 轻量复盘——本任务改动小，但定位「改哪一页」绕了几轮，值得记一条流程经验。

---

## 1. TL;DR

- **总轮次**：~3 轮澄清 + 1 轮执行（F0 试点 → F1–F5 批量）
- **最终交付**：Config-T Section `6703:1116` 六个 frame 网络模块统一为 `LAN Setting → Hotspot → WiFi → Ethernet → VLAN → Modem`，新增折叠 LAN Setting 模块
- **核心 process gap**：1 个（定位「自己之前建的页」花了多轮探查）
- **关键 insight**：用户手里有确切 node-id 时，**一句话贴链接** > AI 多轮反查截图

## 2. Session 概览

- **起点**：用户给需求号「V4-1865」+ 目标顺序 6 项，无 Figma 链接
- **落地**：6 frame 重排 + 新增模块；项目级顺序约定记 `docs/decisions/2026-06-09-network-module-display-order.md`
- **过程产物**：本复盘 + decision 记录 + work-log 条目

## 3. 时间线

| # | 阶段 | 触发 | 改动量 |
|---|---|---|---|
| 1 | 定位页面 | 需求号无链接，AI 在 6601:2 找不到这 6 模块 | 读 spec/handoff/work-log + 截图 5 张 |
| 2 | 澄清 LAN Setting | 现有页只有 5 模块、无 LAN Setting | AskUserQuestion → 用户选「新增」 |
| 3 | 用户贴 node-id 6703:1116 | "你自己创建的，没有发现吗？" | 直接命中目标 Section |
| 4 | 执行 | F0 试点截图校验 → F1–F5 批量 | 6 frame，6 个 clone |

## 4. Top process gap

### G1 · 定位「AI 自己之前建的页」绕了多轮（返工成本：中）

- **实证**：需求号 V4-1865 在文档里指向 Config-T page `6601:2`（Hotspot 3-mode），但用户要改的 6 模块在同文件另一个 Section `6703:1116`。AI 先 dump 6601:2 metadata（搜不到 Modem/Ethernet/VLAN，因标题是 instance 内 override 文本）→ 看 5 张历史截图 → 才靠用户贴 node-id 命中。
- **根因**：(a) 模块标题是 `WebUI/Title` 组件 instance 的 override，纯文本搜 metadata 搜不到，误判「这页没有这些模块」；(b) handoff/work-log 只登记了主 page node，没登记同文件内各 Section 的用途索引。
- **回流落点**：经验性，不立硬规则。下次遇「改某需求的某页」先 **问/确认确切 node-id**，并知道「instance override 文本不进 get_metadata 文本搜索，需截图或遍历 instance 内 TEXT」。

## 5. 高效对话建议

- **（给提需求方）** 改既有效果图时，**直接贴带 node-id 的 Figma 链接**最省时——比报需求号让 AI 反查快几轮。
- **（给提需求方）** 「按顺序调整」若涉及不存在的项（如本次 LAN Setting），一句话说明「这个要新增」可省一轮 AskUserQuestion。
- **（给 AI）** 模块/标题在 legacy 文件常是组件 instance override，`get_metadata` 文本搜不到 ≠ 不存在；该用截图或遍历 instance 内 TEXT 确认，别据文本搜索就下「这页没有」的结论。

## 6. 新规则清单

| 规则 | 真源文件 | 简述 |
|---|---|---|
| 网络模块显示顺序 | `TVU Pack/docs/decisions/2026-06-09-network-module-display-order.md` | LAN Setting→Hotspot→WiFi→Ethernet→VLAN→Modem，项目级，缺项跳过，折叠态不约束 |

（无回流 tvu-design-system 真源——用户拍板项目级约定。）

## 7. Model 选型

- 本任务（结构探查 + auto-layout reorder + 视觉校验）当前 model 胜任，无需升降档。

## 8. Action items + use_figma 统计

- **待办**：LAN Setting 展开体内容（本机 IP + 下挂设备 IP 分配范围）待定；当前隐藏体是 Modem 表单占位待替换。标题字体 Roboto Bold（替代沙箱不可用的 Helvetica），如需严格一致 legacy 可手动改回。
- **use_figma 改动**：1 读（结构探查）+ 3 写（F0 试点 / F1–F3 / F4–F5）+ 1 校验（M-INTEGRITY）；新增 6 个 LAN Setting clone 节点。