chore: 补入 test_sb_collapse.c(agent-146 全屏状态栏收合宿主测, 此前漏入库) + docs 字体档位定案锚点(→FONT_SYSTEM.md)

docs/MEOWOS_SPEC_REF.md

@@ -176,7 +176,7 @@
   - **preset 动态化（两级扫描）**：启动/进设置页扫描一次 `MeowOS/fonts/<family>/<weight>/`，重建「字体文件」下拉（默认字体 + ≤16 套卡内 <family>/<weight>；上限防爆）。扫描仅此二时机，勿放热路径。**存量卡片迁移**：旧版扫 `MeowOS/fonts/<family>/`（图片直接在该层）；迁移到 `<family>/regular/` 后，旧 `<family>/` 下不再有三件套 → 新扫默认按两级找，故若未重做成 `<family>/<weight>/` 则扫不到（需先用 mv 迁成 `<family>/<weight>/` 再重扫）。
   - **MeowPanel 预留**：`meow_font_import_zip()`/`meow_font_export_zip()` 为 TODO 声明（不实现），供 MeowPanel 后续接入（`.zip` 导入校验→解压到 `MeowOS/fonts/<family>/<weight>/`、导出打包）。
   - **多字体（M2.5x，`display.multi_font`）**：按字符类别（CJK/CJK_SYM/NUM/LATIN/LATIN_SYM/OTHER）逐字符路由，每类可各选一套字库（`font.class_*`，默认空=跟随全局 `font.file`）；同 family 去重、同时装载不同字体 ≤4 套（超出 WARN「过多不同字体会增内存」并截断）；开关关 = 单字体（现状）。详见 §5.7.7「多字体」。
-  - **字体档位 / 大字库（M2.5x，本次实现）**：抽象出**字库大小档位**，让系统/应用/设置页都知道选的是多大字库 `[源:用户 2026-08-30]`。
+  - **字体档位 / 大字库（M2.5x，本次实现）**：抽象出**字库大小档位**，让系统/应用/设置页都知道选的是多大字库 `[源:用户 2026-08-30]`。**定案见 `devdocs/plan/FONT_SYSTEM.md`**（字体系统定案：三级目录 `<family>/<weight>/<tier>/`、`font.json` 增 `tier`/`languages`/`label`、`charset` 改指编码、按语言选字体；本小节以下为旧口径）。
     - 档位枚举：`MEOW_FONT_TIER_COMMON`（**默认 / ≈4k** 码位）/ `MEOW_FONT_TIER_GBK`（**大 / ≈20k+**）/ `MEOW_FONT_TIER_FULL`（**全 / 可选**，码位/体积最大）。
     - `font/gen/gen_font.py` `--charset common|gbk|full [--weight <name>]` 按档生成 `font.png/font.idx/font.json`（**已实现**，现行仅 `--extra` 思路升级为**档位选择**；M2.6 加 `--weight` 写 `font.json.weight`，缺省 `regular`）；每个 `MeowOS/fonts/<family>/<weight>/font.json` 标 `weight`+`charset` + `glyph_count`（覆盖声明/信息用，launcher/settings 据此标注与按需装载）。
     - **默认用小字库（`common`≈4k）**；仅当 app 声明需大字库（`app.json "fonts":"full"` 或档位）才为该 app 加载大字库（`gbk`≈20k+），见 §5.7.8。

patch_v2/sdk/test_sb_collapse.c

