docs: 状态栏正确闭环 + 主题增强 §8.1 设计定案(agent-140/138)

- FRAMEWORK_DESIGN §10.2: 同一个状态栏=系统进程(launcher)统一渲染+App前台覆盖叠加(复用fb)+App进程不渲染(§6.1③)+数据源唯一→显示一致
- MEOW_APP_SDK §3.1: SDK全局状态栏仅系统进程渲染; 右侧=MD3图标+变量值(复用sb_icons.h/SB_I_*)+顶级主题(ui.style)切换换图标集; 文本式statusbar_right_str退役/图标化
- §8.1 主题增强: ui.style(MD3/MIUIx)×display.theme(dark/light)定义配色/背景; display.background=style×mode下选项集+全局源+深浅成对; meow_ui_set_style/theme_get 接口; 两套风格参数; 状态栏图标随ui.style换集
- SYSTEM_SETTINGS: 三键语义(style/theme/background)更新
- 开放点(App前台SIGSTOP/App inset/MIUIx图标占位/meow_ui_set_statusbar公开性) 标"实现期定"

SYSTEM_SETTINGS.md

@@ -19,11 +19,11 @@
 | | `display.screen_off_timeout` | int 秒 | 30 | 息屏时长（0=常亮） |
 | | `display.refresh_rate` | enum | `60` | 刷新率上限三档 `60`/`30`/`15`（默认 60，不逼 62Hz 瓶颈） |
 | | `display.refresh_always_max` | bool | false | 始终最大刷新率（=60 且不自动降档）；关=允许自适应降档(60→30→15) |
-| | `display.theme` | enum | `dark` | `dark`/`light`（MD3 深浅；manual 模式下 s_ui_theme 直读它） |
+| | `display.theme` | enum | `dark` | `dark`/`light`（该顶级主题 style 下的**明暗**；manual 模式下 s_ui_theme 直读它；**切明暗→同 style 浅/深背景自动切换**，见 MEOW_APP_SDK §8.1） |
 | | `display.theme_mode` | enum | `manual` | 主题判定方式：`manual`（=读 `display.theme`）/`auto`（按深色时段）。**B2b 新增** |
 | | `display.theme_dark_start` | int 分钟 0-1439 | `0` | 深色时段开始（如 19:00=1140）；`start==end` 视为未配置 → auto 回退 manual。**B2b 新增** |
 | | `display.theme_dark_end` | int 分钟 0-1439 | `0` | 深色时段结束（如 07:00=420）；`start>end`=跨午夜。**B2b 新增** |
-| | `display.background` | path/color | `black` | `black` 或图片路径（`MeowAPPs/backgrounds/xx.png`） |
+| | `display.background` | enum/图片 | `black` | **由「当前 style × 当前 mode」决定的背景底选项集**（非独立全局维度；可选集+默认随 style/mode 一起变）：**MD3×dark**=黑/深蓝/墨绿（默认黑）、**MD3×light**=白/浅蓝/浅绿（默认白）、**MIUIx×dark/light**各一套（草案）。每种配色定义**深/浅两套 surface/bg**，随 `display.theme` 切换（修复"背景仅对主页生效/仅深蓝/浅色不搭"）。亦可为图片路径 `MeowAPPs/backgrounds/xx.png`（图片本身即观感，深浅作用于文字/角色色，待定案）。见 MEOW_APP_SDK §8.1 |
 | **电源** | `power.longpress_menu_ms` | int | 3000 | 长按电源弹电源菜单阈值 |
 | | `power.forceoff_ms` | int | 8000 | 长按电源强关阈值 |
 | | `power.defeat_hotkey` | string | `power_voldown` | 切系统/切 MeowOS 热键组合 |
@@ -44,7 +44,7 @@
 | | `font.class_other` | path | *(空=跟全局)* | 多字体：其他字符 所用字体 |
 | | `font.load_full` | int 0/1 | 0 | **加载大字库（M2.5x）**：1=**强制全系统用大字库（`gbk`≈20k 档）**，覆盖 app 未声明/覆盖默认 `font.file`；0=默认小字库（`common`≈4k），仅 app 声明 `fonts:"full"` 才大字库 [源:用户 2026-08-30] |
 | | `font.size.title` / `font.size.body` | int | 28/20 | 标题/正文字号 |
-| | `ui.style` | enum | `md3` | `md3`（Material You）/`miui` |
+| | `ui.style` | enum | `md3` | `md3`（默认，Material You）/`miuix`（MIUIx，**未实现**）——**顶级主题风格族**（定义整套配色风格/控件形态/圆角/间距/描边），对应 SDK `MEOW_STYLE_MD3`/`MEOW_STYLE_MIUIX`（MEOW_APP_SDK §8.1） |
 | **通知** | `notify.center_enabled` | bool | true | 下拉通知中心开关 |
 | | `notify.app_quota` | int | 16 | 每应用通知配额 |
 | | `notify.categories` | int | 4 | 通知类型数上限（每 App，M2.53）[源:审计 2026-08-30]|
@@ -65,6 +65,8 @@
 
 > 新增设置项时：在清单加一行 + 存储 schema + API 常量/枚举 + 实体 UI 控件 + web 面板控件（四端同步）。
 
+> **主题三键语义（2026-08-30 定案，实现权威见 MEOW_APP_SDK §8.1）**：`ui.style`（MD3/MIUIx）=**顶级主题风格族**（定义整套配色/控件形态/圆角/描边）；`display.theme`（dark/light）=该 style 下的**明暗**；`display.background` =**由「当前 style × 当前 mode」决定的背景底选项集**（非独立全局维度，可选集+默认随 style/mode 一起变）。三者关系：**切明暗 → 同 style 浅/深背景自动切换**（修复"浅色不搭"）；**切 style → 整套配色+背景换族**（修复"背景仅对主页生效/只有深色"）——同时把 `display.background` 从"仅 launcher 主页/仅深色"改为"**全局背景源**"（状态栏/未声明背景 App/主页同步；App 显式声明背景则覆盖，App 声明优先）。`meow_ui_theme` 旧字段 `bg/fg/accent/dim` 保留映射到 MD3 语义色（§5.8.4）。**注**：`ui.style` 值域现状 `meow_settings.c g_defs` 为 `"md3,miui"`（label "Material You,MIUI"）；本定案将第二风格命名为 **`miuix`**（对应 `MEOW_STYLE_MIUIX`），实现时把 `g_defs` 的 `miui` 对齐为 `miuix`（待定案——MIUIx 未实现，当前仅 md3 生效）。
+
 ## 2. 统一存储（单一数据源）
 
 - **主持久化位置：板载 `/usr/data/meow/settings.conf`**（UBIFS）。settings.conf 是**小文件**（几十行、<10KB），持久在板载可跨换卡/掉卡保留配置，避免换音乐卡丢失设置。板载仅此小设置文件（日志/字库/媒体等大数据仍留 TF 卡，符合"板载不写大文件"纪律；KB 级设置除外）。