增加网络配置界面

2026-09-10 11:36:33 +08:00
parent 020278d4e3
commit 8e1fd3b2b8
44 changed files with 2488 additions and 332 deletions
@@ -55,7 +55,7 @@ scanned 13 files; unique non-ASCII chars: 78
 -> D:\Code\DTU Code\STM32F4-Base\ui_cn_chars.txt
 ```

-产物 `ui_cn_chars.txt` 为本工程实际显示的汉字清单（当前 97 字），可留作字符集记录。
+产物 `ui_cn_chars.txt` 为本工程实际显示的汉字清单（当前 111 字，含 ▶/，等符号），可留作字符集记录。

 ---

@@ -85,12 +85,17 @@ npm i -g lv_font_conv     # TTF/OTF -> LVGL 字体 离线转换器
 ```
 extracted SimSun regular (face0) -> C:\Users\...\Temp\simsun_regular.ttf
 RUN: lv_font_conv.cmd --font ... --size 12 --bpp 1 -r 0x20-0x7E --symbols ... --no-compress --format lvgl --lv-font-name ui_font_cn_12 -o ...\ui_font_cn_12.c
-已合并箭头 U+25B6：位图+10 字节，glyph_id=173
-OK 35485 bytes -> ...\Drivers\BSP\UI\ui_font_cn_12.c
+已合并箭头 U+25B6：位图+10 字节，glyph_id=206
+已合并 U+FF0C '，'：1 字节位图，glyph_id=207
+OK 43614 bytes -> ...\Drivers\BSP\UI\ui_font_cn_12.c
 ```

 > **▶ 箭头自动合并**：宋体（`simsun.ttc`）没有 U+25B6（▶）字形，`lv_font_conv` 会静默跳过 → 真机显示成方框。`make_font.py` 在生成后自动调用 `merge_arrow_glyph()`，把从 **Segoe UI Symbol**（`seguisym.ttf`，Windows 自带）预提取的箭头字形（位图 10 字节 + `glyph_dsc` + `cmap`）补回 `ui_font_cn_12.c`。该合并**幂等**（已存在则跳过），所以重生成字体后箭头不会丢。换用自带 ▶ 的字体（如黑体/Segoe）时可忽略此步。

+> **低码位符号自动合并**：`lv_font_conv` 的稀疏 cmap 从符号集最小码位起算，**低于该起点的符号被静默丢弃**（实测 U+3001/U+FF0C 等：U+FF0C 全角逗号 < 0x4E2D 范围起点时丢失，页脚"第 X 页，共 Y 页"的逗号长期渲染为空白）。`make_font.py` 的 `merge_extra_symbols()` 对每个此类符号单独生成迷你字体（真实宋体位图/度量），再并入主字体（位图 + `glyph_dsc` + 单码位 `cmap`），同样**幂等**。新增此类符号时把它加入脚本的 `EXTRA_SYMBOLS` 列表即可。
+
+> **生成后覆盖率断言**：`make_font.py` 在合并后调用 `verify_coverage()`——解析生成字体的 cmap，校验 `ui_cn_chars.txt` 的**全部码位**都进了字体，缺一个即以非零退出码报错（列出 `U+XXXX`）。把 lv_font_conv 的静默丢字（低码位、源字体缺字形）从"上线后才发现空白"变成"生成期硬错误"。
+
 参数说明：
 - `--bpp 1`：单色无抗锯齿；体积最小。**注意** lv_font_conv 在 1bpp 下斜线/细笔画偶发"丢像素"，宋体尤甚。
 - `--bpp 2/3`：字形带灰度，渲染到 1bpp 屏时按 `LV_DRAW_SW_I1_LUM_THRESHOLD` 阈值化，笔画更连贯；子集仅几十~上百字，体积仍很小。
@@ -147,7 +152,7 @@ OK 35485 bytes -> ...\Drivers\BSP\UI\ui_font_cn_12.c
 1. **1bpp 细笔画发虚**：宋体在 1bpp 下可能丢像素。若上板/客户端中文偏淡，把第 4 节 `--bpp` 改为 `2` 重生成即可（子集小，体积可接受）。
 2. **字符集变更**：以后新增中文菜单项，须重跑第 3、4 节（重新提取 `ui_cn_chars.txt` 并生成），否则新字显示为方框。
 3. **编码**：UI 源文件须为 **UTF-8（带 BOM）**，LVGL 按 UTF-8 解码中文串；字体 `.c` 为纯 ASCII，无编码风险。当前 Keil 已加 Misc Controls 抑制项，无需额外 `--locale=english`。
-4. **字体体积**：12px + 1bpp + ~78 字 ≈ 35.5KB（RO-data）；改 bpp 2 约翻倍，仍在 F407 Flash 余量内。
+4. **字体体积**：12px + 1bpp + 111 字（含 ASCII/符号）≈ 43.6KB（RO-data）；改 bpp 2 约翻倍，仍在 F407 Flash 余量内。
 5. **换字体**：黑体用 `simhei.ttf`（单文件免抽取）；其余字体同理替换 `--font` 路径后重生成。

 ---
@@ -48,7 +48,7 @@ flowchart TD
 |---|---|---|---|
 | C1 | 屏幕 | 160×160，1bpp 单色（`LV_COLOR_FORMAT_I1`），无物理屏（远端客户端显示） | `ui_port.h` |
 | C2 | 字体 | **唯一**：`ui_font_cn_12`（宋体 12px 1bpp）。汉字 12px/字，ASCII 6px/字，行高 13px。需要其他字号 = 大工程（新字体 + 双端 `lv_conf.h`），默认禁止 | `ui_font_cn_12.c` |
-| C3 | 字符集 | 子集字体（当前 97 汉字 + ASCII 0x20-0x7E，共 193 字形）；**缺字显示空白**；新字必须重生成字体 | `tools/font_gen/` |
+| C3 | 字符集 | 子集字体（当前 111 汉字/符号 + ASCII 0x20-0x7E，共 208 字形）；**缺字显示空白**；新字必须重生成字体 | `tools/font_gen/` |
 | C4 | LVGL 内存池 | 40KB（`LV_MEM_SIZE`）；任一时刻只放"当前导航路径 + 当前内容页" | `Lib/lv_conf.h` |
 | C5 | 文本 | 一律静态字符串（`lv_label_set_text_static`），禁止动态字符串/strdup | 架构文档 |
 | C6 | 编码 | `Drivers/BSP/UI/*`、`ui_task.c`、`Lib/lv_conf.h` 为 **UTF-8 带 BOM**；改动只用 Edit 工具，**禁止** PowerShell/cmd 整文件重写（U+FFFD 不可逆） | AGENTS.md 铁律 |
@@ -440,3 +440,5 @@ P5  [ ] UI_设计架构.md 变更记录更新
 | 2026-09-04 | §九 新增 9.1“样机投入分流（按屏型）”：明确 HTML 样机=静态外观轴（设计先行、非代码生成器），设计文档 + 模拟器=行为/数据轴；静态内容页走完整样机管线、导航/交互重屏 HTML 只做静态首帧、行为靠 `菜单页面设计.md`；配套文档补列 `菜单页面设计.md` |
 | 2026-09-07 | §一 五阶段管线图由 ASCII 转 Mermaid flowchart：P1/P3“比对→修正”迭代环由行内 ⟲ 注记改为显式判定节点 + 回边（未收敛不得前进更直观）；各 Gate 条件与产物标注保留、语义不变 |
 | 2026-09-09 | 内容页三屏（装置信息/交流量/直流量，`ui_content_page`）落地后回填：C3 字符集 78→97 汉字（193 字形）；§十 新增两坑——UI BOM 源文件 `snprintf` 中文格式串触发 C4819（改 `lv_snprintf`）、常驻动态样式池永久占用（改 `LV_STYLE_CONST_INIT` 常量样式，x64 实测省 88 B/个） |
+| 2026-09-09 | 用户密钥密码页落地后回填：C3 字符集 97→102 汉字（198 字形，补"本/用/户/密/钥"）；新文案走 P4 字体重生成 + `check_content_pages.py` 新增密码页 4 状态黄金参考 |
+| 2026-09-10 | 网口设置内容页落地后回填：C3 字符集 102→111 字符（208 字形，补网口设置/地址/掩码等，并修复 `lv_font_conv` 丢弃的低码位符号 U+FF0C 全角逗号 → 页脚逗号不再空白）；新文案走 P4 字体重生成 + `check_content_pages.py` 新增网口设置 4 状态黄金参考（可编辑/只读/编辑光标反显/保存 OK）；模拟器 `main` 调 `net_cfg_load` 使参考图显示工厂默认值 |
@@ -26,12 +26,19 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 | 步 | 脚本/命令 | 门禁内容 | 预期输出 |
 |---|---|---|---|
 | 1 | `simulator/tests/check_menu_rows.py` | 菜单 8 状态：选中行白带 / 非选行黑底白字 / 框体 1px 边框 / 往返像素一致（S3==S1、S6==S1、S7==S2）+ S0 池基线 | `PASS: 8 状态全部断言通过（8 图，池基线 4784 B）` |
-| 2 | `simulator/tests/check_content_pages.py` | 装置信息/交流量/直流量三页截图与 `ref/` 黄金参考**逐字节**比对 + 开页-关页往返池水位 | `PASS: 3 内容页 + 往返池水位全部通过` |
+| 2 | `simulator/tests/check_content_pages.py` | ① 文本级断言（字形模板匹配，50 条，独立于 `ref/`）→ ② 11 页截图与 `ref/` 黄金参考**逐字节**比对 + 开页-关页往返池水位 | `PASS: 11 内容页 + 往返池水位全部通过`（文本断言先于像素比对，失败即中止） |
 | 3 | `MDK-ARM\build.bat` | MCU 端编译（UI 源码双端共用，改一端必须过另一端） | 退出码 0 = BUILD_OK |
 | 4 | `scripts/check_coding_standard.py` | 代码规范 V1.0 机械检查 | PASS |

+> **文本级断言层**（2026-09-10 新增）：`check_content_pages.py` 内置字形模板匹配——直接解析
+> `ui_font_cn_12.c` 的 cmap/glyph_dsc/bitmap，把期望字符串（标题/标签/值/页脚，含新增易缺字文案）
+> 渲染成墨点集合，在截图对应 y 带内做精确匹配（LVGL 基线对齐）。价值：**缺字显示空白 / 标签写错**
+> 这类回归不再只靠像素位图（那需要刷参考，且无视觉后端时难以判读）；文本断言不依赖 `ref/`，且
+> **先于**像素比对运行，失败即中止（不误刷参考）。文本断言覆盖确定文案，像素参考仍负责几何/样式/
+> 光标反显等其余视觉。
+
 **退出码约定**：两个脚本均为 0=PASS / 1=断言失败 / 2=环境错误（exe 缺失、参考缺失）。
-失败时脚本打印差异明细（ink runs 对照 / 像素差数），内容页脚本保留现场截图于临时目录并提示路径。
+失败时脚本打印差异明细（文本断言未命中项 / ink runs 对照 / 像素差数），内容页脚本保留现场截图于临时目录并提示路径。

 ## 三、内存水位门禁常量

@@ -44,12 +51,27 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 `菜单页面设计.md` §9.5），再更新脚本常量并在本文变更记录登记。**禁止为过门禁盲目改常量**——
 无法解释的漂移 = 内存回归 bug。

-## 四、黄金参考更新流程（有意改视觉时）
+## 四、黄金参考与目检 PNG（均为本地生成物，不入库）

-1. **先肉眼确认新效果正确**：窗口模式运行 `simulator\build\Debug\lvgl_sim.exe`，或截图转 PNG
-   （`python simulator/i1_to_png.py <shot.bin> --scale 6`）对照 mockup；
-2. 刷新参考：`.venv\Scripts\python.exe simulator/tests/check_content_pages.py --update`（重写 `ref/shot_*.bin`）；
-3. `git status` / `git diff` 确认 `simulator/tests/ref/` 变化符合预期，随代码一起提交。
+`simulator/tests/ref/` 下的 `.bin`（像素黄金参考）与 `.png`（目检图）**都不入库**（`.gitignore`）——
+首次/换机后必须先生成一次：
+
+```powershell
+.venv\Scripts\python.exe simulator/tests/check_content_pages.py --update   # 生成 ref/*.bin
+.venv\Scripts\python.exe simulator/tests/regen_ref_png.py                  # 生成 ref/*.png（--scale 6 --invert）
+```
+
+有意改视觉时的流程：
+
+1. **先肉眼确认新效果正确**：窗口模式运行 `simulator\build\Debug\lvgl_sim.exe`，或刷新后跑
+   `regen_ref_png.py` 看图对照 mockup；
+2. 刷新参考：`.venv\Scripts\python.exe simulator/tests/check_content_pages.py --update`（重写 `ref/*.bin`）；
+3. **重生成目检 PNG**：`.venv\Scripts\python.exe simulator/tests/regen_ref_png.py`。
+   `.png` 是本地调试产物、**不会**随 `.bin` 自动更新——不重跑则 PNG 仍是旧渲染（缺字/错位，看似"乱码"）。
+   默认 `--scale 6 --invert`（深字白底便于目检）；`--no-invert` = 白字黑底（与设备一致）；
+4. 无需提交 `ref/`（已 gitignore）。
+
+**误刷保护**：`--update` 会**先跑文本级断言**，断言失败即中止，避免把缺字/错标签的渲染"刷成"新基准。

 **何时不该更新**：未有意改视觉而某页 FAIL → 是 bug（缺字、几何漂移、样式回归），修代码而不是刷参考。
 菜单状态无黄金参考文件——其断言是结构性的（白带占比/边框/往返一致），不依赖入库位图。
@@ -76,3 +98,6 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 |---|---|
 | 2026-09-09 | Python 解释器统一为仓库 `.venv`（新增 `requirements.txt`，`.gitignore` 忽略 `.venv/`）；§1/§2/§4 命令同步改用 `.venv\Scripts\python.exe` |
 | 2026-09-09 | 初版：菜单 8 状态像素回归 + 内容页黄金参考回归（ref/ 3 图，I1 原始位图入库）+ 池水位门禁（4784/4864 B）。脚本自会话临时目录整理入 `simulator/tests/`（相对路径定位 exe、输出改临时目录），替代每次重写 |
+| 2026-09-10 | `check_content_pages.py` 新增**文本级断言层**（字形模板匹配 50 条，独立于 `ref/`，先于像素比对运行、失败即中止防误刷参考）；内容页扩至 11 页（+网口设置 4 态）；§二/§四同步 |
+| 2026-09-10 | 新增 `simulator/tests/regen_ref_png.py`（由 `ref/*.bin` 批量重生成目检 PNG，默认 `--scale 6 --invert`）；`ref/*.png` 加入 `.gitignore`（本地调试产物不入库）；§四 补"重生成目检 PNG"步骤（修复"刷了 `.bin` 参考但 `.png` 仍是旧渲染 → 看似乱码"） |
+| 2026-09-10 | `simulator/tests/ref/` **整目录不入库**（`.bin` 黄金参考 + `.png` 目检图均为本地生成物）：`git rm --cached` 原有 3 个 `.bin`，`.gitignore` 改为忽略整目录；首次/换机后先 `--update` 生成参考；`--update` 先跑文本断言防误刷；§四 重写 |
@@ -19,7 +19,7 @@ MCU **无物理屏幕**：LVGL 做 160×160 **1bpp 单色离屏渲染**，帧缓
 | `Drivers/BSP/UI/ui_menu.c/h` | **共用** | 菜单导航逻辑层：持有导航状态（路径/选中/深度/滚动，共 17 B）+ 键语义，单向驱动显示层；不持 LVGL 对象 |
 | `Drivers/BSP/UI/ui_menu_view.c/h` | **共用** | 菜单显示层：横向级联框渲染（右贴靠/自适应宽/顶底对齐），持有全部 LVGL 对象与样式、无导航状态 |
 | `Drivers/BSP/UI/ui_menu_tab.c/h` | **共用** | 菜单数据层：`g_menu_tab[]` 父子索引表 + 查询 API（生成物，勿手改） |
-| `Drivers/BSP/UI/ui_content_page.c/h` | **共用** | 内容页框架（机制 + 描述符表）；装置信息/交流量/直流量三页由 `ui_page_xxx` 模块接入（独立屏按需建毁，自绘行，零常驻池占用）；多页面"框架+页面插件"架构见 `内容页架构.md` |
+| `Drivers/BSP/UI/ui_content_page.c/h` | **共用** | 内容页框架（机制 + 描述符表）；装置信息/交流量/直流量/用户密钥四页由 `ui_page_xxx` 模块接入（独立屏按需建毁，自绘行，零常驻池占用）；多页面"框架+页面插件"架构见 `内容页架构.md` |
 | `Drivers/BSP/UI/ui_net_sink.c/h` | MCU | RemoDispBus 服务端（收键 + 回送帧缓冲） |
 | `Drivers/BSP/UI/ui_font_cn_12.c` | **共用** | 中文 1bpp 子集字体（`lv_font_conv` 生成物） |
 | `App/task/ui_task.c/h` | MCU | UI 任务：等 NET_READY → 初始化 → 10ms 刷新循环 |
@@ -37,7 +37,7 @@ MCU **无物理屏幕**：LVGL 做 160×160 **1bpp 单色离屏渲染**，帧缓
 | LVGL 内存池 | 40 KB（`LV_MEM_SIZE`） | `Lib/lv_conf.h` |
 | 刷新周期 | 10 ms（`ui_port_step(10)` + `osDelay(10)`） | `ui_task.c` |
 | 推流端口 | 7003（TCP，与 DTU-RemoteLCD 客户端对齐） | `ui_net_sink.h` |
-| 默认字体 | `ui_font_cn_12`（12px 1bpp，97 汉字 + ASCII 0x20–0x7E + ▶，共 193 字形） | `Lib/lv_conf.h` |
+| 默认字体 | `ui_font_cn_12`（12px 1bpp，111 汉字/符号 + ASCII 0x20–0x7E，共 208 字形） | `Lib/lv_conf.h` |
 | uiTask 栈 | 16384 words（BelowNormal） | `Src/freertos.c` |

 ### 1.4 硬约束（改 UI 必须遵守）
@@ -186,14 +186,14 @@ ENTER/→ 进子框：

 ### 4.7 内容页（ui_content_page）

-> 菜单叶子节点进入后的**独立全屏页面**（装置信息/交流量/直流量），与级联框同屏互斥。设计细节见 `菜单页面设计.md` §九。
+> 菜单叶子节点进入后的**独立全屏页面**（装置信息/交流量/直流量/用户密钥密码页），与级联框同屏互斥。设计细节见 `菜单页面设计.md` §九、`内容页架构.md`。

 - **对象树**：`screen(新) → cont 全屏容器（flat + CLICK_FOCUSABLE，键入口）`；行全部自绘（无子对象），与级联框同一"行=数据"策略
 - **生命周期 = 按需建毁**：ENTER 叶子（node 1/3/4）→ `lv_obj_create(NULL)` 新建独立屏 + 容器 → 入默认输入组获焦 → `lv_screen_load` 切屏；ESC → 焦点先回菜单持久容器、切回菜单屏，再删容器+屏。菜单屏对象**保留不销毁**（返回即原样还原）
 - **导航状态不压层**：菜单 `s_depth/s_sel/s_scroll` 原样保留，内容页只记自身选中行 `s_sel`（每次进入从首行开始）
 - **池占用实测**（模拟器 x64，40KB 池）：开页峰值 +776 B（屏+容器+事件列表+局部样式），关页后回落；一次性残留 **+80 B**（screens 数组高水位 +8、`lv_screen_load` 给菜单屏设 X/Y 局部样式 +72，均为 LVGL 核心行为、非本模块泄漏）
 - **flat 样式用常量样式**（`LV_STYLE_CONST_INIT`）：属性存静态数组、零池分配；动态 `lv_style_t` 首次 set_prop 会从池分配 `values_and_props` 且永不释放（x64 实测 88 B/个，MCU 同量级），常驻样式一律用常量样式
- **多页面架构（已定稿并拆分，2026-09-09）**：待实现 30 个叶子页；框架（本模块）+ 每页一文件（`ui_page_xxx`，描述符为 extern const 对象）+ 4 个扩展钩子（refresh/count_cb/draw_cb/key_cb），见 `内容页架构.md`；架构第一步（共享"浅 V"装饰 `ui_deco`）与拆分本身均于 2026-09-09 落地，纯重构回归全绿（像素一致、池 4784/4864 B 不变）
+- **多页面架构（已定稿并拆分，2026-09-09）**：待实现 30 个叶子页；框架（本模块）+ 每页一文件（`ui_page_xxx`，描述符为 extern const 对象）+ 4 个扩展钩子（refresh/count_cb/draw_cb/key_cb），见 `内容页架构.md`；架构第一步（共享"浅 V"装饰 `ui_deco`）与拆分本身均于 2026-09-09 落地，纯重构回归全绿（像素一致、池 4784/4864 B 不变）；首个表单/操作页（用户密钥密码页：draw_cb+key_cb + 描述符 title_y/hide_deco/hide_footer/key_intercept）同日落地

 ## 五、设计决策与考量（为什么这样做）

@@ -258,3 +258,5 @@ ENTER/→ 进子框：
 | 2026-09-09 | 菜单显示层 flat 样式同法转常量样式（§5.6）：LVGL 池基线 4872→4784 B、最深四级级联 6128→6040 B（x64 省 88 B，MCU 同量级）；`LV_STYLE_CONST_INIT` 生成外部链接符号，内容页同名者改名 `cp_style_flat` 避免两文件冲突 |
 | 2026-09-09 | 内容页多页面架构定稿（`内容页架构.md`）：框架+页面插件模型（每页一文件 `ui_page_xxx` + 4 个扩展钩子）、30 个待实现叶子页清单、新增页面六步流程；同日"浅 V"装饰提取为共享 `ui_deco` 模块（架构第一步，菜单根框/内容页共用，像素回归验证一致） |
 | 2026-09-09 | 内容页拆分执行（`内容页架构.md` §九 变更记录）：`ui_content_page` 提纯为纯框架（描述符表 + NULL 防护 + 描述符驱动绘制/按键、4 个扩展钩子）；三页数据拆出 `ui_page_device_info` / `ui_page_ac` / `ui_page_dc`（extern const 描述符对象）；双端注册；Keil 0 错 0 警 + 模拟器 0 警告 + `ui-verify` 五门禁全绿（像素一致、池 4784/4864 B 不变） |
+| 2026-09-09 | 用户密钥密码页落地（首个表单/操作页，§4.7 / `内容页架构.md` §4.1）：框架描述符新增 title_y/hide_deco/hide_footer/key_intercept + 新 API `ui_content_page_invalidate`；新模块 `ui_page_password`（3 数字框反显光标 + arm API）；菜单受保护叶子路由（arm→开密码页，确认一致后回调**先关页再续做进入动作**）；字体 97→102 汉字（198 字形）；双端注册；回归扩至 7 页 + 往返水位，五门禁全绿 |
+| 2026-09-10 | 网口设置内容页（§4.7 / `内容页架构.md`）：新增 `Drivers/BSP/NETCFG`（Flash 持久化 + CRC-16，工厂默认 192.168.1.100/24）+ 页面插件 `ui_page_net_cfg`（5 行动态值 + 可编辑：↑↓调字节/←→移光标/ENTER 确认，保存行 ENTER → `net_cfg_save` 下次上电生效）；框架新增钩子 `init_cb` + API `ui_content_page_selected_row`；`net_init` 增 `mac` 参数、netTask 等 `SYS_EVT_STORAGE_READY` → `net_cfg_load` → `net_init(ip,mask,gw,mac)` → 回写实际 MAC 影子；字体 102→111 字符（208 字形，修复低码位符号丢失）；双端注册；回归扩至 11 页，五门禁全绿 |
@@ -11,13 +11,15 @@
 ## 一、什么是内容页

 菜单**叶子节点** ENTER 后进入的**独立全屏页面**：新建一块 LVGL 屏幕，全部内容（装饰 + 标题 + 行 + 页脚）
-由框架一次性自绘（**无子对象**），ESC 返回菜单屏。当前已接 3 页：
+由框架一次性自绘（**无子对象**），ESC 返回菜单屏。当前已接 5 页：

 | 页面 | 菜单节点 | 形态 | 数据 | 描述符对象 |
 |---|---|---|---|---|
 | 装置信息 | node 1 | 静态信息页（6 行 + 副标题，不分页） | Flash 表 | `ui_page_device_info_desc` |
 | 交流量 | node 3 | 列表页（24 项，8 项/页，共 3 页） | Flash 表（第 1 页实测，2/3 页占位） | `ui_page_ac_desc` |
 | 直流量 | node 4 | 列表页（3 项，单页） | Flash 表 | `ui_page_dc_desc` |
+| 网口设置 | node 30（通讯参数子项） | 列表页（5 行 1 页，动态值）+ 可编辑（`edit_capable`，↑↓调字节/←→移光标/ENTER 确认；保存行 ENTER → 写 Flash，下次上电生效） | `net_cfg` RAM 副本（netTask 上电自 Flash 加载） | `ui_page_net_cfg_desc` |
+| 用户密钥 | 需密码叶子（如 node 8 参数） | 表单/操作页（draw_cb + key_cb；无行、无"浅 V"、无页脚） | arm 装载：完成回调（携授予权限）；页面比对两个编译期密码 | `ui_page_password_desc` |

 设计核心是 **"框架 + 页面插件"**：框架 `ui_content_page` 只持**机制**（屏/容器生命周期、焦点、
 按键分发、通用绘制），每页的**数据/几何/钩子**由独立 `ui_page_xxx` 模块经描述符 `content_page_def_t`
@@ -36,7 +38,7 @@ flowchart TD
        L3["通用绘制（LV_EVENT_DRAW_MAIN）<br/>浅 V → 标题/副标题 → 行 → 选中带 → 页脚 → draw_cb"]
    end

-    M -- "ENTER：ui_content_page_open(id)" --> S
+    M -- "ENTER：ui_content_page_open(id, perm)" --> S
    S -- "描述符驱动" --> L1
    S -- "描述符驱动" --> L2
    S -- "描述符驱动" --> L3
@@ -46,12 +48,14 @@ flowchart TD
        P1["ui_page_device_info<br/>装置信息（静态信息页）"]
        P2["ui_page_ac<br/>交流量（列表页）"]
        P3["ui_page_dc<br/>直流量（列表页）"]
+        P4["ui_page_password<br/>用户密钥（表单/操作页）"]
        PN["ui_page_xxx<br/>扩展点：每新增页一文件"]
    end

    P1 -- "const 描述符（Flash）" --> S
    P2 -- "const 描述符（Flash）" --> S
    P3 -- "const 描述符（Flash）" --> S
+    P4 -- "const 描述符（Flash）" --> S
    PN -- "const 描述符（Flash）" --> S

    L3 -- "ui_deco_draw" --> D["ui_deco（共享）<br/>顶部“浅 V”装饰"]
@@ -70,12 +74,14 @@ flowchart TD

 | 文件 | 角色 | 一句话职责 |
 |---|---|---|
-| `ui_content_page.c/h` | **框架** | 屏/容器生命周期 + 按键分发 + 描述符驱动通用绘制 + 描述符表；公开 `content_page_id_t` / `content_page_def_t` / `cp_row_t` 与 3 个 API |
+| `ui_content_page.c/h` | **框架** | 屏/容器生命周期 + 按键分发 + 描述符驱动通用绘制 + 描述符表；公开 `content_page_id_t` / `content_page_def_t` / `cp_row_t` 与 4 个 API |
 | `ui_page_device_info.c/h` | 页面插件 | 装置信息页：6 行 Flash 表 + 描述符对象 `ui_page_device_info_desc` |
 | `ui_page_ac.c/h` | 页面插件 | 交流量页：24 行 Flash 表 + 描述符对象 `ui_page_ac_desc` |
 | `ui_page_dc.c/h` | 页面插件 | 直流量页：3 行 Flash 表 + 描述符对象 `ui_page_dc_desc` |
+| `ui_page_password.c/h` | 页面插件 | 用户密钥页：3 数字框自绘（draw_cb）+ ↑↓/←→/ENTER 键处理（key_cb）+ arm API + 描述符对象 `ui_page_password_desc` |
+| `ui_page_net_cfg.c/h` | 页面插件 | 网口设置页：5 行（IP/掩码/网关/MAC + 保存）动态值 + 可编辑（draw_cb 反显活动字节 + key_cb 调字节/移光标/保存）+ `init_cb` 重置运行态 + 描述符对象 `ui_page_net_cfg_desc`（数据源 `net_cfg`） |
 | `ui_deco.c/h` | 共享 | 顶部"浅 V"装饰（3 段线 + culling），菜单根框/内容页共用 |
-| `ui_menu.c` | 逻辑层 | `menu_content_page_for` 叶子节点 → 页 ID 映射；ENTER 叶子时调 `ui_content_page_open` |
+| `ui_menu.c` | 逻辑层 | `menu_content_page_for` 叶子节点 → 页 ID 映射；ENTER 普通叶子调 `ui_content_page_open`；受保护叶子先 arm + 开密码页，确认一致后回调**先关页再续做进入动作**（`menu_password_ok`） |
 | `ui_menu_view.c` | 逻辑层依赖 | `ui_content_page_close` 经 `ui_menu_view_container()` 把焦点切回菜单持久容器 |

 依赖方向：`ui_menu（逻辑）→ ui_content_page（框架）→ ui_page_xxx（页面数据）`；
@@ -89,6 +95,7 @@ flowchart TD
 |---|---|---|
 | `bool ui_content_page_open(id)` | 开页 | ① 查 `s_defs[id]`：NULL → 打 `ERROR` 日志并返回 false（枚举/表漂移防护）② `lv_obj_create(NULL)` 建屏 + 全屏容器（flat 常量样式 + `IGNORE_LAYOUT` + `CLICK_FOCUSABLE`）③ 容器**先**入默认输入组并获焦 ⓸ `lv_screen_load` 切屏 |
 | `void ui_content_page_close()` | 关页 | ① 焦点**先**回菜单持久容器（防输入组焦点悬空）② 切回菜单屏（菜单屏对象未动，原样还原）③ 再删容器+屏，池内存回落 |
+| `void ui_content_page_invalidate()` | 整页重绘 | 失效页面容器；供表单/操作页自身状态变化后调用（无页打开时空操作） |
 | `bool ui_content_page_is_open()` | 查询 | `s_open != CONTENT_PAGE_COUNT` |

 框架持有的运行状态（全部 4 个变量，约 20 B）：
@@ -143,6 +150,8 @@ static const content_page_def_t *const s_defs[CONTENT_PAGE_COUNT] = {
    [CONTENT_PAGE_DEVICE_INFO] = &ui_page_device_info_desc,
    [CONTENT_PAGE_AC]          = &ui_page_ac_desc,
    [CONTENT_PAGE_DC]          = &ui_page_dc_desc,
+    [CONTENT_PAGE_PASSWORD]    = &ui_page_password_desc,
+    [CONTENT_PAGE_NET_CFG]     = &ui_page_net_cfg_desc,
 };
 ```

@@ -156,10 +165,13 @@ static const content_page_def_t *const s_defs[CONTENT_PAGE_COUNT] = {

 ```mermaid
 flowchart TD
-    A(["按键（焦点容器 → LV_EVENT_KEY → cp_key_cb）"]) --> B{"ESC / ← ？"}
-    B -- 是 --> C["ui_content_page_close()<br/>关页返回菜单（框架保证，页面钩子不可拦截）"]
-    B -- 否 --> D{"key_cb 钩子非空<br/>且返回 true ？"}
-    D -- 是 --> E["页面已处理（表单/操作页自有键）<br/>框架跳过内置语义"]
+    A(["按键（焦点容器 → LV_EVENT_KEY → cp_key_cb）"]) --> B{"ESC ？"}
+    B -- 是 --> C["ui_content_page_close()<br/>关页返回菜单（框架保证，恒不可拦截）"]
+    B -- 否 --> L{"← ？"}
+    L -- "key_intercept=1 且<br/>key_cb(←) 返回 true" --> E["页面已处理（表单/操作页自有键）<br/>框架跳过内置语义"]
+    L -- "未置标志 / 钩子未处理" --> C
+    L -- 否 --> D{"key_cb 钩子非空<br/>且返回 true ？"}
+    D -- 是 --> E
    D -- 否 --> F{"↑ / ↓ ？"}
    F -- 是 --> G{"selectable=1 且<br/>总行数 > 0 ？"}
    G -- 是 --> H["移选（首尾环绕，跨页连续）<br/>选中行越界 → 重置首行（防动态行数缩小）<br/>lv_obj_invalidate 触发重绘"]
@@ -169,7 +181,8 @@ flowchart TD

 行为细节（与代码一致）：

- **ESC/← 恒返回**：最先判断，`key_cb` 无法拦截（框架保证页面可退出）
+- **ESC 恒返回**：最先判断，`key_cb` 无法拦截（框架保证页面可退出）
+- **← 每页可拦截**：`key_intercept=1` 时 ← **先**交 `key_cb`（true = 页已处理不关页，如密码页光标移动）；未置标志或钩子未处理则照旧关页
 - **key_cb 先于内置 ↑↓**：返回 `true` = 页已处理，框架不再执行内置移选
 - **↑↓ 移选**：`(sel + total ∓ 1) % total` 首尾环绕；`s_sel` 是全局下标，跨页连续
 - **越界防护**：`s_sel >= total` 时先重置首行（为动态行数可能缩小而设；静态页恒不触发）
@@ -179,14 +192,14 @@ flowchart TD

 ```mermaid
 flowchart TD
-    A(["LV_EVENT_DRAW_MAIN → cp_draw_cb"]) --> B["① 浅 V 装饰：ui_deco_draw（共享模块，内置 culling）<br/>② 标题（居中，y=2） ⓢ 副标题（居中，y=subtitle_y；仅非空页）"]
+    A(["LV_EVENT_DRAW_MAIN → cp_draw_cb"]) --> B["① 浅 V 装饰：ui_deco_draw（共享模块，内置 culling；hide_deco=1 跳过）<br/>② 标题（居中，每页 title_y / 默认 CP_TITLE_Y=y2） ⓢ 副标题（居中，y=subtitle_y；仅非空页）"]
    B --> C["④ 行区块<br/>列表页：窗口 = 选中行所在页（首可见行 = (sel/每页数)×每页数）<br/>信息页：全量；行槽位置固定，数据随页切换"]
    C --> C1{"行数据来源"}
    C1 -- "静态：rows 表非空" --> C2["直绘 Flash 表（text_static=1，不拷内存）"]
    C1 -- "动态：refresh 非空" --> C3["refresh() 逐行取入栈缓冲（32 B×2，同帧同步光栅化）"]
    C2 --> D
    C3 --> D["逐行：culling 判交 → 选中行白带（x=2..156，高 band_h）<br/>→ 左/右两列 lv_draw_label（选中黑字，其余白字）"]
-    D --> E["⑤ 页脚“第 X 页，共 Y 页”（y=143，x=6）<br/>列表页：随选中行现算；信息页：fixed_cur/total 固定值"]
+    D -->     E["⑤ 页脚“第 X 页，共 Y 页”（y=143，x=6；hide_footer=1 跳过）<br/>列表页：随选中行现算；信息页：fixed_cur/total 固定值"]
    E --> F{"draw_cb 非空 ？"}
    F -- 是 --> G["⑥ 页面自定义内容（表单/操作页，在内置区块之后）"]
    F -- 否 --> H(["绘制完成"])
@@ -213,7 +226,11 @@ typedef struct {
    const char *title;                          /* 标题（浅 V 区居中） */
    const char *subtitle;                       /* 副标题；NULL = 无（仅信息页有） */
    int32_t  subtitle_y;                        /* 副标题放置 y（仅 subtitle 非空时有效） */