@@ -0,0 +1,124 @@
+/* test_sb_collapse.c — 宿主验证「全屏状态栏收合」纯逻辑（agent-146，不依赖 /dev/fb0/字库）：
+ *   1. 顶条模式上报：App 进程（system_mode=0）set_collapsed/set_fullscreen → 写 /tmp/meowapp_sbar
+ *      （'0'展开/'1'收合/'2'隐藏），供 launcher 感知 App 运行时全屏/收合态。
+ *   2. 热区保留判定：状态栏激活（含收合）时 meow_ui_statusbar_hotzone()==MUI_SBAR_H(28)（收合≠禁热区，
+ *      渲染与热区事件分离）；仅全屏隐藏(inset0)时缩到 MEOW_SBAR_HOTZONE_FS(4)。
+ *   3. 收合状态机：system_mode=1 + animate(200) + set_collapsed(1) → animating()==1，
+ *      collapse_offset() 随时间推进 → 28（收合出屏）；set_collapsed(0) → offset 回 0（恢复）。
+ *   4. 收合 inset：collapsed → meow_ui_statusbar_height()==MUI_SBAR_COLLAPSE_H(4)。
+ *
+ * 编译（宿主 gcc，链真实 gfx/sys/theme/vol/log + 打桩 font/global）：
+ *   gcc -o test_sb_collapse test_sb_collapse.c test_host_stub.c \
+ *       meow_ui_gfx.c meow_ui_sys.c meow_ui_theme.c meow_ui_vol.c meow_ui_log.c \
+ *       -I. -I../meow_launcherd -DMEOW_UI_HOST_TEST
+ */
+#include "meow_ui.h"
+#include "meow_ui_internal.h"
+#include "meow_ui_sys.h"
+
+#include <stdio.h>
+#include <string.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <fcntl.h>
+#include <assert.h>
+
+#define SBAR_MODE_FILE "/tmp/meowapp_sbar"
+
+static int read_mode(void)
+{
+    int fd = open(SBAR_MODE_FILE, O_RDONLY);
+    if (fd < 0) return -1;
+    char ch[8]; int n = read(fd, ch, sizeof ch - 1);
+    close(fd);
+    if (n <= 0) return -1;
+    return ch[0] == '1' ? 1 : (ch[0] == '2' ? 2 : 0);
+}
+
+int main(void)
+{
+    meow_ui_opts o = { 480, 720 };
+    assert(meow_ui_init(&o) == 0);
+    /* 初始 App 模式（system_mode 默认 0） */
+    assert(meow_ui_sys_render_enabled() == 0);
+
+    /* ---- 1) 顶条模式上报 ---- */
+    meow_ui_set_fullscreen(0); meow_ui_statusbar_set_collapsed(0);
+    assert(read_mode() == 0);                 /* 展开 */
+    meow_ui_statusbar_set_collapsed(1);
+    assert(read_mode() == 1);                 /* 收合 */
+    meow_ui_statusbar_set_collapsed(0);
+    meow_ui_set_fullscreen(1);
+    assert(read_mode() == 2);                 /* 隐藏 */
+    meow_ui_set_fullscreen(0);
+    printf("PASS mode-file: app writes /tmp/meowapp_sbar (0=expanded 1=collapsed 2=hidden)\n");
+
+    /* ---- 2a) 激活（含收合）时热区保留 28 ---- */
+    meow_ui_statusbar_set_collapsed(1);
+    assert(meow_ui_statusbar_collapsed() == 1);
+    assert(meow_ui_statusbar_hotzone() == MUI_SBAR_H);   /* 收合仍监听顶部 28px（渲染与热区分离） */
+    assert(meow_ui_statusbar_height() == MUI_SBAR_COLLAPSE_H);  /* 收合 inset=4（提示线） */
+    assert(meow_ui_sys_statusbar_active() == 1);          /* 收合仍视为状态栏激活 */
+    printf("PASS hotzone-retain: collapsed -> hotzone=%d(28) inset=%d(4) active\n",
+           meow_ui_statusbar_hotzone(), meow_ui_statusbar_height());
+
+    /* ---- 2b) 全屏隐藏（immersive）时热区缩小 ---- */
+    meow_ui_statusbar_set_collapsed(0);
+    meow_ui_set_fullscreen(1);
+    int fs_hot = meow_ui_statusbar_hotzone();
+    assert(fs_hot == MEOW_SBAR_HOTZONE_FS);                /* inset0 → 4 */
+    printf("PASS hotzone-shrink: fullscreen-hidden -> hotzone=%d(fs=4)\n", fs_hot);
+    meow_ui_set_fullscreen(0);
+    meow_ui_statusbar_set_collapsed(0);
+
+    /* ---- 3) 收合状态机（launcher / system_mode=1）---- */
+    meow_ui_sys_set_system_mode(1);
+    assert(meow_ui_sys_render_enabled() == 1);
+    meow_ui_set_refresh_always_max(1);        /* 宿主：绕过帧率门控，逐次 flush 可推进 */
+
+    meow_ui_statusbar_set_collapsed(0);       /* 复位 */
+    meow_ui_set_fullscreen(0);
+    meow_ui_statusbar_animate(200);           /* 上移过渡 200ms */
+    assert(meow_ui_statusbar_animating() == 0);
+    meow_ui_statusbar_set_collapsed(1);       /* 目标收合 */
+    assert(meow_ui_statusbar_animating() == 1);   /* 未到位 → 过渡中 */
+    assert(meow_ui_statusbar_collapse_offset() == 0);
+
+    /* 驱动 present（标顶条左上 1px 唤醒 + 上屏）并让时间流逝，验证 offset 推进 */
+    int off_prev = 0, progressed = 0;
+    for (int i = 0; i < 60; i++) {
+        meow_ui_flush_region(0, 0, 1, 1);
+        usleep(15000);                          /* ~15ms/帧，模拟过渡期高频刷 */
+        int off = meow_ui_statusbar_collapse_offset();
+        if (off > off_prev) progressed = 1;
+        off_prev = off;
+        if (!meow_ui_statusbar_animating()) break;   /* 到 28 稳定 */
+    }
+    assert(progressed == 1);
+    assert(meow_ui_statusbar_collapse_offset() >= MUI_SBAR_H);
+    assert(meow_ui_statusbar_animating() == 0);
+    assert(meow_ui_statusbar_height() == MUI_SBAR_COLLAPSE_H);   /* 收合稳定：inset=4 */
+    printf("PASS collapse-enter: offset 0->%d (animating 1->0)\n",
+           meow_ui_statusbar_collapse_offset());
+
+    /* 退出全屏（恢复）：offset 回 0 */
+    meow_ui_statusbar_set_collapsed(0);
+    assert(meow_ui_statusbar_animating() == 1);
+    int back = 0;
+    for (int i = 0; i < 60; i++) {
+        meow_ui_flush_region(0, 0, 1, 1);
+        usleep(15000);
+        back = meow_ui_statusbar_collapse_offset();
+        if (!meow_ui_statusbar_animating()) break;
+    }
+    assert(back == 0 && meow_ui_statusbar_animating() == 0);
+    assert(meow_ui_statusbar_height() == MUI_SBAR_H);   /* 恢复：inset=28 */
+    printf("PASS collapse-exit: offset ->0 (inset back to 28)\n");
+
+    /* 清理：宿主测试产物 */
+    unlink(SBAR_MODE_FILE);
+
+    printf("ALL PASS\n");
+    meow_ui_shutdown();
+    return 0;
+}