# Retrospect (internal share) — V4-2318 LCD Internal-Module-Mode Mockup

**日期**：2026-06-04　**Designer**：Nancy Zeng　**协作 AI**：Claude (plan-owner/executor)

## 1. TL;DR
- 从「按 LCD pickup handoff 起手」到「完整 LCD mode-flow + linked screens + 2 张分析表 + handoff + 规则回流」约 **30+ 轮**迭代。最终交付：Touch Screen 文件内 1 个 Section（5 帧 mode-flow + 5 张 M23 卡 + 3 张 linked screens + 对比矩阵 + 6 条切换确认文案表 + PRD 卡 + 真 Jira 组件）。
- **核心 process gap：5 个**（详见 §4）。
- **关键 insight**：跨产品需求落到新载体(Config-T → LCD)时，**载体原生范式（确认框/双背景色/命名）必须先 probe**，不能照搬源载体的 web 范式；且**命名要一次性把 IA 冲突想透**再动笔。

## 2. Session 概览
- 起点：读 `2026-06-02-v4-1865-lcd-pickup.md` 起手协议，开新 ticket V4-2318。
- 落地：Hotspot 模块 3-mode 在 LCD 的查看/切换；切换即弹**原生确认**；Disable 双 QR 置灰+远程兜底；WiFi 模式跳转 WiFi 页；WiFi 页 `WiFi 2 (WiFi / Hotspot Module)` 命名；全部包进一个 Section。
- Process artifacts：handoff + 本复盘 + 3 条规则回流候选 + 3 条记忆（双背景色规则 / frame 摆放纪律 / scope）。

## 3. 主要迭代
| # | 触发 | 改动 |
|---|---|---|
| 1 | "3 个 mode 方案都不好 / 表达不出三者关系" | 多轮试 mode 呈现，最终定横向 3-segment pills |
| 2 | "Hotspot 应显示 2 个二维码" | 补双 QR(连接 + 配置页) |
| 3 | "Disable 后还能扫码吗" | Disable 双 QR 置灰 + 远程(Command Center)兜底 |
| 4 | "参考 config-T 处理 WiFi 模式" | WiFi 模式不自配，跳转 WiFi 页 |
| 5 | "F3/F4 颠倒 + 高影响要确认" | 重排顺序 + 加确认框 |
| 6 | "弹窗参考 6443-16784 原生样式 + 本地组件" | 弃 M41 web 遮罩，改原生 header+内容区+底部按钮 |
| 7 | "双背景色是 LCD 重要规则" | 弹窗/各帧改满宽内容色 + chrome 区 |
| 8 | "哪个 WiFi 是热点模块" | 命名统一 `WiFi / Hotspot Module` |
| 9 | "页面还得叫 Hotspot 为主" | header 回退 Hotspot（避免与 WiFi 页撞） |
| 10 | "chip 像输入框" | 改内联灰色括号提示 |
| 11 | "全 6 条互切都要确认" | 1 锁样帧 + 文案表 |
| 12 | "矩阵找不到 / 压到别的 frame / 没进 Section" | 修页面归属 + 摆位 + 建 Section |

## 4. Top process gaps（按返工成本排序）
1. **新建 frame 没切对 page / 没扫位防重叠 / 没用 Section**（最贵）— 对比矩阵漏 `setCurrentPageAsync` 落到封面页，用户找不到；文案表往下堆压到矩阵；全程散在 page 上。返工：迁页 + 重摆 + 建 Section 收纳 28 帧。**已回流**：记忆 `figma-frame-placement-discipline`（扫位→选址带依据→建→验重叠→确认在 Section 内）；候选进 mockup-conventions。
2. **照搬源载体 web 范式做确认框** — 直接套 M41(20%遮罩+blur+居中卡片)，但 LCD 原生确认是整屏 header+内容区+底部按钮。用户指 6443-16784 才纠正。返工：弹窗重做 + 双背景色补回。**已回流**：记忆 `lcd-two-bg-color-rule`；候选进 mockup-conventions（M41 补 LCD 变体）。
3. **命名 IA 没一次想透** — `Internal Module` → `WiFi / Hotspot Module` → header 又回退 `Hotspot`，来回 3 轮。根因：没在命名前把"模式设置页 vs WiFi 网络页"的撞名问题摊开。返工：5 处 header 改了又改。**教训**：命名统一前先列全所有出现该实体的页面，检查冲突。
4. **claim 与用户视角没对上**（"加好了"但用户没看到）— 我按 screenshot tool 的 tight-crop 视角说留白完成，没核对用户画布视角（灰底太接近画布、留白看不出）。返工：调底色 + 加大留白 + 反复确认。**教训**：宣称"完成"的视觉改动，要么截当前态给用户比对，要么说清"可能需刷新"。
5. **小控件没用对范式**（chip 边框像输入框）— 用户要内联提示。返工：去边框改括号灰字。**教训**：信息标识默认先用最轻量（内联文字），别一上来加容器。