+    int32_t  title_y;                           /* 标题放置 y；0 = 框架默认（CP_TITLE_Y） */
+    uint8_t  hide_deco;                         /* 1 = 不绘"浅 V"装饰（密码页跟随实机） */
+    uint8_t  hide_footer;                       /* 1 = 不绘页脚页码（密码页跟随实机：无页脚） */
    uint8_t  selectable;                        /* 1 = 列表页（↑↓移选+分页）；0 = 信息页（静态行） */
+    uint8_t  key_intercept;                     /* 1 = LV_KEY_LEFT 先交 key_cb（true = 页已处理不关页）；ESC 恒不可拦截 */
    int32_t  top_y;                             /* 首行槽顶 y */
    int32_t  pitch;                             /* 行距（相邻行槽顶间距） */
    int32_t  band_h;                            /* 选中白带高（0 = 无选中带） */
@@ -233,26 +250,29 @@ typedef struct {
 } content_page_def_t;
 ```

-字段一览（含当前 3 页实际值）：
+字段一览（含当前 4 页实际值）：

-| 字段 | 类型 | 作用 | 装置信息 | 交流量 | 直流量 |
-|---|---|---|---|---|---|
-| `title` | `const char *` | 标题（浅 V 区居中） | "装置信息" | "交流量" | "直流量" |
-| `subtitle` | `const char *` | 副标题；NULL = 无 | "馈线自动化终端" | NULL | NULL |
-| `subtitle_y` | `int32_t` | 副标题放置 y | 25 | — | — |
-| `selectable` | `uint8_t` | 1 = 列表页（↑↓+分页）；0 = 信息页 | 0 | 1 | 1 |
-| `top_y` | `int32_t` | 首行槽顶 y | 40 | 24 | 24 |
-| `pitch` | `int32_t` | 行距 | 15 | 14 | 14 |
-| `band_h` | `int32_t` | 选中白带高（0 = 无） | 0 | 13 | 13 |
-| `text_dy` | `int32_t` | 文本垂直偏移 | 0 | 0 | 0 |
-| `left_x` / `right_x` | `int32_t` | 左列（标签/名）/ 右列（值）x | 6 / 86 | 7 / 101 | 7 / 101 |
-| `rows_per_page` | `uint8_t` | 每页行数（0 = 不分页） | 0 | 8 | 8 |
-| `row_count` | `uint16_t` | 总行数（静态页） | 6 | 24 | 3 |
-| `rows` | `const cp_row_t *` | 静态数据表（Flash） | 6 行 | 24 行 | 3 行 |
-| `fixed_cur_page` / `fixed_total_pages` | `uint8_t` | 信息页页脚固定值 | 10 / 1 | — | — |
-| `refresh` / `count_cb` / `draw_cb` / `key_cb` | 函数指针 | 扩展钩子 | 全 NULL | 全 NULL | 全 NULL |
+| 字段 | 类型 | 作用 | 装置信息 | 交流量 | 直流量 | 用户密钥 |
+|---|---|---|---|---|---|---|
+| `title` | `const char *` | 标题（浅 V 区居中） | "装置信息" | "交流量" | "直流量" | "用户密钥" |
+| `subtitle` | `const char *` | 副标题；NULL = 无 | "馈线自动化终端" | NULL | NULL | NULL |
+| `subtitle_y` | `int32_t` | 副标题放置 y | 25 | — | — | — |
+| `title_y` | `int32_t` | 标题放置 y（0 = 框架默认） | 0 | 0 | 0 | 44 |
+| `hide_deco` / `hide_footer` | `uint8_t` | "浅 V" / 页脚开关 | 0 / 0 | 0 / 0 | 0 / 0 | 1 / 1 |
+| `selectable` | `uint8_t` | 1 = 列表页（↑↓+分页）；0 = 信息页 | 0 | 1 | 1 | 0 |
+| `key_intercept` | `uint8_t` | ← 拦截标志（先交 key_cb） | 0 | 0 | 0 | 1 |
+| `top_y` | `int32_t` | 首行槽顶 y | 40 | 24 | 24 | —（无行） |
+| `pitch` | `int32_t` | 行距 | 15 | 14 | 14 | —（无行） |
+| `band_h` | `int32_t` | 选中白带高（0 = 无） | 0 | 13 | 13 | —（无行） |
+| `text_dy` | `int32_t` | 文本垂直偏移 | 0 | 0 | 0 | —（无行） |
+| `left_x` / `right_x` | `int32_t` | 左列（标签/名）/ 右列（值）x | 6 / 86 | 7 / 101 | 7 / 101 | —（无行） |
+| `rows_per_page` | `uint8_t` | 每页行数（0 = 不分页） | 0 | 8 | 8 | 0 |
+| `row_count` | `uint16_t` | 总行数（静态页） | 6 | 24 | 3 | 0 |
+| `rows` | `const cp_row_t *` | 静态数据表（Flash） | 6 行 | 24 行 | 3 行 | NULL |
+| `fixed_cur_page` / `fixed_total_pages` | `uint8_t` | 信息页页脚固定值 | 10 / 1 | — | — | — |
+| `refresh` / `count_cb` / `draw_cb` / `key_cb` | 函数指针 | 扩展钩子 | 全 NULL | 全 NULL | 全 NULL | draw_cb + key_cb（余 NULL） |

-扩展钩子（机制已实现，当前 3 页均未使用）：
+扩展钩子（机制已实现；密码页用 `draw_cb` + `key_cb`，其余 3 页未用）：

 | 钩子 | 签名 | 框架调用时机（uiTask 上下文） | 用途 |
 |---|---|---|---|
@@ -261,7 +281,7 @@ typedef struct {
 | `draw_cb` | `void (lv_layer_t *layer, const lv_area_t *clip)` | 绘制链末尾（内置区块之后） | 表单/操作页自定义内容 |
 | `key_cb` | `bool (lv_key_t key)` | 键分发时（ESC 之后、内置 ↑↓ 之前） | 页面自有键（ENTER 确认等）；返回 true = 页已处理 |

-### 4.1 表单/操作页首个应用：密码页（待实现）
+### 4.1 表单/操作页首个应用：密码页（已落地）

 实机（淮源电力 F30）已有"用户密钥"页：进入某些子叶面前须先输入密码（实机照片见
 `mockups/密码页面实际机器的示例图片.jpg`）。它是本项目**第一个表单/操作页**，落地形态即
@@ -269,15 +289,18 @@ typedef struct {

 **功能规则（已确认）**

- 密码共 **3 位**；子页（叶子）可配置"是否需要密码页"，每个受保护页可设**专属密码**
- 受保护叶子 ENTER：先开密码页；输入与专属密码一致后按确认键进入目标页；ESC 随时返回菜单
+- 密码共 **3 位**；子页（叶子）可配置"是否需要密码页"（行尾 ` #P`）；密码页按所输密码**授权**：
+  查看密码 → 只读权限 / 修改密码 → 修改权限（只有修改权限进入后才能改参数）；
+  密码值为编译期配置（`ui_pwd_def.h`，查看/修改各一个，改值 = 重新编译）
+- 需密码叶子 ENTER：先开密码页；一致后按授予权限进入目标页（页面据此只读/可编辑）；ESC 随时返回菜单
+- 无密码叶子直接进，默认只读权限
 - 键语义（全部由页面 `key_cb` 处理；`selectable=0`，框架内置 ↑↓ 移选不适用）：

 | 键 | 行为 |
 |---|---|
 | ↑ / ↓ | 调整光标位数字值（0–9，环绕：9↔0） |
 | ← / → | 移动光标（反显框）左/右（环绕：首框↔末框） |
