---
id: v4-2318-internal-wifi-module-mode
title: Internal WiFi Module Mode on LCD Screen (V4-2318)
doc_type: design-record
status: requirement
last_updated: 2026-06-02
sources:
  - { type: jira, ref: "V4-2318", url: "https://tvunetworks.atlassian.net/browse/V4-2318" }
---

# Feature Design Record — Internal WiFi Module Mode on LCD Screen (V4-2318)

> ⚠️ **STUB** — 仅从 Figma page 名登记（`< V4-2318 > Internal WiFi Module Mode on LCD Screen 20260602`，在 Touch Screen 文件 V4「To be confirmed」段）。本需求细节尚未在本 session 展开，待开工时按模板补全 §1–§9。

- **JIRA**：[V4-2318](https://tvunetworks.atlassian.net/browse/V4-2318)　**Scope**：V4 LCD（TM1100 Touch Screen）
- **Owner(dev)**：Edward Wu（按 V4 LCD 路由）　**PM**：Trevor Yao　**Designer**：Nancy Zeng
- **Status**：待开工（stub）　**日期**：2026-06-02

## 待补
- ~~与 V4-1865（Hotspot 3-mode）关系~~ → 已确认：**就是**同一「内置 WiFi 模块 mode」主题在 LCD 端的落地。实质内容在 [`docs/handoffs/2026-06-04-v4-2318-lcd-mockup-handoff.md`](../handoffs/2026-06-04-v4-2318-lcd-mockup-handoff.md)（已交付 + Trevor Review Round 1 修完）。
- §1–§9 按 [`_feature-design-record.template`](.) 补全 —— 仍未做，本文件继续是 stub，**读实质内容请去 handoff**。

## Revision Log

### 2026-09-11 · 补 Mode 切换失败态（D1–D7）

**决策全集与起因**：与 Config-T 端同源，**不在此复述** —— 见 [V4-1865 design-record §10](2026-05-29-v4-1865-wifi-hotspot-mode-design-record.md)。一句话：模块当 WiFi 用过、WiFi 服务被关闭后切回 Hotspot，状态机已跳值而驱动层未重建 AP ⇒ 界面显示 Hotspot 但热点没在跑。原交付稿（handoff §3 的 5 帧 + 6 条确认文案）**只有成功路径、没有失败分支**。

**本轮交付（LCD 端，page `8476:2` / Section `8672:11`）**：

| 交付件 | node |
|---|---|
| F5 失败态帧 | [`10464:357`](https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/?node-id=10464-357) —— clone F3(Mode=WiFi) + 库 `Message / error / L`（`10464:1328`）**`x=20.5, y=8`**（落位说明见下）|
| 行标题 | `10464:378` |
| UX 交付卡 | [`10466:393`](https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/?node-id=10466-393) 520×245 |
| 逻辑更新块（M23.17）| [`10467:431`](https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/?node-id=10467-431) 520×409 |
| 切换文案表补节 | `8664:233` 扩高 524→613，新增独立「Failure feedback」小节（`10468:393` / `10468:394` / `10468:395`）—— **与 6 条确认文案分区**，因为它不是确认弹窗而是操作后结果 |
| 文案真源 | [`lcd-message-strings.md` §5](lcd-message-strings.md) |

**⚠️ 落位终值 `x=20.5, y=8`（§2.5 A 档）—— ⛔ 此前写的 `y=118` 已作废**（owner 2026-09-11 看 mockup 后拍定「错误的提示应该在顶部，当前的位置不对」）。

- **`y=54` 不行**（实测）：提示 54..99 把 `Mode row`（46..98）整条盖住，且居中后宽 439 < 456 ⇒ 左右各露 8.5px、把 `Mode` 的 "M" 切成半截。
- **`y=118` 不行**（owner 判）：它满足了「不压论据控件 + 不切字 + 取最靠上」三条判据，但落到内容区中段后**读起来不像浮层、像一句正文**。⇒ 三条判据是在「顶部区域内部」选点用的，不该拿它把提示一路往下推。
- **`y=8` 逐字形复核**：唯一被覆盖 = 导航标题 `Hotspot`（11..35，整体覆盖不切半）；`Mode`（63..82）· 三个 pills（64..81）· 正文（145..162）· `Connect to WiFi`（195..212）· `Home`（288..306）全部可见。
- **取舍原则**：盖标题 vs 盖 pills，**宁可盖掉「我在哪」，不能盖掉「凭什么这么说」** —— pills 是「mode stays WiFi」这句话的现场论据。

🔴 **同轮修掉一个真错**：提示条曾 `x=56, w=439 ⇒ right=495 > 480`，帧 `clipsContent=true` ⇒ ✕ 被切。成因是加 ` Retry later.` 后宽度 369→439 而 `x` 仍是旧宽度的居中值。⇒ **改 HUG 宽度文案后必须重算落位、复核 `x+width ≤ 帧宽`**；§4.1 的「宽 ≤480」只管文案装不装得下，管不住摆进去之后右缘在哪。

落位通则里「设置页 + 导航下紧接状态控件行」那一档已按此改写，见 [`lcd-message-strings.md` §2.5](lcd-message-strings.md)。

✅ 它松动的另外两条，owner 2026-09-11 同日一并拍定（判定顺序真源 = [`lcd-message-strings.md` §2.5.1](lcd-message-strings.md)）：
1. ✅ **设置页的默认落位 `y=54` 已收窄** —— 加了前提「**导航条正下方不是这条提示所指代的状态控件行**」。是的话改盖标题、保控件（`y=8`）。原理由（标题是「我在哪」的唯一凭据）仍成立，只是当提示自带论据控件时，论据的优先级高于标题。
2. ✅ **V4-2333 的两个帧 `9988:423` / `9988:690` 判为当初误判，已从待修名单划掉**。核过：它们导航条正下方 46..172 是三行参数值（`Pattern: Ramp` / `Format: 1080i59.94` / `Tone: 1 s`），而两条提示说的就是「参数已应用 / 应用失败」⇒ 参数行即论据 ⇒ 按收窄后的规则该盖标题、保参数行 ⇒ `y=8` 本来就对。实测提示 8..53 完整覆盖标题（12..35）、首行参数文字从 58 起未被触碰，与本页失败态帧逐条同形。

**存量偏离（如实登记）**：本页产品帧与注释卡文字均为 **Inter**（非 LCD 产品层的 `Verdana`、非注释层的 `Roboto`+`Noto Sans SC`），源自 2026-06 建页时的 §M47 fallback。本轮 clone 继承以保页内一致（§M21.4），`annotation-font-roboto-noto` 闸命中项经对照**既有同类节点全部同样命中** ⇒ 存量债，待 owner 决定是否整页收敛。

**失败文案终值（owner 2026-09-11 定 Q1）**：`Couldn't switch to {target} — mode stays {current}. Retry later.` —— 不说原因、但给下一步。LCD 侧节点 `I10464:1328;4798:1714;10464:1344` 实测 **439×45 单行**（最长参数组合 458×45）。⛔ `Try again later.` 装不下（480×66 折两行），别按语感改回去。逐候选实测表见 [`lcd-message-strings.md` §5.2](lcd-message-strings.md)。

**Jira 收尾（2026-09-11 结案，⛔ 与此前写的待办不同）**：

- **本单不回复、不转 assignee** —— 直读实况：V4-2318 **status = Resolved（已关闭）**、**assignee 早已是 Edward Wu**。此前那条「待办：Jira 回复 + assignee 转 Edward Wu」**基于两个错误前提**（以为单还开着、以为 assignee 还没转），已作废。
- 失败态设计的 Jira 落点 = **[V4-2466](https://tvunetworks.atlassian.net/browse/V4-2466)**（winni 2026-09-09 开的现象单，To Do / Danner Dai，本轮唯一还在跑的单）。🔴 **但最终一条都没发** —— owner 2026-09-11 逐字「不用回复 JIRA」⇒ 本需求**不发任何 Jira 评论**，三个单都不发、assignee 也不动。⛔ 这是终态不是暂缓，别下一轮当待办捡回来；草稿存档见 [plan §11](../plans/2026-09-11-mode-switch-failure-state-plan.md)。
- ⚠️ **代价（如实登记）**：本单上没有任何指向失败态设计的线索。日后从 V4-2318 找失败态设计会找不到，须先到 V4-2466。要不要补一条指路评论 / 建 `relates to` 关联，是独立一件事，待 owner 另行决定。