## 5. 高效对话建议
- **给 AI/PM**：跨产品需求(A 产品 → B 载体)起手，先一句话点明"B 载体有哪些原生范式/规则必须遵守"（如 LCD 双背景色、原生确认），省 §4-2 整轮返工。
- **给 AI 协作流程**：① 任何新建顶层节点走"扫位→选址(带依据)→建→验重叠→Section"；② 命名统一前列全实体出现的所有页面查冲突；③ 宣称视觉完成前核对用户视角。
- **给 review 方**：交付前 N 变体（如 6 条确认）用一张文案表 + 1 锁样帧表达，不必逐个画，review 更快。

## 6. 规则比对（现有 vs 新增）— 核心结论：**多数返工是违反已有规则，非规则缺失**

### 6A. 违反了已有规则（compliance gap，无需新规则，需我更严格自查）
| 今天的问题 | 早已存在的规则 | 真源位置 |
|---|---|---|
| Config-T 漏 Section / 矩阵散落 / Section sizing 错 | ① Section 必包 Jira+PRD+mockup+UX卡+连线+状态标签；反模式；section 不自动 hug 需 `resizeWithoutConstraints` | design-process ① + 反模式(line 67) + mockup-conventions §811 |
| 双语 ZH 硬编码白色（EN 是灰/cyan） | 「EN 什么底色 ZH 就用相同底色 + 半透明，无需记特殊颜色值」+「禁止中英同色」 | mockup-conventions line 500 / 516 |
| caption 离 frame 太近、放大撞 frame 名 | 「label + UI frame 打成 GROUP（无名称标签），不与 Figma frame 名标签冲突」 | mockup-conventions line 418 |
| dialog 按钮一度自画 | library-first / 用 `LCD Button` variant | M30 / M32（line 1236/1248）|

> **根因**：编辑早于规则建立的旧交付物（Config-T 05-29/06-01 < Section 规则 06-03）时没把它升级到现行规范；且新建/改动后没按既有 acceptance（probe 验 ZH opacity、section bbox、zoom 验）自查。**这是执行纪律问题，不是规则空缺。**

### 6B. 真正的新缺口（**项目级，存当前项目，不回流真源** — Owner 2026-06-04 拍板）
落点：[`docs/decisions/2026-06-04-lcd-mockup-project-rules.md`](../decisions/2026-06-04-lcd-mockup-project-rules.md)
| 项目规则 | 与真源关系 |
|---|---|
| **L1 LCD 双背景色**（nav/footer=chrome、content=另一色；内容内缩 12px 背景满宽；弹窗同样） | 真源无 LCD 页面背景结构规则 |
| **L2 M41 的 LCD 例外**：M41 是 web「scrim+居中 dialog」；LCD 原生确认=整屏 header+content+底部按钮、无 scrim；N 变体用锁样帧+文案表 | 与 M41(line 1633) 冲突，LCD 走项目例外 |
| **L3 Disable 模块远程兜底**：本地扫码失效 → 置灰 + 指向 Command Center | 真源无该域规则 |

> Owner 判定这些是 LCD 项目特有、非全产品规则，故留项目 `docs/decisions/`，不进 tvu-design-system。

### 6C. 已存记忆（项目级，非真源）
`lcd-two-bg-color-rule`（→6B-1）· `figma-frame-placement-discipline`（实为 6A 既有规则的自查提醒）· `tvu-pack-scope`

## 7. Model 选型
全程单一高能力 model（设计决策 + 密集 use_figma 写操作 + 30+ 轮迭代）。Figma 脚本返工成本高，建议保持高能力 model；不建议中途降级。

## 8. Action items
- [ ] PM/dev review V4-2318 Figma（Section 8672:11）。
- [ ] V4-1865 Config-T 同步 `WiFi / Hotspot Module` 命名。
- [x] §6B 3 条定为**项目级**（Owner 拍板），存 `docs/decisions/2026-06-04-lcd-mockup-project-rules.md`，不回流真源。
- [ ] 我后续 mockup 按 §6A 既有规则的 acceptance 自查（probe 验 ZH opacity / section bbox / zoom），减少违例返工。

---
**附录 · use_figma 改动**：本轮新增 1 Section + 2 分析表(矩阵/文案表)，重构确认弹窗(原生化+双背景色)，WiFi 页命名+chip，5 帧 header 统一,M23 5 卡文案同步,M-FONT 29 段修正,删 1 text-as-icon。