-| ENTER | 确认：一致 → 关密码页并打开目标页；不一致 → 3 框清空回 `0`、光标回首框，重输（已确认） |
+| ENTER | 确认：修改密码 → 关密码页并以修改权限打开目标页；查看密码 → 以只读权限打开；不一致 → 3 框清空回 `0`、光标回首框，重输（已确认） |
 | ESC | 返回菜单（框架保证，不可拦截） |

 **实机视觉（照片；✅ 已确认按此实现）**
@@ -296,26 +319,42 @@ typedef struct {
 | `key_cb` | 非空：↑↓ / ←→ / ENTER 按上表 |
 | `title` | "用户密钥"（y≈45 中上、"浅 V"关 —— 跟随实机；需下方 ⚠️ 扩展 2） |

-**⚠️ 框架扩展需求（落地前必须完成）**
+**✅ 框架扩展（已落地，见 §3.4/§3.5）**

-1. **← 键拦截（✅ 已确认：描述符拦截开关）**：当前 `cp_key_cb` 将 `LV_KEY_LEFT` 与 ESC 同等对待：在调用 `key_cb`
-   **之前**即无条件关页返回（ui_content_page.c:345，注释明示"页面钩子不可拦截"）——密码页的光标
-   ←/→ 移动会被框架吞掉。方案：描述符增加拦截标志（如 `uint8_t key_intercept`），置位时 `LV_KEY_LEFT`
-   **先**交 `key_cb`，返回 false 才执行内置返回；`LV_KEY_ESC` **不受**拦截（"页面恒可退出"的框架
-   保证不放松）。现有 3 页不置标志，行为完全不变
-2. **每页标题 y / "浅 V" 开关（✅ 需要，视觉已确认跟随实机）**：绘制链当前固定标题 `CP_TITLE_Y=2`
-   且恒绘"浅 V"；实机密码页无装饰、标题在中上部 → 描述符增加标题 y 与装饰开关字段
+1. **← 键拦截**：描述符 `key_intercept`——置位时 `LV_KEY_LEFT` **先**交 `key_cb`（true = 页已处理不关页），
+   未置标志或钩子未处理则照旧关页；`LV_KEY_ESC` **不受**拦截（"页面恒可退出"的框架保证不放松）。
+   其余 3 页不置标志，行为完全不变
+2. **每页标题 y / "浅 V" / 页脚开关**：描述符 `title_y`（0 = 默认 CP_TITLE_Y）/ `hide_deco` / `hide_footer`；
+   密码页取 title_y=44、双开关置位，跟随实机照片

 **设计确认进度**

 | # | 事项 | 状态 |
 |---|---|---|
 | 1 | 密码不一致行为 | ✅ 已确认：清空重输（3 框回 `0`、光标回首框） |
-| 2 | 每页专属密码的存放与设置 | ✅ 已确认：配置页可设、存 Flash 配置区（配置页本身亦是后续表单/操作页） |
+| 2 | 密码值的存放与设置 | ✅ 已确认（2026-09-09 修订）：仅编译期配置（`ui_pwd_def.h`，查看/修改各一个值，按所输密码授权），不做运行期设置页、不落 Flash（用户定案：密码只编译期写入） |
 | 3 | 视觉风格 | ✅ 已确认：跟随实机照片（无"浅 V"、标题中上）→ 需 ⚠️ 扩展 2 |
 | 4 | ← 键冲突解法 | ✅ 已确认：方案 A 描述符拦截开关（`key_intercept`）；`LV_KEY_LEFT` 先交页面钩子，ESC 恒不可拦截，现有 3 页不置开关、零影响 |
 | 5 | 边界环绕行为 | ✅ 已确认：都环绕（数字 9↔0，光标首框↔末框） |

+**落地要点（与代码一致）**
+
+- **arm API**：`ui_page_password_arm(on_ok)` 由逻辑层在开页前装载完成回调；每次进入重置初始态
+  （全 `0`、光标首框，与实机一致）。页面模块不感知菜单，比对 `ui_pwd_def.h` 两个编译期密码
+  （先查修改：两值同设时授高权），一致时回调以授予的权限（`ui_perm_t`）为实参
+- **权限注入**：开页 `ui_content_page_open(id, perm)` 携授予权限；描述符 `edit_capable` 声明页面
+  支持编辑模式；页面钩子经 `ui_content_page_is_editable()`（= edit_capable 且修改权限）决定
+  只读/可编辑行为
+- **菜单路由**：需密码叶子 ENTER → `arm(menu_password_ok)` + 开 `CONTENT_PAGE_PASSWORD`；
+  密码检查先于内容页判断（带内容页的需密码叶子同样先经密码页）；
+  确认一致时回调（携权限）**先关密码页回菜单屏、再沿未变导航状态续做"进入"动作**（有内容页→
+  开内容页携权限，否则压层进子框）；无密码叶子直接开（默认只读）。
+  先关页是必须的：不关则后续动作落在被盖住的菜单屏上（焦点已移走，按键全错位）；
+  事件内删对象由 LVGL `e->deleted` 机制保证安全（与 ESC 路径同模式）
+- **几何**：标题 y=44；3 个 14×14 数字框、间距 6px、行顶 y=78、首框左 x=53（整组居中）；光标框反显
+- **回归**：`check_content_pages.py` 含密码页 4 状态（初始 / 输 1 位 / 正确确认进菜单 / 不一致清空），
+  pwk 终态经像素级几何断言验证为"4 框菜单 + sel=[2,0,0] + 终点空框"
+
 ## 五、页面模块（ui_page_xxx）

 每页一个 `.c/h` 文件对，只含**数据（Flash）+ 描述符对象**，零 LVGL 对象、零机制代码。
@@ -412,12 +451,12 @@ extern const content_page_def_t ui_page_device_info_desc;   /* 描述符（Flash
 ## 八、验证与回归

 - **门禁**（`ui-verify` skill / `UI_自动化测试流程.md`）：
-  0) 模拟器构建 0 警告 → 1) 菜单 8 状态像素回归 + 池基线 → 2) 3 内容页黄金参考逐字节比对
-  + 开页-关页往返水位 → 3) Keil 构建 0 错 0 警 → 4) 代码规范检查
+   0) 模拟器构建 0 警告 → 1) 菜单 8 状态像素回归 + 池基线 → 2) 内容页文本断言 + 11 页黄金参考逐字节比对
+   （网口设置 4 态 + 密码页 4 态等）+ 开页-关页往返水位 → 3) Keil 构建 0 错 0 警 → 4) 代码规范检查
 - **门禁常量**（脚本头部）：`MENU_POOL_BASELINE = 4784 B`、`POOL_AFTER_ROUNDTRIP = 4864 B`
 - **失败处置**：像素不一致 = 代码 bug（修代码，**禁止**刷参考掩盖）；**有意**改视觉 →
-  先肉眼确认新效果正确，再 `check_content_pages.py --update` 刷参考并随代码提交
- 新增页面后同步在 `check_content_pages.py` 增加该页的按键序列与参考图
+  先肉眼确认新效果正确，再 `check_content_pages.py --update` 刷参考（`ref/` 为本地生成物、不入库）
+- 新增页面后同步在 `check_content_pages.py` 增加该页的按键序列、文本断言与参考图

 ## 九、变更记录

@@ -431,3 +470,6 @@ extern const content_page_def_t ui_page_device_info_desc;   /* 描述符（Flash
 | 2026-09-09 | 密码页设计确认 3 项（§4.1）：不一致 = 清空重输；每页专属密码 = 配置页可设 + 存 Flash 配置区；视觉 = 跟随实机照片（由此确定绘制链扩展需求：每页标题 y / "浅 V" 开关）；← 键拦截方案与环绕行为仍待确认 |
 | 2026-09-09 | 密码页 ← 键冲突解法确认（§4.1）：方案 A 描述符拦截开关（`key_intercept`：`LV_KEY_LEFT` 先交页面钩子、ESC 恒不可拦截、现有 3 页零影响）；框架扩展清单定稿（拦截标志 + 每页标题 y / "浅 V" 开关），仅剩环绕行为待确认 |
 | 2026-09-09 | 密码页设计定稿（§4.1）：边界行为 = 都环绕（数字 9↔0、光标首框↔末框）；5 项设计全部确认、无遗留待确认——具备实施条件（框架扩展 + 新页面模块 + 每页保护标志/密码） |
+| 2026-09-09 | 密码页落地（§4.1）：框架描述符新增 title_y/hide_deco/hide_footer/key_intercept + 新 API `ui_content_page_invalidate`；新模块 `ui_page_password`（3 数字框反显光标 + arm API，draw_cb+key_cb）；菜单受保护叶子路由（arm→开密码页，确认一致后 `menu_password_ok` **先关页再续做进入动作**）；字体 97→102 汉字（198 字形）；双端注册；回归扩至 7 页 + 往返水位，五门禁全绿 |
+| 2026-09-09 | 权限模型（替代"每页专属密码"，§4.1）：表行尾注记 ` #P`（需密码，无类别）；`ui_pwd_def.h` 两个编译期密码（查看 000 / 修改 123）+ 新 `ui_perm_t` 权限枚举——密码页输查看密码授只读权限、输修改密码授修改权限（只有修改权限进入后才能改参数）；生成器同步改造并重新生成（pwd 列 = 0/1 布尔，`ui_menu_tab_has_pwd`）；框架 `ui_content_page_open(id, perm)` 携授予权限 + 描述符 `edit_capable` + 新 API `ui_content_page_is_editable`（页面钩子据以判只读/可编辑）；路由密码检查提到内容页判断之前（修复带内容页需密码叶子绕过密码的路由缺口）；无密码叶子直接进、默认只读。§4.1 功能规则/待确认表/落地要点同步。验证：五门禁全绿（菜单 8 态 + 7 页像素一致、池 4784/4864 B 不变、Keil 0 错 0 警、代码规范 PASS） |
+| 2026-09-10 | 网口设置内容页：新增 `Drivers/BSP/NETCFG/`（Flash 持久化 magic 'NCFG'+CRC-16/MODBUS，工厂默认 192.168.1.100/24、gw .1、MAC 全零=芯片内置）+ 页面插件 `ui_page_net_cfg`（5 行动态值 + 可编辑：↑↓调字节 0..255 环绕 / ←→移光标 / ENTER 确认，保存行 ENTER → `net_cfg_save` 下次上电生效）；框架新增描述符钩子 `init_cb`（开页重置运行态）+ API `ui_content_page_selected_row`；`net_init` 增 `mac` 参数、netTask 改为等 `SYS_EVT_STORAGE_READY` → `net_cfg_load` → `net_init(ip,mask,gw,mac)` → 回写实际 MAC 影子；模拟器 main 调 `net_cfg_load` 使参考图显示工厂默认值；字体修复：lv_font_conv 丢弃低码位符号（U+FF0C 全角逗号 < 0x4E2D 范围起点 → 页脚逗号长期空白）改由 `merge_extra_symbols()` 补回 + 原本缺字（存/密/户/本/用/钥）→ 111 字 / 208 字形；回归扩至 11 页（网口设置 4 态：可编辑/只读/编辑光标反显/保存 OK），五门禁全绿 |
@@ -407,7 +407,9 @@ python tools/menu_gen/gen_menu.py
 ### 3.7 改菜单流程

 ```text
-1. 编辑 ui_menu_tree.txt        —— 缩进即层级（每级 2 空格），# 为注释；增/删/改名/换序条目都只改这里
+1. 编辑 ui_menu_tree.txt        —— 缩进即层级（每级 2 空格），# 为注释；增/删/改名/换序条目都只改这里；
+                                    行尾可选 ` #P` = 该叶子需密码（密码页按所输密码授权查看/修改权限，
+                                    密码值在 Drivers/BSP/UI/ui_pwd_def.h 编译期配置）
 2. python tools/menu_gen/gen_menu.py   —— 重跑生成器：表 / UI_MENU_TAB_COUNT / 8 位护栏 全部同步更新
 3. 完成：导航(逻辑层)与渲染(显示层)代码零改动
 ```
@@ -418,7 +420,7 @@ python tools/menu_gen/gen_menu.py

 | 符号 | 定义处 | 内容 | 占用 |
 |---|---|---|---|
-| `ui_menu_node_t` | `ui_menu_tab.h` | `{ uint8_t parent; const char *name; }` | 类型定义 |
+| `ui_menu_node_t` | `ui_menu_tab.h` | `{ uint8_t parent; uint8_t pwd; const char *name; }`（32 位 8 B/项） | 类型定义 |
 | `g_menu_tab[UI_MENU_TAB_COUNT]` | `ui_menu_tab.c`（生成） | 42 节点扁平父子表 | ≈ 42×8 B ≈ 336 B |
 | 名字字面量 | 同上 | 42 个 `const char[]` | ≈ 400 B |
 | `UI_MENU_TAB_COUNT` / `MENU_ROOT` | `ui_menu_tab.h` | 节点数 42 / 根哨兵 0xFF（8 位，上限 255 项） | 宏 |
@@ -798,7 +800,7 @@ ESC/LEFT : d>0 → menu_back()                            （根框 d=0 不响

 ## 九、内容页（ui_content_page）

-> **一句话职责**：菜单叶子节点进入后的**独立全屏页面**——装置信息（node 1）、交流量（node 3）、直流量（node 4）。与级联框同屏互斥，按需建毁。
+> **一句话职责**：菜单叶子节点进入后的**独立全屏页面**——装置信息（node 1）、交流量（node 3）、直流量（node 4）、用户密钥密码页（受保护叶子，表单/操作页）。与级联框同屏互斥，按需建毁。
 > **文件**：`Drivers/BSP/UI/ui_content_page.c/h`（MCU / PC 模拟器双端共用，注册见 `UI_设计架构.md` §1.2/§1.4 约束 5）。

 ### 9.1 对象树与生命周期
@@ -831,6 +833,7 @@ screen_menu                            screen_page = lv_obj_create(NULL)
 | 页脚（y=143，x=6） | 固定"第 10 页，共 1 页"（按参考图原样） | 动态"第 X 页，共 3 页" | 动态"第 1 页，共 1 页" |

 - 标题 y=2（居中，浅 V 装饰区内；装饰几何与菜单根框一致：两腿 3px / 水平线 2px）
+- **用户密钥页**（表单/操作页，无行槽）：title_y=44、"浅 V"/页脚关（hide_deco/hide_footer）、key_intercept=1；自绘 3 个 14×14 数字框（间距 6px、行顶 y=78、首框左 x=53）+ 反显光标，详见 `内容页架构.md` §4.1
 - 列表页窗口 = 选中行所在页（首可见行 = `(sel/每页数)×每页数`），行槽位置固定、数据随页切换
 - 数据表为 Flash `const cp_row_t[]`（名+值字面量，不 strdup）；交流量第 2/3 页当前为占位数据

@@ -839,17 +842,19 @@ screen_menu                            screen_page = lv_obj_create(NULL)
 | 键 | 行为 |
 |---|---|
 | ↑ / ↓ | 列表页移选（**首尾环绕、跨页连续**），窗口随页切换后重绘；信息页不响应 |
-| ESC / ← | 关页返回菜单（导航状态原样还原） |
+| ESC | 关页返回菜单（导航状态原样还原；恒不可拦截） |
+| ← | `key_intercept=1` 时先交页面 key_cb（true = 已处理不关页，如密码页移光标）；未置标志或未处理 → 照旧关页返回 |

 ### 9.4 公开 API

 ```c
 bool ui_content_page_open(content_page_id_t id);   /* 开页：建屏+切屏+焦点置页面容器；ID 无效/已有页打开 → false */
 void ui_content_page_close(void);                  /* 关页：焦点回菜单容器 + 切回菜单屏 + 销毁页面 */
+void ui_content_page_invalidate(void);             /* 整页重绘（表单/操作页自身状态变化后调用） */
 bool ui_content_page_is_open(void);                /* 查询是否有内容页打开 */
 ```

- 节点→页映射在逻辑层 `ui_menu.c`（`menu_content_page_for(node)`）：node 1 → `CONTENT_PAGE_DEVICE_INFO`、3 → `AC`、4 → `DC`；其余叶子无内容页（进空白终点框）
+- 节点→页映射在逻辑层 `ui_menu.c`（`menu_content_page_for(node)`）：node 1 → `CONTENT_PAGE_DEVICE_INFO`、3 → `AC`、4 → `DC`；其余叶子无内容页（进空白终点框）。需密码叶子（行尾 ` #P`，如 node 8 参数；密码检查先于内容页判断，带内容页的需密码叶子同样先经密码页）先 arm + 开 `CONTENT_PAGE_PASSWORD`，确认一致后回调（携授予权限） **先关页再续做进入动作**（有内容页→开内容页携权限，页面经 `ui_content_page_is_editable()` 判只读/可编辑）；无密码叶子直接开（默认只读）

 ### 9.5 内存预算（模拟器 x64 实测，40 KB 池）

@@ -899,4 +904,6 @@ bool ui_content_page_is_open(void);                /* 查询是否有内容页
 | 2026-09-08 | **行对象 → 自绘重写（方案1，省 LVGL 池"每行对象机制税"）**：行不再是 LVGL 对象——行数据改 `s_row_node[4][16]`（`uint8_t` 节点下标，256 B→64 B），框体 `LV_EVENT_DRAW_MAIN` 自绘（选中行白带 `lv_draw_rect` + 每行 `lv_draw_label` 文本/箭头，按滚动偏移枚举可见行、重绘区外行 culling）；框内滚动改 `LV_EVENT_GET_SELF_SIZE` 虚报内容高 + 手动跟随滚动（`view_scroll_to_sel`，替代 `lv_obj_scroll_to_view`）；删 `s_style_selected`、`view_add_row` 与 flex 堆行；`frame_build/destroy/refresh` 改行数据注册/清空/重绘。§5.4/§5.6/§6.2/§7.1~7.5 同步。验证：`@build` 0 错 0 警 + 代码规范 PASS + 模拟器 8 状态像素回归（白带/边框/根框不变性 + 3 组往返态逐像素一致）全 PASS |
 | 2026-09-08 | **4 层容器→单一持久容器 + 根框装饰/状态行自绘（RAM 收敛）**：焦点/键唯一入口 = 持久容器（框深度由逻辑层 `s_depth` 决定，键回调去掉 `user_data=depth`，`container`/`focus` 接口去参）；根框装饰（浅 V）与状态行改容器 `DRAW_MAIN` 自绘（3 段 `lv_draw_line` + 1 行 `lv_draw_label`，删 3 `lv_line` + 1 label + 3 容器对象）；静态显示层 ~0.5→~0.4 KB。验证：`@build` 0 错 0 警 + 代码规范 PASS + 模拟器 8 状态像素回归全 PASS（装饰/状态行像素级一致）；LVGL 池实测 根框 7168→4872 B、最深四级级联 8488→6128 B（省 ~2.3 KB） |
 | 2026-09-09 | **新增 §九"内容页（ui_content_page）"**：装置信息/交流量/直流量三叶子页落地（独立屏按需建毁 + 行自绘，几何实测自参考图 10/20/21）；节点→页映射入逻辑层 `menu_content_page_for`（node 1/3/4），§2.1 叶子行为同步；flat 样式改常量样式（`LV_STYLE_CONST_INIT` 零池分配，动态常驻样式 x64 实测 88 B/个永久占用）；关页后一次性残留 +80 B 分解入 §9.5（screens 数组高水位 +8、`lv_screen_load` 菜单屏局部 X/Y 样式 +72，均 LVGL 核心行为非泄漏）。验证：`@build` 0 错 0 警 + 代码规范 PASS + 模拟器三页对照参考图几何一致 + 菜单 8 状态像素回归全 PASS |
+| 2026-09-09 | 用户密钥密码页落地（首个表单/操作页，§九 / `内容页架构.md` §4.1）：框架描述符新增 title_y/hide_deco/hide_footer/key_intercept + 新 API `ui_content_page_invalidate`；受保护叶子路由（arm→开密码页，确认一致后回调**先关页再续做进入动作**）；§9.2/§9.3/§9.4 同步。验证：回归扩至 7 页 + 往返水位全 PASS、五门禁全绿 |
 | 2026-09-09 | 菜单显示层 flat 样式同法转常量样式（§5.6/§7.5/§9.5）：LVGL 池基线 4872→4784 B、最深四级级联 6128→6040 B、内容页峰值 5648~6064→5560~5976 B（x64 省 88 B）；`LV_STYLE_CONST_INIT` 生成外部链接符号，内容页同名者改名 `cp_style_flat`。验证：`@build` 0 错 0 警 + 代码规范 PASS + 菜单 8 状态像素回归全 PASS + 三页几何不变 |
+| 2026-09-09 | 权限模型（§3.7/§3.8/§9.4 同步）：菜单表行尾注记 ` #P`（需密码）；`g_menu_tab` pwd 列改 0/1 布尔（API `ui_menu_tab_has_pwd`，表项仍 8 B/项）；两个编译期密码（查看 000 / 修改 123）+ `ui_perm_t` 权限枚举在 `ui_pwd_def.h`（用户定案：密码仅编译期写入，不落 Flash、无运行期设置页）——密码页输查看密码授只读权限、输修改密码授修改权限（只有修改权限进入后才能改参数）；逻辑层密码检查提前到内容页判断之前（带内容页的需密码叶子同样先经密码页，修复路由缺口）；无密码叶子直接进、默认只读。验证：五门禁全绿（菜单 8 态 + 内容页 7 页像素一致、池 4784/4864 B 不变、Keil 0 错 0 警、代码规范 PASS） |
@@ -264,6 +264,8 @@ ISR 余量：该任务运行期间可能被中断打断的最深中断链（SPI/

 `lftpd_io.c:44,49,54` 的 `malloc` / 对应 `free` 与 `:189` 的 `malloc(sizeof(DIR))` 改为 `pvPortMalloc` / `vPortFree`（加 `#include "FreeRTOS.h"`）。消除"512B C 堆"地雷，FTP 长路径不再随机失败。

+> ✅ **2026-09-10 已落地**：`lftpd_io.c`（3 处 `malloc` + 3 处 `free`）与 `lftpd.c`（7 处 `free`，释放 `lftpd_io_canonicalize_path` 返回的堆指针）全部改用 `pvPortMalloc`/`vPortFree`；两文件加 `#include "FreeRTOS.h"`。lftpd 不参与模拟器构建，仅 MCU 端。Keil 重建 0 错 0 警。
+
 #### 2.2 缩减 configTOTAL_HEAP_SIZE

 阶段 1 完成后复测：堆内需容纳 ≈ 栈(15KB) + TCB(2.3KB) + 队列/事件组(0.5KB) + lftpd 临时分配(1KB) + 余量。`configTOTAL_HEAP_SIZE` 49152 → **32768**，要求全功能负载下 `heap free ≥ 8KB` 持续成立（浸泡 1 小时验证）。