diff --git a/APPS.md b/APPS.md index 58953fa..187a17c 100644 --- a/APPS.md +++ b/APPS.md @@ -162,7 +162,7 @@ **约定（MeowOS 界面 = launcher 主菜单/选单/电源菜单，是唯一允许映射物理键的地方）**： -> ⚠️ **适用范围**：**除了电源键菜单（`show_power_menu`，允许"电源=确认、音量=导航"）以外，所有按键信号由 MeowOS 全局接管**——**任何界面（含 MeowOS 自身的设置页 / 应用列表 / 选单、以及 MeowAPP）都不得私自定义按键行为**。物理键的语义只有一份：电源=息屏/亮屏/长按菜单/8s强关，音量=调系统音量，播放/上下曲=媒体控制（未落地前「抓住」）。任何界面（如系统设置页）**不得**把电源键/播放键映射成"返回/确认"这类自定义行为；界面导航一律走触摸（返回按钮/左缘左滑），按键语义统一由系统判。 +> ⚠️ **适用范围**：**除了电源键菜单（`show_power_menu`，允许"电源=确认、音量=导航"）以外，所有按键信号由 MeowOS 全局接管**——**任何界面（含 MeowOS 自身的设置页 / 应用列表 / 选单、以及 MeowAPP）都不得私自定义按键行为**。物理键的语义只有一份：电源=息屏/亮屏/长按菜单/8s强关，音量=调系统音量，播放/上下曲=媒体控制（**已落地**，M2.81 起路由最近活跃媒体会话；无会话时「抓住」）。任何界面（如系统设置页）**不得**把电源键/播放键映射成"返回/确认"这类自定义行为；界面导航一律走触摸（返回按钮/左缘左滑），按键语义统一由系统判。 | 键 | 系统语义（APP 收到的是语义事件，不是裸 keycode） | |---|---| @@ -459,7 +459,7 @@ Description: A simulated app ### 3.7 音频通路与媒体键（2026-08-31 实测定案，覆盖 §5 旧推论） - **MeowOS 常驻模式（boot 直进，hiby_player 未运行）声卡空闲**：真机实测 `fuser /dev/snd/pcmC0D0p /dev/snd/controlC0` 无任何占用、`pidof hiby_player` 不存在——**MeowAPP 可直接 open `hw:0,0` 出声**（audio.output 设置键即此）；无混音，后开者失败，音频焦点=先占先得（媒体会话/MPRIS 落地后再规范抢占语义）。 - **会话覆盖模式（HibyOS 运行中热键唤起）**：SIGSTOP 冻结播放器，声卡仍被其持有，App 无声（§5 旧结论，仅适用该模式）。 -- **物理媒体键路由**：MeowOS 与 HibyOS 不同时运行，不存在「转发给 hiby」问题；MeowOS 界面下播放/上下曲 = 全局媒体控制，路由给**最近活跃媒体会话**（**媒体会话已落地** M2.81：`MSG_META`(0x72)/`MSG_PLAYCTL`(0x73) + meow_media 最近活跃源（active_seq，30s 超时回收）+ 通知中心媒体卡片 + Now Playing 大页；OS.meow.ncm 是首真实媒体源），无会话时「抓住」不动作。 +- **物理媒体键路由**：MeowOS 与 HibyOS 不同时运行，不存在「转发给 hiby」问题；MeowOS 界面下播放/上下曲 = 全局媒体控制，路由给**最近活跃媒体会话**（**媒体会话已落地** M2.81：`MSG_META`(0x72)/`MSG_PLAYCTL`(0x73) + meow_media 最近活跃源（active_seq，30s 超时回收）+ 通知中心媒体卡片 + Now Playing 大页；**dev.player.ncm**（原 os.meow.ncm，agent-221 改名）是首真实媒体源），无会话时「抓住」不动作。 ### 3.8 版本号规则（2026-08-31 定案，对齐 Android） - `app.json` 增加 **`version_code`**（纯数字，单调递增，**安装/升级比较的唯一依据**）；`version` 仅作显示字符串（versionName 角色，可为 `1.2.3-beta` 等任意形态）。 diff --git a/DEVELOPMENT_PLAN.md b/DEVELOPMENT_PLAN.md index cfffb56..79e80b0 100644 --- a/DEVELOPMENT_PLAN.md +++ b/DEVELOPMENT_PLAN.md @@ -2,14 +2,14 @@ > 目标：把 R3 Pro II 打造成可扩展的"第二系统"。**MeowOS 作为主控层优先启动、拥有屏幕与输入；HibyOS 播放器降级为 MeowOS 启动的一个内置系统应用**（Android home/launcher 模型）。MeowLauncher（即 MeowOS 核心）、MeowAPPs、MeowPanel 均为其组成部分。 > 本文档是路线图与分阶段计划。当前技术档案见 `ANALYSIS.md`，应用规范见 `APPS.md`，框架协议见 `FRAMEWORK_DESIGN.md`。 -> **⚠️ 本文档为公开路线图，自身已过时**：里程碑/阶段划分以**实际进度为准**（权威现状见 `devdocs/WORK_STATE.md`，本仓库 gitignore 不入库）。截至 **M2.83（0.7.78）** 已达成（M2.69→M2.83 全链路：launcher 拆分/控件库/系统框架专项服务/主界面 MD3 双布局/M3 导航栈+M5 通知跳转/媒体会话+Now Playing/SDK nav+media 封装/字库启动竞态修复）；下方「当前主线」为实际推进序列，**按依赖因果排列，非平行**；旧「阶段拓扑序」仅作背景参考，勿按它安排开发。 +> **⚠️ 本文档为公开路线图，自身已过时**：里程碑/阶段划分以**实际进度为准**（权威现状见 `devdocs/WORK_STATE.md`，本仓库 gitignore 不入库）。截至 **M2.88（0.7.83）** 已达成（M2.69→M2.88 全链路：launcher 拆分/控件库/系统框架专项服务/主界面 MD3 双布局/M3 导航栈+M5 通知跳转/媒体会话+Now Playing/SDK nav+media 封装/字库启动竞态修复/**amsd 一期+二期(picker 契约)/签名鉴权 2B/meow_route 音频路由/网易云二期/MeowPanel 实时画面·遥屏/中文拼音 IME**）；下方「当前主线」为实际推进序列，**按依赖因果排列，非平行**；旧「阶段拓扑序」仅作背景参考，勿按它安排开发。 --- ## 当前主线（按依赖因果 [源:2026-08-30]） > 每项必须在其依赖落地后才推进（不在依赖未满足时抢先实现上层）。✅=已达成。 -> **进度注（2026-08-31）**：主线 1-7 已基本达成——阶段 B 通知中心 UI（M2.65+39）、启动器 SDK 改造（M2.69 拆分 + M2.79 主界面 MD3 双布局 + 视图框架）、系统基建线（M2.67+ svcd 子进程化 + sysui 总监 + 专项服务）、M3 导航栈+M5 通知整合+媒体会话（M2.80/M2.81）、SDK 缺失件（meow_ui_nav/media/config）、蓝牙/WiFi 子页（M2.76）、MeowPanel（M2.72+）。当前新主线见 `devdocs/WORK_STATE.md`（**在跑 agent-212 amsd 一期**）。 +> **进度注（2026-08-31）**：主线 1-7 已基本达成——阶段 B 通知中心 UI（M2.65+39）、启动器 SDK 改造（M2.69 拆分 + M2.79 主界面 MD3 双布局 + 视图框架）、系统基建线（M2.67+ svcd 子进程化 + sysui 总监 + 专项服务）、M3 导航栈+M5 通知整合+媒体会话（M2.80/M2.81）、SDK 缺失件（meow_ui_nav/media/config）、蓝牙/WiFi 子页（M2.76）、MeowPanel（M2.72+）。当前新主线见 `devdocs/WORK_STATE.md`（**在跑 agent-235 SDK 绘制性能回退 hello demo 滑动卡 / agent-236 顶部下滑手势分流+watchdog SIGUSR1 误杀框架 App**；amsd agent-212 一期+二期已落地）。 1. **阶段 B 通知中心 UI（进行中）** —— 依赖 M2 通知存储 + SDK 控件基座 + B2a 后端。顶部快捷按钮/亮度滑条走 `meow_settings_*` 零旁路；通知列表读 launcher `meow_notif`；手势（状态栏下拉开、上滑/点外关、左缘返回关）。 2. **启动器 SDK 改造** —— 依赖上游 SDK 控件基座（阶段 B 沉淀的 MD3 基座）。状态栏收敛单一 SDK 全局（launcher 退役 `draw_statusbar`）；主界面/设置页/电源菜单迁到 SDK 控件；MD3 化、日/夜主题、全局 UI 统一。（见 FRAMEWORK_DESIGN §10.4） diff --git a/FRAMEWORK_DESIGN.md b/FRAMEWORK_DESIGN.md index ad16998..59671c7 100644 --- a/FRAMEWORK_DESIGN.md +++ b/FRAMEWORK_DESIGN.md @@ -1,6 +1,6 @@ # MeowOS 阶段 D：Activity / 通知 IPC 框架设计文档 -> 状态：设计稿 v1（2026-08-28）。先出协议与架构，本阶段只设计、不实现。 +> 状态：协议/架构参考稿（2026-08-28 起草；**以下协议已随 M2.15-M2.88 各里程碑落地**，消息号以 `patch_v2/meow_launcherd/meow_ipc.h` 为准）。本阶段的「只设计、不实现」为起草期口径；M0-M3/M5/§10.5/媒体会话/amsd 已实现，M4 后台服务保活与 M6 加固待排期（见 §9 进度）。 > 前置：ANALYSIS.md §18（Launcher 全架构）、§11（播放器 unix socket 先例）、APPS.md、DEVELOPMENT_PLAN.md 阶段 0/D。 > 实现语言：启动器 C（musl 静态 MIPS32r2，zig-mipsel-cc）；应用同为 C 静态 MIPS。 > 补充：本文件由 plan 子代理产出设计，主会话落盘，并附「后台运行/后台播放权限」（用户追加）。 @@ -58,8 +58,10 @@ struct ipc_hdr { /* LE */ | 0x0032 | MSG_ACT_RESULT | ↓ | 返回链路 | | 0x0040 | MSG_NAV | ↑ | 上报导航/请求退出（**M3 导航栈已落地**） | | 0x0041 | MSG_SHOW_ACTIVITY | ↓ | 令前端应用显示某屏 | -| 0x0070 | MSG_PICKER_CALL | ↑ | 请求跨 App picker 调用（发起方 A → 持有方 B；**仅预留协议位**，本期不实现） | -| 0x0071 | MSG_PICKER_RESULT | ↓ | picker 返回值（候选结果回 A；仅预留协议位） | +| 0x0070 | MSG_PICKER_CALL | ↑ | 请求跨 App picker 调用（发起方 A → 持有方 B；**已实现**，amsd 二期 agent-225：`am picker`/`picker-status`，files_app 注册 `pick_file`） | +| 0x0071 | MSG_PICKER_RESULT | ↓ | picker 返回值（候选结果回 A；**已实现**，amsd 二期） | +| 0x00A0 | MSG_AMS_START | → | amsd→launcher：请求拉起某 App（pkg + 可选 activity，含 picker 上下文 `MEOW_PICKER_*`；**已实现** agent-212/225） | +| 0x00A1 | MSG_AMS_KILL | → | amsd→launcher：请求终止某 App（SIGTERM 语义；**已实现**） | | 0x0072 | MSG_META | ↑ | 媒体会话上报元数据/进度/状态（**附录 B 已落地**，最近活跃源回收） | | 0x0073 | MSG_PLAYCTL | ↓ | 播放控制下发 / ↑ 控制器转发到最近活跃媒体会话（**已落地**） | | 0x00F0 | MSG_SYS | ↓ | 系统事件（守护关闭/服务死亡/播放器状态） | @@ -116,7 +118,8 @@ M0 IPC 骨架（含 meow_ipc 测试钩子）→ M1 路由表+解析 → M2 通 - ✅ **M0 IPC 骨架**（0.7.10，M2.15）：`meow_launcherd` 加 IPC 线程 + AF_UNIX `/usr/data/meow_ipc.sock`（unlink+bind+chmod0666+listen4）+ 帧解析（16B 头 magic=0x4D4F5701/version=1/type/req_id/len，LE）+ `MSG_HELLO/ACK/ERR` + eventfd 唤醒主循环 + 无锁 SPSC 内存环（`__sync`）+ 日志埋点。遵守 §1/§6.2：IPC 线程只读帧+解析+入队，主循环 `meow_ipc_process()` 单写者改状态，跨线程 eventfd，主循环 10ms 热键轮询每圈非阻塞排空（eventfd 失败时 10ms 轮询兜底）。测试钩子：`meow_ipc`（`patch_v2/meow_launcherd/meow_ipc.c`，静态 MIPS，与 evtool 同定位）+ launcher `--ipc-only N [--ipc-sock ]`。验证：`meow_ipc hello`→ACK、播放器不动（MeowOS 模式下无播放器即满足）。 - ✅ **M1 路由表 + 解析**（0.7.10，M2.15）：`app.json` 扁平行 `route.=path` / `framework=true` / `service.=mode:restart:max:window_ms` / `icon` 解析入 `g_accts` 注册表（主循环单写者）；`MSG_ACT_DECLARE`（运行时并集覆盖静态）/`MSG_ACT_QUERY`/`MSG_ACT_RESULT`（深度+链路）；`resolve_chain(app,activity)` 返回 `[root..target]` 链路与深度——`route` 缺失（app 未声明路由）→ 深度 1 兜底 `chain=activity`；声明了路由但 activity 非 route 键 → `MEOW_ERR_NOENT`（activity 未注册）。验证：`meow_ipc query ` 返回链路（qemu + 真机 MeowOS 模式均通）。 - ✅ **M2 通知存储+分发**、**M3 导航+前台会话改造+看门狗返回**、**M5 通知中心 UI 整合**（详见下，M2.65-M2.82 已落地）；⬜ **M4 后台服务保活**（`MSG_REGISTER` 后台服务登记）、**M6 加固**：待排期。 - - **M3 已落地（M2.80，agent-202 · 85b4aea）**：`nav_stack`（≤16 深）+ `MSG_NAV` REPORT/EXIT + `launch_activity` 链路注入（env `MEOW_ACTIVITY`/`MEOW_CHAIN`）+ 栈根退出回主屏；通知点击按 `route_status`（0 拉起/1 NO ROUTE/2 SOURCE NOT FOUND/-1 NONE 关面板不动作）；picker 协议位预留（0x0070/0x0071）；裸 App 兼容。 + - **M3 已落地（M2.80，agent-202 · 85b4aea）**：`nav_stack`（≤16 深）+ `MSG_NAV` REPORT/EXIT + `launch_activity` 链路注入（env `MEOW_ACTIVITY`/`MEOW_CHAIN`）+ 栈根退出回主屏；通知点击按 `route_status`（0 拉起/1 NO ROUTE/2 SOURCE NOT FOUND/-1 NONE 关面板不动作）；裸 App 兼容。 + - **amsd（一期 agent-212 · 5fbf307 + 二期 agent-225）已落地**：活动管理器守护（svcd 托管 `trigger=boot`）+ `am` CLI（status/list/history/start/kill/`resolve`/`picker`）。二期将路由表迁 amsd（amsd 路由权威）+ **picker 契约**（`MSG_PICKER_CALL=0x70`/`MSG_PICKER_RESULT=0x71`，`am picker`/`picker-status`；files_app 注册 `picker.pick_file` 选文件返回路径）+ `MSG_AMS_START/KILL=0x00A0/0x00A1`（amsd→launcher 决策执行）。参见 `devdocs/plan/AMSD_DESIGN.md`。 - **M5 通知中心 UI 整合已落地（M2.65-M2.81）**：通知中心 + 媒体卡片 + Now Playing（媒体会话见附录 B，已落地：`meow_media.c` 最近活跃源、30s 超时回收、`MSG_META`/`MSG_PLAYCTL`）。 - **§10.5 App 前台唤起通知中心已落地（M2.82，agent-206 · 9b41957）**：`MSG_NOTIF_OPEN=0x28`/`CLOSE=0x29` + SDK `meow_ui_nav`/`meow_ui_media` 封装。 - ✅ **渲染地基（0.7.11，M2.16，前置基座）**：所有 UI 统一走 **RAM 离屏后备缓冲 `back_buf`(480×720×2=691,200B) + `meow_present`(dirty)** = `FBIO_WAITFORVSYNC` 等垂直同步 + 单次原子 memcpy（脏区或全帧）到 fb0（buffer0，yoffset=0）——无渐进/无中间态/无撕裂。脏区 `meow_dirty_add`（矩形合并集、相交吸 bbox、>12 转全屏、裁可视区）；状态栏时钟/右侧格按需局部标脏。整合铺垫：框架后续 LAUNCH/NOTIFY/前台会话的绘制复用该机制（而非旧「全屏 clear→重绘到 buffer0」路径）。详情见 ANALYSIS.md §18.43。刷新率调度（display.refresh_rate 60/30/15 + refresh_always_max + 自适应降档 governor）归口 PERF_SCHEDULER.md。 diff --git a/MEOW_APP_SDK.md b/MEOW_APP_SDK.md index ae8f78e..b94f659 100644 --- a/MEOW_APP_SDK.md +++ b/MEOW_APP_SDK.md @@ -86,14 +86,15 @@ void meow_ui_fill_rect_alpha(int x, int y, int w, int h, uint32_t color, int alp ### 3.1 全局状态栏（系统级组件，A+C 方案并入） -**定位**：状态栏是**系统级全局组件**，由 SDK 统一绘制——所有界面（launcher 菜单 + MeowAPP 画面）默认都显示，**仅由 SDK 运行时 `meow_ui_set_fullscreen(1)` 控制隐藏**（`fullscreen` 字段**未在 app.json 解析**，已定未做，见 §3.1 注 [源:审计 2026-08-30]）。数据由 SDK 内置状态读取器抓系统快照（与 launcher 同源单点一致），非各画各的。 +**定位**：状态栏是**系统级全局组件**，由 SDK 统一绘制——所有界面（launcher 菜单 + MeowAPP 画面）默认都显示，**由 SDK 运行时 `meow_ui_set_fullscreen(1)` 控制隐藏/收合**（app.json `fullscreen` / `route..fullscreen` 由 launcher 解析并注入 env `MEOW_FULLSCREEN` 预设，见 §3.1 注 [源:审计 2026-08-30] / docs/MEOWOS_SPEC_REF §3.1 A-12）。数据由 SDK 内置状态读取器抓系统快照（与 launcher 同源单点一致），非各画各的。 ```c /* 状态栏显隐（默认显示；APP 声明全屏则隐藏——沉浸） */ void meow_ui_set_statusbar(int visible); /* 1=显示(默认) 0=隐藏(全屏) */ int meow_ui_statusbar_visible(void); -/* 全屏：由 SDK 运行时 meow_ui_set_fullscreen(1) 控制（app.json `fullscreen` 未解析，已定未做；外观=隐藏状态栏+隐藏返回键）。[源:审计 2026-08-30] */ +/* 全屏：SDK 运行时 meow_ui_set_fullscreen(1) 控制；app.json `fullscreen`/`route..fullscreen` 由 launcher + 解析并注入 env MEOW_FULLSCREEN 预设（外观=状态栏收合至提示线 + 保留左缘返回/顶部提示线/下滑通知中心）。[源:审计 2026-08-30] */ void meow_ui_set_fullscreen(int on); /* 状态栏高度（px，供 APP 布局上移内容，避免被盖——status bar inset） */ @@ -104,7 +105,7 @@ int meow_ui_statusbar_height(void); - `meow_ui_flush()` 上屏前，SDK 自动在顶部画状态栏（**28px**，`meow_ui_statusbar_height()` 即此值；用户定 40→28，栏内字号 20），内容：时钟 / 电量 / WiFi / 蓝牙 / 音量（与 launcher 一致）。 - 状态栏数据由 SDK 内置读取器周期刷新（~1s 轻刷，读 `/sys/class/power_supply/*`、WiFi 状态、时钟、音量寄存器——与 launcher 同一批 source）。 - **z 顺序**：状态栏是最顶层。APP 内容需 `meow_ui_statusbar_height()` 下移（inset），否则被状态栏盖住（有状态栏 OS 的通用做法）。 -- **全屏**：运行时 `meow_ui_set_fullscreen(1)` 控制 → 隐藏状态栏 + 隐藏返回键（沉浸）；退出恢复。**注**：app.json `fullscreen` 字段未在解析器读取（已定未做 [源:审计 2026-08-30]），故不能经 app.json 声明全屏。 +- **全屏**：运行时 `meow_ui_set_fullscreen(1)` 控制（或在 app.json 声明 `fullscreen` / `route..fullscreen`，由 launcher 解析注入 `MEOW_FULLSCREEN` 预设）→ 状态栏**收合至提示线** + 保留左缘返回 / 顶部提示线 / 下滑通知中心（见 docs/MEOWOS_SPEC_REF §3.1 A-13）；退出恢复。 **与 launcher 统一（A+C）**：launcher 迁移到 SDK 后，其状态栏（现私有 `draw_statusbar()`）改走 SDK 这一套，全局统一、单点一致。 @@ -209,9 +210,9 @@ const char *meow_ime_text(void); **布局（480×720 竖屏）**：键盘占底部约 40% 高（~290px），上方为输入预览行 + 候选区。键位 40×40（够 touch target），触屏点按输入。 **物理键辅助**（兼容未来硬件键/可访问性）：方向键移动光标、播放/确认键=选择、音量=翻页。B1 以触摸为主，物理键作为可选加分项（SDK 内实现）。 -**[B1 后续 / 不阻塞]**：中文拼音 IME、词库、候选词联想、剪贴板、长按重复——作为独立里程碑，等首个中文输入场景（网易云搜索）出现再做。 +**[B1 后续 / 不阻塞]**：剪贴板、长按重复等仍留后续。**中文拼音 IME 已落地**（M2.88，agent-229 · `e9b6b69`，设计稿 `devdocs/plan/IME_PINYIN_DESIGN.md`）：`meow_pinyin.c` 静态表词库（403 音节 + 329 词，rodata ~20.5KB 零堆）+ 音节切分 DFS+联想引擎，SDK 经 `MEOW_IME_PINYIN` 尾部追加零 ABI 破坏接入（组合条 + 候选栏 + 翻页 + 中英切换，英文零回归）。 -> **实现对齐（M2.73，`meow_ui_ime.c`，以源码为准）**：实现与上表**关键出入**——① 键盘占底部约 **300px**（`KB_TOP=420`，720-420=300），键位 **44×36**（非 40×40）；② **回显行 = 实时输入回显**（把 `g_ime_buf` 拼下划线 `"%s_"` 画在面板顶部条），**非候选/联想区**，候选区留中文输入法（B1 后续）再做；③ 关闭时**键盘区背景快照/恢复**（`ime_capture`/`ime_restore`，根治关闭后键盘像素残留）；④ **配色走主题**（`meow_theme` 语义色，深/浅自动切），不硬编码黑底白键；⑤ **shift 切换大小写**；⑥ 阻塞 `meow_ui_text_input` 打字循环喂 `meow_ui_activity_ping`（重置息屏计时，进度条不卡死）；⑦ **OK（回车）= 提交并关闭**（拷贝到 app `ctx->buf`）、**ESC（X）/ 点键盘外背景 = 取消并关闭**；非阻塞 `meow_ui_text_input_async` 用 `meow_ime_active()`/`meow_ime_text()` 轮询（同 close 语义）。上表「布局 40×40 / 物理键辅助 / 候选区」为设计稿表述，已按实际覆盖。 +> **实现对齐（M2.73，`meow_ui_ime.c`，以源码为准）**：实现与上表**关键出入**——① 键盘占底部约 **300px**（`KB_TOP=420`，720-420=300），键位 **44×36**（非 40×40）；② **回显行 = 实时输入回显**（把 `g_ime_buf` 拼下划线 `"%s_"` 画在面板顶部条），**非候选/联想区**，候选区原留给中文输入法；**中文拼音 IME 已落地**（M2.88 agent-229，候选栏/组合条见 `meow_ime.c`/`meow_pinyin.c`）；③ 关闭时**键盘区背景快照/恢复**（`ime_capture`/`ime_restore`，根治关闭后键盘像素残留）；④ **配色走主题**（`meow_theme` 语义色，深/浅自动切），不硬编码黑底白键；⑤ **shift 切换大小写**；⑥ 阻塞 `meow_ui_text_input` 打字循环喂 `meow_ui_activity_ping`（重置息屏计时，进度条不卡死）；⑦ **OK（回车）= 提交并关闭**（拷贝到 app `ctx->buf`）、**ESC（X）/ 点键盘外背景 = 取消并关闭**；非阻塞 `meow_ui_text_input_async` 用 `meow_ime_active()`/`meow_ime_text()` 轮询（同 close 语义）。上表「布局 40×40 / 物理键辅助 / 候选区」为设计稿表述，已按实际覆盖。 --- diff --git a/README.md b/README.md index f5a6d21..7d0e438 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ > 把 HiBy R3 Pro II 便携播放器（君正 X1600，MIPS32r2 / mipsel / musl 静态软浮点，480×720，无 GPU 软渲染）变成一个可扩展的「第二系统 + 应用框架」。 > MeowOS 与官方 HibyOS 共存于同一台设备：开机由引导选单二选一；启动后 MeowOS 作为主控层，提供自己的桌面 UI、应用框架、服务管理与系统组件。 > -> 版本：**M2.83（0.7.78）**（M2.69→M2.83 全链路自刷验收：控件库/主界面 MD3 双布局/M3 导航栈/M5 通知跳转/媒体会话/Now Playing/SDK nav+media 封装/字库启动竞态修复）。版本号单点 = 板上 `/etc/meowos_version`，见「构建」。本仓库是一个**自带 SDK、包管理、媒体会话、网页面板、网易云客户端的完整第三方系统**。 +> 版本：**M2.88（0.7.83）**（M2.69→M2.88 全链路自刷验收：控件库/主界面 MD3 双布局/M3 导航栈/M5 通知跳转/媒体会话/Now Playing/SDK nav+media 封装/字库启动竞态修复**/M2.84-88**：installed 图标修复+残帧pan加固/物理键EVIOCGKEY双源/签名鉴权 2B/meow_route 音频路由/amsd 二期(picker 契约)/网易云二期(封面·歌词后台·大歌单分页)/MeowPanel 实时画面+遥控+通知实时化/中文拼音 IME）。版本号单点 = 板上 `/etc/meowos_version`，见「构建」。本仓库是一个**自带 SDK、包管理、媒体会话、网页面板、网易云客户端的完整第三方系统**。 > > 许可证：Apache-2.0（见 [`LICENSE`](LICENSE)）。本仓库为非官方第三方项目。 @@ -17,7 +17,7 @@ - **应用框架**：一套 C 应用 SDK（`meow_ui`），第三方 App 用统一控件 / 输入 / 主题 / 字体 / 通知 API 开发，无需自读帧缓冲、自读输入、自管返回——把每个 App 都要踩一遍的坑收口到框架里。 - **系统组件**：状态栏、通知中心、电源菜单、全局左缘返回手势、主界面（应用列表，**MD3 卡片宫格/列表双布局**）、设置页、服务管理器、mDNS 广播；系统进程总监 `meow_sysui`；专项子服务 `meow_svc_perf`（性能/系统只读聚合，含真实 network）与 `meow_svc_power`（关机/重启/升级/回 HiBy，含升级写保护 + dac 真实音量 + 读级鉴权放宽）；系统级崩溃捕获 `meow_crash` + App 崩溃直报；.mpk **Ed25519 签名验签** `meow_verify`（见 §2.9）；MeowPanel 外部管理面板（HTTP/JSON 后端 + Web 前端，支持可选密码鉴权，见 §2.10）。 - **媒体会话 / Now Playing**：`MSG_META`/`MSG_PLAYCTL`（0x72/0x73）媒体会话（最近活跃源，30s 超时回收）+ 通知中心**媒体卡片** + 主界面左滑 **Now Playing 大页**；媒体键路由到最近活跃媒体会话。 -- **应用生态**：**网易云 os.meow.ncm**（`core/`：mbedtls+jsmn+qrcodegen+minimp3 ≈438KB；v1 复古 UI：登录二维码/我创建的·我收藏的双页签/搜索/歌单详情/黑胶播放页/设置，ALSA 直开 hw:0,0 播放，登录 803 已通）；外置**系统文件管理器 os.meow.files**；`meow_ui` SDK 配套结构化列表 `W_LISTVIEW`、通用长按、SDK nav/media 封装、视图框架（可嵌套 view + 事件路由 + 绘制期 clip）；App 通知查询/清除 IPC（0x25-27）与**点击通知跳转路由**（route_status）。 +- **应用生态**：**网易云 dev.player.ncm**（`core/`：mbedtls+jsmn+qrcodegen+minimp3 ≈438KB；v1 复古 UI：登录二维码/我创建的·我收藏的双页签/搜索/歌单详情/黑胶播放页/设置，ALSA 直开 hw:0,0 播放，登录 803 已通；二期：专辑封面/歌词后台加载/大歌单分页）；外置**系统文件管理器 os.meow.files**；`meow_ui` SDK 配套结构化列表 `W_LISTVIEW`、通用长按、SDK nav/media 封装、视图框架（可嵌套 view + 事件路由 + 绘制期 clip）；App 通知查询/清除 IPC（0x25-27）与**点击通知跳转路由**（route_status）。 - **进程隔离**：系统 UI 渲染进程与 App 进程相互独立，App 卡死不会冻结整个 UI。 - **包管理**：`nyai`（固件内置 `/usr/bin/nyai`）支持 .mpk 安装/升级/导出/列表/索引，走 **version_code 安卓式版本规则**（缺 code 拒装、防降级）+ 签名分级（有签必验、`os.meow.*` 无签拒装、第三方直装告警）+ 导出过滤与体检。 @@ -43,7 +43,7 @@ ``` init (rcS) - ├─ /etc/init.d/S70meow_sysui 系统进程总监（meow_sysui，S70，M2.71 引入；监管 svcd，launcher 由 bootmenu 拥有） + ├─ /etc/init.d/S70meow_sysui 系统进程总监（meow_sysui，S70，M2.71 引入；监管 svcd + launcher，M2.83 起 launcher 移交 sysui） ├─ /etc/init.d/S89meow_svcd 开机自启 meow_svcd（服务管理器） │ ├─ meow_mdns 及 services.d 服务 = 独立子进程 │ └─ 专项子服务（一期）= meow_svc_perf / meow_svc_power @@ -53,8 +53,8 @@ init (rcS) └─（选 HiByOS）exec hiby_player ``` -- **进程总监 `meow_sysui`（M2.71 已落地，`/usr/bin/meow_sysui` + `S70meow_sysui`）**：监管系统进程，**一个崩→只拉起它，绝不级联、绝不拖垮自身**。自身最小依赖、不渲染、不承载重逻辑 → 最稳。当前默认只监护 `meow_svcd`（launcher 仍由 bootmenu 的 `execv` 拥有，`enabled=0` 防双重拉起，移交见后端让位）；`meow_mdns` 是 svcd 的服务子进程（不双重管理）。配置 `sysui.d/` 目录式（复用 services.d 语义），见 `patch_v2/meow_sysui/meow_sysui.md` 与 `docs/MEOWOS_SPEC_REF.md` §4。 -- **专项子服务（M2.73 已落地，规划见 `devdocs/plan/SYSTEM_FRAMEWORK_SERVICES.md`）**：新增两个 **svcd 托管、板载 `trigger=boot`** 的专项子服务——`meow_svc_perf`（性能 / 系统只读聚合，含 network）、`meow_svc_power`（关机 / 重启 / 升级 / 回 HiBy 系统动作，含升级写保护 + dac 真实音量）。launcher 电源菜单与 MeowPanel 改经这些服务 IPC 触发，不再直连 `sys_do_reboot`/爬 `/proc`。电源 CLI `meow_svc_power `（root 免鉴权、单一命令、不覆盖系统 shutdown/reboot）。**二期**补关键 IPC 只接受 `os.meow.*` 鉴权 + `.mpk` 打包签名验签。详见 §2.9。 +- **进程总监 `meow_sysui`（M2.71 已落地，`/usr/bin/meow_sysui` + `S70meow_sysui`）**：监管系统进程，**一个崩→只拉起它，绝不级联、绝不拖垮自身**。自身最小依赖、不渲染、不承载重逻辑 → 最稳。默认监护 `meow_svcd` + `meow_launcherd`（**M2.83 起 launcher 生命周期移交 sysui**：`sysui.d/launcher.conf` `enabled=1`（restart=always/backoff=3000/max_restart=5）；bootmenu 在 MeowOS 模式让位——sysui 在则不 exec launcher）；`meow_mdns` 是 svcd 的服务子进程（不双重管理）。配置 `sysui.d/` 目录式（复用 services.d 语义），见 `patch_v2/meow_sysui/meow_sysui.md` 与 `docs/MEOWOS_SPEC_REF.md` §4。 +- **专项子服务（M2.73 已落地，规划见 `devdocs/plan/SYSTEM_FRAMEWORK_SERVICES.md`）**：新增两个 **svcd 托管、板载 `trigger=boot`** 的专项子服务——`meow_svc_perf`（性能 / 系统只读聚合，含 network）、`meow_svc_power`（关机 / 重启 / 升级 / 回 HiBy 系统动作，含升级写保护 + dac 真实音量）。launcher 电源菜单与 MeowPanel 改经这些服务 IPC 触发，不再直连 `sys_do_reboot`/爬 `/proc`。电源 CLI `meow_svc_power `（root 免鉴权、单一命令、不覆盖系统 shutdown/reboot）。**二期已落地**：关键 IPC 只接受 `os.meow.*` 鉴权 + `.mpk` 打包签名验签（agent-185 2A / agent-221 2B）。详见 §2.9。 - **隔离保证（现已落地）**：系统组件各自独立进程；App 进程与系统 UI 渲染进程独立；svcd 的**每个服务是独立子进程**（服务崩只重启该服务，不拖垮 svcd）。任何 App / 服务崩溃都不冻结系统 UI。 ### 2.2 双系统引导（bootmenu） @@ -106,6 +106,8 @@ init (rcS) - **M2.73 控件库修复（`meow_ui.a` md5 `e8341975`，见 `MEOW_APP_SDK.md` §5.8）**：`W_LIST`（含 LazyColumn/LazyRow）**视口裁剪**——滚动时只绘制落在视口内的行/分隔线/文本，杜绝「行滚出视口把内容画到视口外并标脏上屏」导致的标题栏/底部脏区（SDK 全局生效，非 App 侧）。IME（`meow_ui_ime.c`）：键盘区背景快照/恢复（无残影）、配色走主题、shift 大小写、阻塞 `meow_ui_text_input` 喂 `on_tick`（避免进度条卡死）、OK（回车）= 提交并关闭 / ESC = 取消并关闭、回显条=实时输入回显（非候选/联想，候选框留中文输入法）。渲染：局部刷新不再清底重画单个控件（改 z 栈重画），消除重叠区残留。 - **M2.76+ 新增**：`W_LISTVIEW` **结构化列表控件**（§5.5 A②落地：图标/标题/副标题/右侧操作 arrow·switch·check·more、单选/多选/禁态、行右 1/3 操作区命中、视口裁剪、全语义色）；**通用长按事件** `MEOW_EV_LONG_PRESS`（坐标式 + `meow_ui_set_long_press_cb/ms` opt-in，默认 500ms，移动>12px 取消、长按后抬手抑制 TAP/SWIPE）；**视图框架**（`meow_ui_view.c`：可嵌套容器 + 六生命周期 + `page_push/pop/replace` 包装 activity 栈 + 广播注册表 z 序 + `meow_view_dispatch_event` z 降序子>父命中即消费 + **绘制期通用 clip**`g_clip_stack[16]` 根除越界脏区）；**SDK 级 z 序已并入视图框架**（自动注册 + 子>父 + `set_z(999)` 置顶 + 收敛 live_btn），hello App 层 `d_paint_region` 临时方案退役。 - **M2.82 新增**：SDK **nav/media 封装**——`meow_ui_nav.c`（env 栈初始化 + report/request_exit）、`meow_ui_media.c`（懒连断线重连，meta 上报 + playctl 接收）；SDK 顶部下滑手势→IPC 请求 launcher 展开通知中心（§10.5，App 进程不渲染系统 UI）。 +- **M2.84-88 新增**：**amsd 活动管理器**（一期 agent-212 生命周期注册表+`am` CLI，二期 agent-225 路由决策化+**picker 契约** `MSG_PICKER_CALL/RESULT 0x70/71` + `MSG_AMS_START/KILL`）；**签名鉴权 2B**（agent-221 多公钥数组 + v2 签名块）；**meow_route 音频输出路由**自动跟随插孔（agent-220）；**中文拼音 IME**（agent-229 `meow_pinyin.c` 静态表 403 音节+329 词，组合条+候选栏+翻页+中英切换）；**App 内物理音量/媒体键**（agent-226 EVIOCGKEY 位图轮询+120ms 去重）；**开机亮度 stop100 竞态**（agent-230）；**网易云二期**（agent-222 专辑封面/歌词后台/大歌单分页）+ 歌单详情回退（agent-227）；**MeowPanel 阶段 C**（agent-224 实时画面 `/api/screen.jpeg` + 遥控 `/api/input/tap`）+ 通知实时化+屏幕增量帧（agent-234）。 +- **M2.80-83 已落地**：M3 导航栈+M5 通知跳转（M2.80）、媒体会话+Now Playing（M2.81）、SDK nav/media 封装（M2.82）、字库启动竞态修复（M2.83）。 - 既有 `meow_btn/slider/switch/list_create` 签名一字不改（向后兼容），Options/状态机走新增挂载器。 ### 2.5 服务 @@ -157,10 +159,10 @@ init (rcS) 把**系统复用功能收敛到系统框架**（`devdocs/plan/SYSTEM_FRAMEWORK_SERVICES.md`，一期已落地）：meow_sysui 派生 → meow_svcd 托管 → IPC。新增两个 **svcd 托管、板载 `trigger=boot`** 的专项子服务： -- **`meow_svc_perf`**（性能 / 系统只读聚合，IPC `/usr/data/meow_perf.sock`，`MSG_PERF_QUERY(0x0050)→MSG_PERF_RESULT(0x0051)`）；**`meow_svc_power`**（关机 / 重启 / 升级 / 回 HiBy 系统动作，IPC `/usr/data/meow_power.sock`，`MSG_POWER_ACTION(0x0060)→MSG_POWER_STATUS(0x0061)`，服务端 `SO_PEERCRED uid==0` 基础鉴权）。**M2.73 已落地**：`meow_svc_perf` 增 **network** 子集（真实 WiFi `wpa_cli`/`ip` + 蓝牙 `hci0`/sysfs + `hostname_local`），并入 SYSTEM 子集输出；`meow_svc_power` **升级写保护**（`upgrade` 写 mtd5 前校验卡根 `r3proii.upt` 存在+可读+常规文件+size>0，失败不写 mtd5/不重启——**只完整性、不签名**，海贝官方固件无签名，签名会挡自刷）与 **`dac status` 读板载 `settings.conf` 的 `audio.volume` 真实值**（弃 amixer dummy）。**M2.78 读级鉴权放宽（agent-189）**：`STATUS`/`BATTERY`/`REBOOT_REASON`/`UPGRADE_STATUS`/`dac status` 读级不再查 uid（任意调用者）；动作级维持 `os.meow.*`/系统身份白名单。当前 md5：perf `7ea196de`、power `c6ddf3f8`。 +- **`meow_svc_perf`**（性能 / 系统只读聚合，IPC `/usr/data/meow_perf.sock`，`MSG_PERF_QUERY(0x0050)→MSG_PERF_RESULT(0x0051)`）；**`meow_svc_power`**（关机 / 重启 / 升级 / 回 HiBy 系统动作，IPC `/usr/data/meow_power.sock`，`MSG_POWER_ACTION(0x0060)→MSG_POWER_STATUS(0x0061)`，服务端 `SO_PEERCRED uid==0` 基础鉴权）。**M2.73 已落地**：`meow_svc_perf` 增 **network** 子集（真实 WiFi `wpa_cli`/`ip` + 蓝牙 `hci0`/sysfs + `hostname_local`），并入 SYSTEM 子集输出；`meow_svc_power` **升级写保护**（`upgrade` 写 mtd5 前校验卡根 `r3proii.upt` 存在+可读+常规文件+size>0，失败不写 mtd5/不重启——**只完整性、不签名**，海贝官方固件无签名，签名会挡自刷）与 **`dac status` 读板载 `settings.conf` 的 `audio.volume` 真实值**（弃 amixer dummy）。**M2.78 读级鉴权放宽（agent-189）**：`STATUS`/`BATTERY`/`REBOOT_REASON`/`UPGRADE_STATUS`/`dac status` 读级不再查 uid（任意调用者）；动作级维持 `os.meow.*`/系统身份白名单。**M2.88 签名鉴权 2B（agent-221）**：svc_power 面板身份精确路径绑定（删启发式）。当前 md5：perf `7ea196de`、power `306df962`。 - **电源 CLI `meow_svc_power `**（root 免鉴权、单一命令、**不覆盖**系统 shutdown/reboot）：`shutdown` / `reboot[--hiby]`（强制回 MeowOS）/ `upgrade`（写 mtd5，含升级写保护）/ `set-default-meow` / `set-default-hiby` + `status` / `battery` / `reboot-reason` / `upgrade-status` / `screen on|off|timeout<秒>` / `dac on|off|status`。 - launcher 电源菜单与 MeowPanel 均**改为经这些服务 IPC 触发**，不再直连 `sys_do_reboot` / 爬 `/proc`。 -- **二期**：关键 IPC 只接受 `os.meow.*` 鉴权 + `.mpk` 打包签名验签（防伪造包名，解包验签 / 导出保留签名）。 +- **二期望签鉴权已落地（agent-185 2A / agent-221 2B）**：关键 IPC 只接受 `os.meow.*` 鉴权 + `.mpk` 打包签名验签（防伪造包名，解包验签 / 导出保留签名）；`meow_verify` 多公钥数组 + v2 签名块（含 ts，兼容 v1）+ svc_power 面板身份精确路径绑定（删启发式）。 - **开机默认**：权威标记 `/data/meow_boot_default`（单值 O_TRUNC：`0`=MeowOS / `1`=HiByOS）。 ### 2.10 MeowPanel（外部管理面板） @@ -188,7 +190,7 @@ init (rcS) - `files_app/` 外置系统文件管理器 os.meow.files（app.c + ui/{browser,viewer}.c + ui/common/chrome.c + logic/fsx.c） - `meow_sysui/` 系统进程总监（`meow_sysui` + `S70meow_sysui` + `meow_sysui.md`） - `meow_svcd/` 服务管理器；`meow_watchdog/` 应用看门狗；`meowpkg/` 包管理（`nyai.c`）；`uinput_tap/` - - `meow_crash/` 系统级崩溃捕获；`meow_verify/` `.mpk` Ed25519 验签；`meow_sign/` 宿主签名工具；`meow_svc_perf/`、`meow_svc_power/` 专项子服务；`meowpanel/` MeowPanel 外置面板后端 + `web/` 前端；`meow_amsd/` amsd 活动管理器（agent-212 规划，设计见 `devdocs/plan/AMSD_DESIGN.md`） + - `meow_crash/` 系统级崩溃捕获；`meow_verify/` `.mpk` Ed25519 验签；`meow_sign/` 宿主签名工具；`meow_svc_perf/`、`meow_svc_power/` 专项子服务；`meowpanel/` MeowPanel 外置面板后端 + `web/` 前端；`meow_amsd/` amsd 活动管理器（一期 agent-212 + 二期路由决策/picker 契约 agent-225，设计见 `devdocs/plan/AMSD_DESIGN.md`）；`meow_route/` 音频输出路由自动随插孔（agent-220） - **`mips-repo/`（入库）**—— mipsel 交叉编译软件仓库：`bins/`（`meow_mdns` / `mdnsd` 等二进制工具 + `build.sh` + `manifest.md`）、`mpk/`（`.mpk` 应用包）。 - **`docs/`（入库）**—— `MEOWOS_SPEC_REF.md` 权威速查总索引。 - **`font/`（入库）**—— 字形系统：`gen/gen_font.py` 生成器、`meow_font.c/.h` 渲染库、`demo/`、`src/`（字体源文件）。 diff --git a/SYSTEM_SETTINGS.md b/SYSTEM_SETTINGS.md index c0fa9ea..447f941 100644 --- a/SYSTEM_SETTINGS.md +++ b/SYSTEM_SETTINGS.md @@ -23,7 +23,7 @@ | | `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` | 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 | +| | `display.background` | enum/图片 | `black` | **由「当前 style × 当前 mode」决定的背景底选项集**（非独立全局维度；可选集+默认随 style/mode 一起变）：**MD3×dark**=黑/深蓝/墨绿（默认黑）、**MD3×light**=白/浅蓝/浅绿（默认白）、**MIUIx×dark/light**各一套（草案）。每种配色定义**深/浅两套 surface/bg**，随 `display.theme` 切换（修复"背景仅对主页生效/仅深蓝/浅色不搭"）。亦可为图片路径 `MeowAPPs/backgrounds/xx.png`（**定案**：图片 **cover 居中裁剪**，深浅作用于文字/角色色、背景图不随深浅换，叠加层固定跟明暗主题）。见 MEOW_APP_SDK §8.1 | | **电源** | `power.longpress_menu_ms` | int | 3000 | 长按电源弹电源菜单阈值 | | | `power.forceoff_ms` | int | 8000 | 长按电源强关阈值 | | | `power.defeat_hotkey` | string | `power_voldown` | 切系统/切 MeowOS 热键组合 | diff --git a/docs/MEOWOS_SPEC_REF.md b/docs/MEOWOS_SPEC_REF.md index 518bc6c..2a6d187 100644 --- a/docs/MEOWOS_SPEC_REF.md +++ b/docs/MEOWOS_SPEC_REF.md @@ -120,23 +120,23 @@ > 定位：把 §5（最小控件集）与设计模板（§5.2-§5.7）收敛到**统一控件架构**；实现分两批（§5.8.8）。 - **第一批 = 通用基座（M2.70/0.7.65）**：`meow_widget` 基座统一标准控件/自定义画布；`meow_widget_opts`（Modifier 式 Options，`meow_widget_set_opts`/`meow_widget_opts_get`，0/-1 用默认）；统一状态机 `MEOW_WS_ENABLED/SELECTED/FOCUSED/PRESSED`（`meow_widget_set_state`/`meow_widget_state`/`meow_widget_enabled`/`selected`）；`meow_widget_custom_create`（自定义画布，App 给 render/hit 回调，`W_CUSTOM`）；布局 `meow_row/column/box`+`meow_layout_add/arrange`+`spacer`；MD3 语义色板（§5.8.4）+ 主题接口 `meow_ui_set_style`（`MEOW_STYLE_MD3/MIUIX`）`/meow_theme_get`。 - **第二批 = Material 组件子集（M2.71/0.7.66）**：`meow_btn_create_variant`（五型）/`meow_textfield_create`（IME）/`meow_card_create`/`meow_divider_create`/`meow_badge_create`/`meow_checkbox_create`/`meow_radio_create`/`meow_progress_create`/`meow_progress_circular_create`/`meow_fab_create`/`meow_topappbar_create`/`meow_navigationbar_create`/`meow_tabbar_create`/`meow_lazycolumn_create`/`meow_lazyrow_create`/`meow_dialog_create`/`meow_sheet_create`。 -- **M2.73 控件库修复（`meow_ui.a` md5 `e8341975`，`[meow_ui_widget.c][meow_ui_ime.c]`）**：① `W_LIST`（含 LazyColumn/LazyRow，`meow_widget_draw` case W_LIST）**视口裁剪**——按 `vx0/vx1/vy0/vy1` 只绘制落在视口内的行/分隔线/文本，杜绝「行滚出视口仍画/标脏上屏」的标题栏/底部脏区（SDK 全局，非 App 侧）；② **z 序**：App 侧 `hello_app/hello.c` 的 `d_paint_region` 局部刷新改按 z 栈重画（内容→标题→slider 值→chrome），根治「层动态控件实时重绘盖住/抹掉上层 FAB」；**SDK 级全局 z 序方案在评估，暂未落定**（未正式纳入 SDK 公共 API 前不要写成正式规范）；③ 渲染残影/脏区：局部刷新不再「清底+只画单个控件」（改 z 栈重画），消除重叠区残留；④ **IME 行为**（`meow_ui_ime.c`）：键盘区背景快照/恢复（`ime_capture`/`ime_restore`，无残影）、配色走主题（不再硬编码黑底白键）、shift 大小写、阻塞 `meow_ui_text_input` 在打字循环喂 `meow_ui_activity_ping`（重置息屏计时，进度条不卡死）、OK（回车）=提交并关闭 / ESC（X）/背景点=取消；回显条=**实时输入回显**（`"%s_"` 拼接，非候选/联想），**候选框留中文输入法再做**。 +- **M2.73 控件库修复（`meow_ui.a` md5 `e8341975`，`[meow_ui_widget.c][meow_ui_ime.c]`）**：① `W_LIST`（含 LazyColumn/LazyRow，`meow_widget_draw` case W_LIST）**视口裁剪**——按 `vx0/vx1/vy0/vy1` 只绘制落在视口内的行/分隔线/文本，杜绝「行滚出视口仍画/标脏上屏」的标题栏/底部脏区（SDK 全局，非 App 侧）；② **z 序**：App 侧 `hello_app/hello.c` 的 `d_paint_region` 局部刷新改按 z 栈重画（内容→标题→slider 值→chrome），根治「层动态控件实时重绘盖住/抹掉上层 FAB」；**SDK 级全局 z 序已落地并并入视图框架**（`meow_ui_view.c` 广播注册表 z 序：自动注册 + 子>父 + `set_z(999)` 置顶 + 收敛 live_btn，agent-176 · M2.76），hello App 层 `d_paint_region` 临时方案退役（agent-195 绘制期通用 clip `g_clip_stack[16]` 根除越界脏区）；③ 渲染残影/脏区：局部刷新不再「清底+只画单个控件」（改 z 栈重画），消除重叠区残留；④ **IME 行为**（`meow_ui_ime.c`）：键盘区背景快照/恢复（`ime_capture`/`ime_restore`，无残影）、配色走主题（不再硬编码黑底白键）、shift 大小写、阻塞 `meow_ui_text_input` 在打字循环喂 `meow_ui_activity_ping`（重置息屏计时，进度条不卡死）、OK（回车）=提交并关闭 / ESC（X）/背景点=取消；回显条=**实时输入回显**（`"%s_"` 拼接，非候选/联想），**候选框留中文输入法再做**。 - **兼容**：既有 `meow_btn/slider/switch/list_create` 签名一字不改（Options/状态机走新增挂载器）；`meow_ui_theme`/`meow_widget` 结构变化 = **`meow_ui.a` ABI 变化** → 需同步重编 hello（§5.8.8）。 - **主题增强（§8.1）**：主题 = **顶级风格族 `ui.style`（md3/miuix）× 明暗 `display.theme`（dark/light）** 共同决定「整套配色+控件形态+背景底」；`display.background` 为「style×mode」派生的**可选背景底选项集**（非独立维度）；状态栏图标随 `ui.style` 换集。⚠️ **`miui`/`miuix` 命名待定案（保留，勿拍板）**：`MEOW_APP_SDK §8.1` 用 `miuix`；`SYSTEM_SETTINGS §1` 注明 `meow_settings.c g_defs` 现值 `"md3,miui"`（label "Material You,MIUI"），实现时把 `g_defs` 的 `miui` 对齐为 `miuix`（**MIUIx 未实现，当前仅 md3 生效**）。 --- ## 4. SDK 之外系统组件 -- **系统进程 supervisor 树（源:2026-08-30 定案；M2.71 已落地 `meow_sysui`）**：`meow_sysui`（`patch_v2/meow_sysui/meow_sysui.c`，~113KB；`etc/init.d/S70meow_sysui` 开机拉起，早于 S89）监管系统进程，**一个崩→只拉起它，绝不级联**；`meow_launcherd`=系统 UI 渲染宿主（状态栏/通知中心/电源菜单/全局手势，与 APP 进程独立）；`meow_svcd`=服务管理器（服务全子进程化，svcd 自身不死）；APP 进程只渲染自己内容，崩不连累系统 UI。**系统组件渲染归系统进程（launcher），APP 进程不渲染系统 UI**（SDK 系统组件 API 仅系统进程可链，App 不可自建悬浮层）；通知中心 UI 渲染主体=系统进程，数据经 IPC 从通知存储读。现网（bootmenu execv launcher + S89 svcd 自启）→ 定案（sysui 统一监管）为渐进迁移，属系统基建线。**sysui 当前默认只监护 `meow_svcd`**（`/usr/data/meow/sysui.d/.conf`，目录式复用 services.d 语义；launcher 由 S90meow_bootmenu 的 execv 拥有，登记但 `enabled=0` 防双重拉起；mdns 是 svcd 服务子进程，不双重管理）。`[FRAMEWORK_DESIGN §10][MEOW_APP_SDK §6.1][NOTIFICATION_SYSTEM §9][patch_v2/meow_sysui/meow_sysui.md]` -- **专项子服务（一期在跑 + M2.73 落地，规划见 `devdocs/plan/SYSTEM_FRAMEWORK_SERVICES.md`）**：两个 **svcd 托管、板载 `trigger=boot`** 的专项子服务——`meow_svc_perf`（性能/系统只读聚合）、`meow_svc_power`（关机/重启/升级/回 HiBy 系统动作）。launcher 电源菜单与 MeowPanel 均改经这些服务 IPC 触发（不再直连 `sys_do_reboot`/爬 `/proc`）。**IPC**：perf 走 `/usr/data/meow_perf.sock` `MSG_PERF_QUERY→RESULT`；power 走 `/usr/data/meow_power.sock` `MSG_POWER_ACTION→STATUS`（服务端 `SO_PEERCRED uid==0` 基础鉴权）。**M2.73**：perf 增 **network** 子集（SYSTEM 子集输出：真实 WiFi `wpa_cli`/`ip` + 蓝牙 `hci0`/sysfs + `hostname_local`，单点权威源）；power **升级写保护**（`upgrade` 写 mtd5 前校验卡根 `r3proii.upt` 存在+可读+常规文件+size>0，失败不写 mtd5/不重启；**只完整性不签名**，海贝官方固件无签名，期望 md5/hash 二期）与 **`dac status` 读板载 `settings.conf` 的 `audio.volume` 真实值**（`settings_get_int_trim`，弃 amixer dummy；`dac on/off` 因 cs43198 `pwr_gpio=-1` 无控制点→`MEOW_ERR_NODEV`）。新 md5：perf `fa073bf9`、power `f3e653d5`。**电源 CLI `meow_svc_power `**（root 免鉴权、单一命令、不覆盖系统 shutdown/reboot）：`shutdown`/`reboot[--hiby]`（强制回 MeowOS）/`upgrade`（写 mtd5=`ota:kernel2`，含写保护）/`set-default-meow`/`set-default-hiby` + `status`/`battery`/`reboot-reason`/`upgrade-status`/`screen on|off|timeout<秒>`/`dac on|off|status`。**二期**：关键 IPC 只接受 **`os.meow.*`** 鉴权 + `.mpk` 打包签名验签（解包验签/导出保留签名）。`[SYSTEM_FRAMEWORK_SERVICES][APPS 附录 §3][meow_svc_perf.c][meow_svc_power.c]` +- **系统进程 supervisor 树（源:2026-08-30 定案；M2.71 已落地 `meow_sysui`）**：`meow_sysui`（`patch_v2/meow_sysui/meow_sysui.c`，~113KB；`etc/init.d/S70meow_sysui` 开机拉起，早于 S89）监管系统进程，**一个崩→只拉起它，绝不级联**；`meow_launcherd`=系统 UI 渲染宿主（状态栏/通知中心/电源菜单/全局手势，与 APP 进程独立）；`meow_svcd`=服务管理器（服务全子进程化，svcd 自身不死）；APP 进程只渲染自己内容，崩不连累系统 UI。**系统组件渲染归系统进程（launcher），APP 进程不渲染系统 UI**（SDK 系统组件 API 仅系统进程可链，App 不可自建悬浮层）；通知中心 UI 渲染主体=系统进程，数据经 IPC 从通知存储读。现网（bootmenu execv launcher + S89 svcd 自启）→ 定案（sysui 统一监管）为渐进迁移，属系统基建线。**已迁移（M2.83）**：sysui 默认监护 `meow_svcd` + `meow_launcherd`（`/usr/data/meow/sysui.d/.conf`，目录式复用 services.d 语义；`sysui.d/launcher.conf` `enabled=1`（restart=always/backoff=3000/max_restart=5），bootmenu 在 MeowOS 模式让位——sysui 在则不 exec launcher；mdns 是 svcd 服务子进程，不双重管理）。`[FRAMEWORK_DESIGN §10][MEOW_APP_SDK §6.1][NOTIFICATION_SYSTEM §9][patch_v2/meow_sysui/meow_sysui.md]` +- **专项子服务（一期 M2.73 已落地，规划见 `devdocs/plan/SYSTEM_FRAMEWORK_SERVICES.md`）**：两个 **svcd 托管、板载 `trigger=boot`** 的专项子服务——`meow_svc_perf`（性能/系统只读聚合）、`meow_svc_power`（关机/重启/升级/回 HiBy 系统动作）。launcher 电源菜单与 MeowPanel 均改经这些服务 IPC 触发（不再直连 `sys_do_reboot`/爬 `/proc`）。**IPC**：perf 走 `/usr/data/meow_perf.sock` `MSG_PERF_QUERY→RESULT`；power 走 `/usr/data/meow_power.sock` `MSG_POWER_ACTION→STATUS`（服务端 `SO_PEERCRED uid==0` 基础鉴权）。**M2.73**：perf 增 **network** 子集（SYSTEM 子集输出：真实 WiFi `wpa_cli`/`ip` + 蓝牙 `hci0`/sysfs + `hostname_local`，单点权威源）；power **升级写保护**（`upgrade` 写 mtd5 前校验卡根 `r3proii.upt` 存在+可读+常规文件+size>0，失败不写 mtd5/不重启；**只完整性不签名**，海贝官方固件无签名，期望 md5/hash 二期）与 **`dac status` 读板载 `settings.conf` 的 `audio.volume` 真实值**（`settings_get_int_trim`，弃 amixer dummy；`dac on/off` 因 cs43198 `pwr_gpio=-1` 无控制点→`MEOW_ERR_NODEV`）。新 md5：perf `7ea196de`（M2.75 补 network 闭合括号）、power `306df962`（2B 面板精确绑定）。**电源 CLI `meow_svc_power `**（root 免鉴权、单一命令、不覆盖系统 shutdown/reboot）：`shutdown`/`reboot[--hiby]`（强制回 MeowOS）/`upgrade`（写 mtd5=`ota:kernel2`，含写保护）/`set-default-meow`/`set-default-hiby` + `status`/`battery`/`reboot-reason`/`upgrade-status`/`screen on|off|timeout<秒>`/`dac on|off|status`。**二期签名鉴权已落地**（agent-185 2A / agent-221 2B）：关键 IPC 只接受 **`os.meow.*`** 签权 + `.mpk` 打包签名验签（解包验签/导出保留签名；多公钥数组 + v2 签名块）；读级命令鉴权已放宽到任意调用者（agent-189）。`[SYSTEM_FRAMEWORK_SERVICES][APPS 附录 §3][meow_svc_perf.c][meow_svc_power.c]` - 通知（SDK `meow_notify_*`，M2.53 最小版 `[meow_ui.h §9.1]`）： - 常量：`MEOW_NOTIFY_MAX_TYPES=4`/`MEOW_NOTIFY_MAX_PER_TYPE=4`/`MEOW_NOTIFY_MAX_MEDIA=1`/`MEOW_NOTIFY_TIMEOUT_ONGOING=-1`/`MEOW_NOTIFY_TIMEOUT_NEVER=0` - 分类：`CAT_GENERAL/MESSAGE/EMAIL/EVENT/PROGRESS/MEDIA(=5)/COUNT`；紧急度 `URG_LOW/NORMAL/HIGH/CRITICAL` - `meow_notify_register_type(cat)`/`meow_notify_send(const meow_notify*)`（返回 id）/`meow_notify_cancel(id)`/`meow_notify_active_count`/`count_in_type`/`has_active`/`urgency_str`/`category_str` - - **本阶段落点=SDK 内部活动表 + meow_log() 打日志**；真实投递通知中心 UI / D-Bus 是后续任务 `[meow_ui.h 注释]` -- `meow_config_*`（app 配置读写，走 meow_settings 后端）——**SDK 缺失清单第 3，未定** `[WORK_STATE]` -- `meow_media_*`（媒体会话）——**依赖阶段 D 落地，未定** `[WORK_STATE]` -- 崩溃捕获/看门狗——**规划中未定** `[WORK_STATE SDK 缺失清单 #5]` + - **通知中心 UI 已落地**（launcher 渲染，M2.65+）；**D-Bus 桥（A-14）未实现**（待后续）；真实投递走 launcher IPC `[meow_ui.h 注释]` +- `meow_config_*`（app 配置读写，走 meow_settings 后端）——**已落地**（agent-158 · `dcba597`，见 `devdocs/plan/SDK_CONFIG_API.md`）`[WORK_STATE]` +- `meow_media_*`（媒体会话）——**已落地**（agent-204 M2.81 媒体会话 + agent-206 M2.82 SDK `meow_ui_media.c` 懒连重连封装）`[WORK_STATE]` +- 崩溃捕获/看门狗——**已落地**：`meow_crash`（agent-187 · `cf86cbd` 系统级崩溃捕获 + sycd 上报）+ App 崩溃直报（agent-199）+ watchdog（应用看门狗，S89 预置）`[WORK_STATE]` - `meow_notify_dbus`（org.freedesktop.Notifications 桥）——**已定，待实现** `[FRAMEWORK_DESIGN 附录 C]` - **meow_svcd 服务管理器**（`patch_v2/meow_svcd/`，mipsel 静态 ~101KB 进固件，不入卡）`[meow_svcd.md]`： - 类 systemd/systemctl。**已接入系统启动链（M2.54）**：固件 `etc/init.d/S89meow_svcd` 开机自启（`-f` 前台 + 重挂循环，失败不死；置于 S84ssh 之后、S90meow_bootmenu 之前——因 S90 exec 引导选单阻塞 rcS）。由 bootmenu/launcher `fork/exec` + `waitpid` 托管仍为备选。 @@ -146,8 +146,8 @@ - 崩溃隔离：服务=svcd **独立子进程**（`fork+execv`），svcd 只 `waitpid`/`SIGCHLD` 感知；服务死不影响 svcd/supervisor；重启受 `backoff_ms` 退避防热循环。 - 状态机：`DISABLED/STOPPED/RUNNING/STOPPING/FAILED`；稳定运行 30s 清零 restart_count。CLI（systemctl 式，SSH 直呼）：`status/reload/start|stop|restart /pid`，示例 `meow_svcd status`/`meow_svcd restart mdnsd`/`meow_svcd stop all`/`meow_svcd reload`；控制走 AF_UNIX 单行文本 `/tmp/meow_svcd.sock`；守护默认后台，`-f/--foreground` 前台供 supervisor 托管。 - **M2.73 悬垂指针修复（md5 `da6ebc66`）**：`scan_and_reconcile` 用 `*s=tmp` 整体拷贝后，`s->argv[]` 仍指向已销毁的 `tmp` 栈帧 → `execv`/`/proc/pid/cmdline` 错乱。修法：新增 `svc_rebuild_argv(s)`，赋值/`memmove` 左移后把 `s->argv[]` 重定位到 `s->exec`/`s->argbuf` 自身成员（删除一个服务后同 tick 内被拉起不再用错位 argv）。`[meow_svcd.c]` -- **卡上外部工具 = `MeowOS/opt/`**（`{bin,nyai,sources.list}, lib/, tools/`）：MeowOS 启动时从卡加载，拔卡降级不崩。**`MeowOpt` 已废弃并入此处**；mDNS 已改为自研 `meow_mdns`（固件 `/usr/bin`），不再放卡。`[DEV_NOTES][meow_svcd.md]`。**MeowPanel 本体 = `MeowOS/opt/MeowPanel/`**（后端+前端，svcd 托管 `MeowOS/services.d/meowpanel.conf`，无卡跳过、系统核心不依赖，不进固件；md5 `11ed76ec`，详见 `patch_v2/meowpanel/README.md`）。 -- **MeowPanel（外置 TF 卡 Web 面板，M2.73 已落地）**：单进程 HTTP/JSON 后端（8080）+ 静态托管（`/`→index.html、`/assets/*`）+ `meow_svc_perf`/`meow_svc_power` IPC 客户端（读侧透传 perf 聚合、动作侧经 power）+ `settings.conf` 设置镜像（`key = value` 带空格 + 精确匹配）+ 文件白名单（`MeowOS/Music/MeowData/MeowAPPs/book`，`..` 逃逸→403）+ 应用（`nyai install/export/remove`，包名=`app.json.package`）+ 按键注入（evdev，只音量/电源/播放/上下曲，**禁返回158/主页172/确认28/退出96**）+ 日志（`MeowOS/logs`）。M2.73：系统页「以太网」→「**蓝牙**」栏（无网口有蓝牙）；**OTA 检查升级 bug 已修**（改读 `GET /api/system` 的 `ota`，不再误触 `POST /api/system/ota` 升级）。**⚠️ 无鉴权**（内网信任模型；`reboot/shutdown/ota/apps/删除/上传` 危险端点勿暴露公网，power 侧有 `SO_PEERCRED uid==0` 基础校验）。`[patch_v2/meowpanel/][devdocs/plan/MEOWPANEL_PROTOCOL.md]` +- **卡上外部工具 = `MeowOS/opt/`**（`{bin,nyai,sources.list}, lib/, tools/`）：MeowOS 启动时从卡加载，拔卡降级不崩。**`MeowOpt` 已废弃并入此处**；mDNS 已改为自研 `meow_mdns`（固件 `/usr/bin`），不再放卡。`[DEV_NOTES][meow_svcd.md]`。**MeowPanel 本体 = `MeowOS/opt/MeowPanel/`**（后端+前端，svcd 托管 `MeowOS/services.d/meowpanel.conf`，无卡跳过、系统核心不依赖，不进固件；md5 `8108852f`（nyai 路径修复）→ 阶段C 后 新 md5（见 `patch_v2/meowpanel/README.md`），详见 `patch_v2/meowpanel/README.md`）。 +- **MeowPanel（外置 TF 卡 Web 面板，M2.73 已落地，阶段 C 实时画面+遥控已落地）**：单进程 HTTP/JSON 后端（8080）+ 静态托管（`/`→index.html、`/assets/*`）+ `meow_svc_perf`/`meow_svc_power` IPC 客户端（读侧透传 perf 聚合、动作侧经 power）+ `settings.conf` 设置镜像（`key = value` 带空格 + 精确匹配）+ 文件白名单（`MeowOS/Music/MeowData/MeowAPPs/book`，`..` 逃逸→403）+ 应用（`nyai install/export/remove`，包名=`app.json.package`，`nyai` 固件内置 `/usr/bin/nyai` 优先+卡上回退）+ 按键注入（evdev，只音量/电源/播放/上下曲，**禁返回158/主页172/确认28/退出96**）+ 日志（`MeowOS/logs`）。M2.73：系统页「以太网」→「**蓝牙**」栏（无网口有蓝牙）；**OTA 检查升级 bug 已修**（改读 `GET /api/system` 的 `ota`，不再误触 `POST /api/system/ota` 升级）。**M2.78+ 新增**：可选密码鉴权（agent-196，默认关）、通知中心后端 `/api/notifications`（TF 归档环形 200 条）、文件域 4 bug 修复 + 上传 8MB 上限 + 双重白名单（agent-182）**。**M2.84-88 阶段 C**（agent-224）：`/api/screen.jpeg`（fb0 活动帧→自研 JPEG 编码器）+ `/api/input/tap`（坐标注入，本机触摸优先 5s 仲裁）+ 屏幕增量帧 `?delta=1`（8x8 块比对，近静态 27KB→804B，agent-234）+ `/api/notifications` 实时化（优先 IPC 读 launcher 活跃集 source:ipc，agent-234）。**⚠️ 鉴权默认关**（内网信任模型；`reboot/shutdown/ota/apps/删除/上传` 危险端点勿暴露公网，power 侧有 `SO_PEERCRED uid==0` 基础校验）。`[patch_v2/meowpanel/][devdocs/plan/MEOWPANEL_PROTOCOL.md]` - **mDNS 应答器 = `meow_mdns`（自研，已拍板替代完整 mdnsd）**：`mips-repo/bins/meow_mdns/`，**IPv4-only**（内核无 IPv6，完整 mDNSResponder/SAResponder 均 `socket(AF_INET6)` 失败），mipsel 静态 ~79KB（md5 b23de7ce）。**进固件 `/usr/bin/meow_mdns`**（不入卡），由 meow_svcd 托管（板载 `/usr/data/meow/services.d/mdnsd.conf`，`trigger=boot`、root 即可绑 5353/组播，`cap=` 空）。功能：join `224.0.0.251:5353`，应答 `.local` A（wlan0 IPv4）/`_ssh._tcp` PTR/SRV/TXT/`_services._dns-sd` PTR；支持 `MEOW_MDNS_HOST`/`_ADDR`/`_PORT`/`_TTL`/`_CF`/`_QD`/`_MCAST`/`_MIF`/`_DBG`。⚠️ **手机热点隔离**：设备→主机组播被热点丢弃，avahi 只收组播应答 → 该热点下 `avahi-resolve .local` 超时（网络层限制，非应答器缺陷），主机需 DNS 兜底 `[mips-repo/bins/meow_mdns/manifest.md][meow_svcd.md]`。 - `meow_settings_*`（设置后端，已定）/`meowcli`/`meow_sys_devattr`/`meow_devattr_set` `[MEOWOS_API]` - 后台权限：`MSG_HELLO/MSG_REGISTER.flags` 扩展 `MF_BACKGROUND`/`MF_PLAYBACK`；`PERF_BACKGROUND`/`PERF_AUDIO_BACKGROUND`（规划）`[FRAMEWORK_DESIGN 附录 A]` @@ -165,7 +165,7 @@ - **全屏机制（M2.5x，`app.json fullscreen` 即 app 级 + `route..fullscreen` 即 activity 级）**：launcher 启动 app/切 activity 时据声明**预先设 SDK 全屏**（env `MEOW_FULLSCREEN`）。进入/退出全屏：**状态栏向上收出屏顶、只留一条提示线高度**（非全隐藏），带上收/恢复的**自然过渡动画**。**全屏下保留**：左缘返回手势 + 顶部动态伸缩提示线；顶部下滑仍可展开通知中心，但**顶部热区缩小**（不影响全屏 app）`[源:用户 2026-08-30]`（细化既有「全屏=隐藏状态栏/隐藏返回键」的表述，见 §7 A-13） - 沉浸：`app.json immersive:1` → launcher 写 `/tmp/meowapp_state=1` → 隐藏虚拟返回键，手势归 SDK `[APPS §3.5][GESTURE_BACK §2.4]` - **横向分页设计模板（M2.5x 预留，见 `MEOW_APP_SDK.md` §5.2）**：主页/子页多页横向滑动复用的设计模板（参照 HibyOS 播放器主页横划进播放页）。与左缘返回/顶部下滑**按起始位置分流**互斥——左缘 ≤热区→**左滑返回**（§5.1）；中部左/右滑→**页切换**；顶部下滑→**通知中心**。实现要点：相邻页各预渲染一张快照、切换只 blit 快照 + 跟手平移/吸附（vsync ≤60 帧、零 UI 重算）。**注**：模板 API 为「草案/待定案」，当前未实现 `[源:2026-08-30]` -- **SDK 可复用设计模板清单（M2.5x 预留，见 `MEOW_APP_SDK.md` §5.3）**：把反复出现的界面结构抽象为可复用设计模板——①**分组设置表单** ②**列表+选择** ③**弹窗/对话框** ④**顶/底下拉面板**（A+B 先行，已展开 §5.4-§5.7）+ 媒体播放/沉浸/加载（C）、卡片/导航/列表项（D，随 app/MD3 细化）、拖拽排序/长按菜单/时间轴（E，后置），共 11 项；横向分页另见 §5.2。**所有模板与既有手势约定一致**：左缘返回 + 顶部滑条 + 状态栏收合 + 通知中心热区（本 §5.1/§3.1/A-13）——模板只在内部做命中分流，**不重定义全局手势**；顶部/底部面板与左缘返回/通知中心按起始位置与触达途径分流互斥（快捷设置触达途径为**待定案**）。**注**：A①②/B③④ 模板 API 均为「草案/待定案」，当前未实现 `[源:2026-08-30]` +- **SDK 可复用设计模板清单（M2.5x 预留，见 `MEOW_APP_SDK.md` §5.3）**：把反复出现的界面结构抽象为可复用设计模板——①**分组设置表单** ②**列表+选择** ③**弹窗/对话框** ④**顶/底下拉面板**（A+B 先行，已展开 §5.4-§5.7）+ 媒体播放/沉浸/加载（C）、卡片/导航/列表项（D，随 app/MD3 细化）、拖拽排序/长按菜单/时间轴（E，后置），共 11 项；横向分页另见 §5.2。**所有模板与既有手势约定一致**：左缘返回 + 顶部滑条 + 状态栏收合 + 通知中心热区（本 §5.1/§3.1/A-13）——模板只在内部做命中分流，**不重定义全局手势**；顶部/底部面板与左缘返回/通知中心按起始位置与触达途径分流互斥（快捷设置触达途径为**待定案**）。**注**：A①②/B③④ 模板 API 原为「草案/待定案」。**部分已落地**：B② 列表+选择 → 结构化列表控件 `W_LISTVIEW`（M2.76 agent-186）；A① 分组设置表单、B④ 顶/下方面板 已在设置页/通知中心/电源菜单以 launcher 侧实作（非独立公开 SDK 模板 API）；视图框架（`meow_ui_view.c` M2.76+）与控件库已覆盖其多数能力，其余（横向分页、C/D/E）仍为草案 `[源:2026-08-30]` ### 5.2 主题 - **日/夜/自动**：SDK `meow_theme` 内置 `meow_theme_light/dark`；模式键 `display.theme_mode`（SYSTEM_SETTINGS 记为 `manual`/`auto`——**与 SDK 枚举 light/dark/auto 冲突**，见 §A）；AUTO 判时段 `[SYSTEM_SETTINGS §1][MEOW_APP_SDK §8]` @@ -203,7 +203,7 @@ - **⑨ 面板「跟手下拉、半程可回」（launcher 侧，M2.65）**：面板打开/关闭由触发式 180ms 过渡升级为**手指拖动实时跟手**——顶部热区下拉 `progress = 手指位移映射`（复用 `mnp_anim_off`，∈[0,1024]，1:1 跟手）；松手 `progress≥40%×1024≈410` → 时间轴补到 1024（展开）；`<阈值 或 反向拖回` → 回弹到 0 收回（半程取消）；关闭同理可跟手。与行左滑（⑦ 横向主导）/列表滚动（竖向溢出）/`meow_edge_back`（左缘）互斥分流。`[NOTIFICATION_SYSTEM §9]` ### 5.4 配置版本单点 / 刷新率 / 息屏 -- **现行：M2.73（`/etc/meowos_version` = `0.7.68`，已推卡真机验收；M2.74 / 0.7.69 待打）（M2.72/0.7.67、M2.71/0.7.66、M2.70/0.7.65、M2.69/0.7.64 …）**；版本单点 = `/etc/meowos_version`（见 §1.1，`build_fw_apps.sh -v` 写入）`[DEV_NOTES #4][fw_content.conf]` +- **现行：M2.88（`/etc/meowos_version` = `0.7.83`，已刷+热更；M2.87/0.7.82、M2.83/0.7.78、M2.82/0.7.77、M2.79/0.7.74、M2.78/0.7.73、M2.77/0.7.72、M2.76/0.7.71、M2.75/0.7.70、M2.74/0.7.69、M2.73/0.7.68、M2.72/0.7.67、M2.71/0.7.66、M2.70/0.7.65、M2.69/0.7.64 …）**；版本单点 = `/etc/meowos_version`（见 §1.1，`build_fw_apps.sh -v` 写入）`[DEV_NOTES #4][fw_content.conf]` - 刷新率：`display.refresh_rate` enum 60/30/15（默认 60）；`display.refresh_always_max` bool false（关=允许 60→30→15 降档）。governor：连续 12 帧超预算降一档，连续 4 批≈48 帧远低预算升一档 `[SYSTEM_SETTINGS §1][PERF_SCHEDULER][MIGRATION_AC §12.1]` - 息屏：`display.screen_off_timeout` int 秒 默认 **30**（0=常亮）；`display.screen_off_mode` enum `panel`(面板下电+背光0+FBIOPBLANK)/`black`(背光0全黑+双击亮屏) `[SYSTEM_SETTINGS §1]` - 亮度 clamp：`display.brightness` 0-255 默认 101（clamp ≥ `display.brightness_min`）；`display.brightness_min` 默认 **1**（M2.39 由 25 改 1）——**与旧文档 25 冲突见 §A** `[SYSTEM_SETTINGS §1]` @@ -340,9 +340,9 @@ --- ## 6. 标志性 TODO / 未决（文档未定，勿凭猜实现） -- OPEN_QUESTIONS.md 待定 ❓：#1 背景图加载时机/缓存、#2 非 480×720 图如何处（拉伸/裁剪/回退）、#3 叠加层颜色联动、#4 背景色板具体枚举、#5 浅色主题文字对比度、#7 首期是否做应用图标、#8 通知来源（**最大空白**，M2 已定为 系统+IPC+D-Bus 三路）、#9 下拉手势 vs 左滑返回区分、#10 通知存储上限/FIFO、#11 媒体活跃会话判定、#12 多 app 音频混音/焦点、#13 web 实时画面 JPEG/WS、#14 远程输入注入仲裁、#16 主页左滑=侧边栏 vs 返回 `[OPEN_QUESTIONS]` -- DEVELOPMENT_PLAN：阶段 0（bootmenu 双系统）**待实现**（M0-M4）；阶段 B/E/F；M2-M6 阶段 D 里程碑未做 `[DEVELOPMENT_PLAN]` -- 未定/待拍板：`meow_config_*`/`meow_media_*`/崩溃捕获（见 §4）；MeowOS 音频输出设置（只读还是可配）；OTA 依赖 MeowPanel `[WORK_STATE][OPEN_QUESTIONS #17/#18]` +- OPEN_QUESTIONS.md 待定 ❓：多数已由后续定案/落地覆盖——#1 背景图加载（「启动加载一次+预渲染快照不每帧缩放」已落地）、#2 图处理（**cover 居中裁剪**）、#3 叠加层颜色（**固定跟明暗主题**）、#7 应用图标（**已做，app.json icon 加载缓存+首字母占位**）、#8 通知来源（**系统事件 + MeowAPP IPC + D-Bus 桥 三路**，中心 UI 已落地）、#9 下拉手势（**顶部下滑=通知中心**，与左滑返回按起始位置分流）、#10 通知存储（**TF 归档 CSV + 10MB 滚动 + 环形 200 条**）、#11 媒体活跃会话（**active_seq 最近活跃源，30s 超时回收**）、#12 多 app 音频（**App 直开 hw:0,0，不做混音**）、#13 web 实时画面（**`/api/screen.jpeg` + 增量帧**）、#14 输入注入（**本机触摸优先 5s 仲裁**）、#16 主页左滑=侧边栏 vs 返回（**Now Playing 横划页，左缘返回保留**）。**仍待定**：#4 背景色板枚举、#5 浅色文字对比度 `[OPEN_QUESTIONS]` +- DEVELOPMENT_PLAN：**阶段 0（bootmenu 双系统）已落地（现网即运行中）**；阶段 B/E/F 达成；阶段 D M0-M3/M5 已落地、**M4 后台服务保活 / M6 加固 待排期** `[DEVELOPMENT_PLAN]` +- 未定/待拍板：MeowOS 音频输出设置（只读还是可配，OPEN_QUESTIONS #17）；OTA 在线「检查更新/下载」依赖 MeowPanel（本地/检查升级已可用，URL 下载待定案 #18）`[WORK_STATE][OPEN_QUESTIONS #17/#18]` - **meow_svcd 后续（M2.54 已落地大部分）**：~~接入 supervisor 启动链~~（已改 `etc/init.d/S89meow_svcd` 开机自启；bootmenu/launcher `fork+exec`+`waitpid` 仍为备选）；~~写 `MeowOS/services.d/mdnsd.conf` 落地 mDNS~~（已改**板载** `/usr/data/meow/services.d/mdnsd.conf` 预置，`trigger=boot`）。剩余：`cap` setcap 真机实装（cap_net_bind_service,cap_net_raw）；`wifi-up` 判定收紧。**services.d/svcd 已接入开机链（S89）**，但真机行为待验证。 `[WORK_STATE][meow_svcd.md]` ---