diff --git a/AGENTS.md b/AGENTS.md
index 8b1fd6cc..e1948014 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -90,6 +90,7 @@ STM32F407ZGTx @168MHz（HSE 8MHz → PLL M=4/N=168/P=2）；**仅 Keil MDK-ARM v
 - 测试构建：`test/test_config.h` 的 `TEST_SUITE_CH395F/STORAGE/GD5F/RTC` **互斥**（一次只能启用一个，`#error`）；全部注释 = 产品构建；**破坏性用例默认关闭**：同文件 `ENABLE_DESTRUCTIVE_TESTS`（默认注释）控制写/擦 NAND、格式化、坏块注入与 FatFS 写类用例——关闭时套件为**只读模式**（开机横幅 `mode: READ-ONLY`，可随时在在用设备上跑、不动卷内容与容量），只在**产品首次上电/产线首启**或明确需要时打开（`mode: DESTRUCTIVE`）；2026-09-21 实测一轮破坏性 GD5F 运行即让 dhara 多记一个坏块（容量 95248 → 95200；该计数持久化在 dhara journal checkpoint 头里，普通恢复模式清不掉，需全片擦除——见 `docs/测试说明/存储维护与容量恢复.md`）；CH395F 套件 `test/ch395f_test.h`：硬件层 Phase 1~5 与 NET 层 Phase 6~11 互斥；CH395F 硬件层模式下 netTask（基础线程：无条件创建、全构建唯一实例）入口自挂起（不运行），testTask 独占 CH395F
 - **改驱动前先读对应 `docs/问题记录/*_Trap_Records.md`**（CH395F / GD5F2GQ5UE / SD2506）；各模块测试指南见 `docs/测试说明/`；**存储维护/容量恢复**（全片擦除恢复 dhara 坏块记账）见 `docs/测试说明/存储维护与容量恢复.md`
 - **LVGL I1 绘制缓冲含 palette 头（2026-09-21 实证）**：索引色格式 draw buffer 布局 = `[palette 8B][pixel data stride×h]`（`lv_draw_buf_create` 加 8B、`lv_draw_buf_goto_xy`/`lv_refr get_max_row` 都按此跳/扣），但 `lv_display_set_buffers`/`lv_draw_buf_init` 的容量校验**只看 `stride×h`**——只给 3200B 会被静默接受：末 8 个像素字节写到缓冲外（曾打脏相邻 `s_frame_box[0]` 指针 → HardFault），且 flush 收到的首地址含 palette（整帧错位 8 字节）。`ui_port.c` 按 `stride×h + palette` 供给并在 flush 时 `+palette` 取像素；详见 `docs/UI 设计/UI_设计架构.md` §1.4 第 8 条
+- **MCU 端必须显式应用 dark mono 主题（2026-09-21 实证，远端"纯白屏"根因）**：`lv_display_create()` 会按 `lv_theme_mono_init(disp, false)`（白底黑字）初始化**单例**主题，且 `lv_display_set_theme()` 只把主题重应用到 `screens[0]`（底层）→ **活动屏幕仍是 LVGL 类默认浅灰 `F5F5F5`**；而 UI 内容恒用 `lv_color_white()` 绘制 → 白底白字不可见、远端整帧 99% 为亮（客户端显示纯白）。修法（`ui_port.c`）：`lv_theme_mono_init(disp, true, ...)` + `lv_display_set_theme()` + 对活动屏幕再 `lv_theme_apply()`（实测 `F5F5F5` → `000000`）；同时显式写 I1 调色板头 8B（`[0]=黑 [1]=白`，LVGL 不替调用方初始化）；详见 `docs/UI 设计/UI_设计架构.md` §1.4 第 9 条
 
 ## 串口助手 serial_tool
 
diff --git a/docs/UI 设计/UI_设计架构.md b/docs/UI 设计/UI_设计架构.md
index 146c8683..342a9f55 100644
--- a/docs/UI 设计/UI_设计架构.md	
+++ b/docs/UI 设计/UI_设计架构.md	
@@ -56,6 +56,14 @@ MCU **无物理屏幕**：LVGL 做 160×160 **1bpp 单色离屏渲染**，帧缓
    ① 末 8 个像素字节写到缓冲之外（曾把紧邻 `.bss` 的 `s_frame_box[0]` 指针打脏 → 野指针 HardFault；金丝雀实测越界 n=8）；
    ② flush 回调收到的首地址**含 palette**，照原样整帧拷贝会让推流画面**整体错位 8 字节**。
    故 `ui_port.c` 按 `stride×h + palette` 供给缓冲，上报尺寸含 palette，flush 时 `color_p + UI_DRAW_BUF_PALETTE` 取像素。
+9. **MCU 端必须显式应用 dark mono 主题 + 初始化 I1 调色板（2026-09-21 实证，远端"纯白屏"根因）**：
+   `lv_display_create()` 内部会按 `lv_theme_mono_init(disp, **false**)`（白底黑字）初始化**单例**主题，而
+   `lv_display_set_theme()` 只在屏幕为空时把主题重应用到 `screens[0]`（底层）——**活动屏幕保持 LVGL 类默认浅灰 `F5F5F5`**；
+   UI 内容恒用 `lv_color_white()` 绘制（`ui_standby`/`ui_menu_view`/`ui_deco`/`ui_content_page`）→ 白底白字完全不可见，
+   远端整帧 99% 为亮（客户端显示"纯白"）。修法（`ui_port.c`）：`lv_theme_mono_init(disp, true, ...)` +
+   `lv_display_set_theme()` + 对**活动屏幕**再 `lv_theme_apply()`（实测 `bg_before=F5F5F5` → `bg_after=000000`）。
+   另外 I1 缓冲头 8 B 调色板 LVGL 不替调用方初始化（上电全 0 = 两项透明黑），须显式写 `[0]=黑 [1]=白`；
+   渲染器本身按亮度阈值置位（`lv_draw_sw_blend_to_i1.c`：亮 → 位=1），与客户端"位=1 即亮"的约定一致。
 
 ---