docs: 全量文档同步到 M2.83 (agent-213) — README 能力全景/框架文档消息号+M3M5落地标注/SDK listview+长按+§10.5已实现标注/APPS version_code+媒体键路由/DEVELOPMENT_PLAN 主线进度; devdocs(WORK_STATE/RECOVERY_PROMPT/DEV_NOTES)本地同步

FRAMEWORK_DESIGN.md

@@ -47,16 +47,24 @@ struct ipc_hdr {  /* LE */
 | 0x0021 | MSG_NOTIFY_ACK | ↓ | 落库结果 |
 | 0x0022 | MSG_NOTIFY_DISMISS | ↑ | 撤下通知 |
 | 0x0023 | MSG_NOTIFY_LIST | ↓ | 下发通知清单（重同步） |
-| 0x0025 | MSG_NOTIF_OPEN | ↑ | **（拟，号待 `meow_ipc.h` 回填）** App 检测到顶部下滑→请求 launcher 展开通知中心叠加会话（App 前台，见 §10.5） |
-| 0x0026 | MSG_NOTIF_CLOSE | ↑ | **（拟，号待 `meow_ipc.h` 回填，可选用途）** App 告知结束/退出→launcher 收尾兜底（见 §10.5） |
+| 0x0024 | MSG_NOTIFY_PROGRESS | ↑ | 实时更新通知进度（仅改内存活跃槽，不落盘） |
+| 0x0025 | MSG_NOTIFY_QUERY | ↑ | 查询内存活跃通知集（MeowPanel 实时化前置） |
+| 0x0026 | MSG_NOTIFY_DISMISS_ALL | ↑ | 一键清除（保留 ongoing/media/progress 进行中，同通知中心 UI） |
+| 0x0027 | MSG_NOTIFY_QUERY_RESULT | ↓ | 活跃通知集序列化文本（JSON，字段同 TF 归档） |
+| 0x0028 | MSG_NOTIF_OPEN | ↑ | **（已实现，号以 `meow_ipc.h` 为准）** App 检测到顶部下滑→请求 launcher 展开通知中心叠加会话（App 前台，见 §10.5） |
+| 0x0029 | MSG_NOTIF_CLOSE | ↑ | **（已实现，可选用途）** App 告知结束/退出→launcher 收尾兜底（见 §10.5） |
 | 0x0030 | MSG_ACT_DECLARE | ↑ | （重）声明路由表 |
 | 0x0031 | MSG_ACT_QUERY | ↑ | 解析 activity 链路 |
 | 0x0032 | MSG_ACT_RESULT | ↓ | 返回链路 |
-| 0x0040 | MSG_NAV | ↑ | 上报导航/请求退出 |
+| 0x0040 | MSG_NAV | ↑ | 上报导航/请求退出（**M3 导航栈已落地**） |
 | 0x0041 | MSG_SHOW_ACTIVITY | ↓ | 令前端应用显示某屏 |
+| 0x0070 | MSG_PICKER_CALL | ↑ | 请求跨 App picker 调用（发起方 A → 持有方 B；**仅预留协议位**，本期不实现） |
+| 0x0071 | MSG_PICKER_RESULT | ↓ | picker 返回值（候选结果回 A；仅预留协议位） |
+| 0x0072 | MSG_META | ↑ | 媒体会话上报元数据/进度/状态（**附录 B 已落地**，最近活跃源回收） |
+| 0x0073 | MSG_PLAYCTL | ↓ | 播放控制下发 / ↑ 控制器转发到最近活跃媒体会话（**已落地**） |
 | 0x00F0 | MSG_SYS | ↓ | 系统事件（守护关闭/服务死亡/播放器状态） |
 
-负载结构体见设计稿正文（m_hello/m_notify/m_register/m_act_* 等，定长多字节 LE）。
+负载结构体见设计稿正文（m_hello/m_notify/m_register/m_act_* 等，定长多字节 LE）。消息号**一律以 `patch_v2/meow_launcherd/meow_ipc.h` 为准**，本节为引用性摘要。
 
 ## 2. Activity 路由表
 
@@ -70,7 +78,7 @@ struct ipc_hdr {  /* LE */
 
 ## 3. 导航栈
 
-- `struct nav_stack`（每应用一个，≤16 深度），`active` 前台标记。v1 同一时刻单前台应用。
+- `struct nav_stack`（每应用一个，≤16 深度），`active` 前台标记。v1 同一时刻单前台应用。**（M3 已落地，M2.80：`nav_stack` + `MSG_NAV` report/exit + `launch_activity` 链路注入 env `MEOW_ACTIVITY`/`MEOW_CHAIN`，栈根退出回主屏；通知点击按 `route_status`：0 拉起 / 1 NO ROUTE / 2 SOURCE NOT FOUND / -1 NONE 关面板不动作；裸 App 兼容。）**
 - push/pop；**回退**：应用弹自己的屏并上报 `MSG_NAV{REPORT,depth,current}`；应用在根屏再按返回→`MSG_NAV{EXIT}`→启动器终止应用、恢复播放器、回列表。
 - **冷启动通知跳转**：`resolve_chain` → 设栈深 → `launch_activity(app, chain)`，环境 `MEOW_ACTIVITY=<target>` + `MEOW_CHAIN=<id0>;<id1>;...;<top>`。
 - 向下兼容：应用若不发 MSG_NAV，启动器保持初始深度；应用在根屏 `exit(0)` 即退出到列表（旧版行为）。
@@ -107,7 +115,10 @@ M0 IPC 骨架（含 meow_ipc 测试钩子）→ M1 路由表+解析 → M2 通
 ### 进度（阶段 D）
 - ✅ **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 <path>]`。验证：`meow_ipc hello`→ACK、播放器不动（MeowOS 模式下无播放器即满足）。
 - ✅ **M1 路由表 + 解析**（0.7.10，M2.15）：`app.json` 扁平行 `route.<id>=path` / `framework=true` / `service.<svc>=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 <app> <activity>` 返回链路（qemu + 真机 MeowOS 模式均通）。
-- ⬜ **M2 通知存储+分发**、**M3 导航+前台会话改造**、**M4 后台服务保活**、**M5 通知中心 UI**、**M6 加固**：后续里程碑，本轮未做。
+- ✅ **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 兼容。
+  - **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。
 - 测试钩子说明：`meow_launcherd --appinfo <app.json>`（打印单个 app.json 解析结果）、`--ipc-only N`（免 fb/输入跑 IPC）、`--ipc-sock <path>`（覆盖 socket 路径供 qemu sim）；`meow_ipc hello|ping|query|declare`（客户端）。
 
@@ -202,7 +213,7 @@ meow_sysui（系统进程总监，meow_svcd 托管；最小依赖/不渲染/最
   - `MSG_NOTIF_OPEN`（App→launcher）：App 检测到顶部下滑→请求展开通知中心叠加会话；负载 `m_notif_open_t`
     （app_id/event_seq/origin_x/origin_y/hotzone/flags）。launcher 回 `MSG_ACK` 受理（best-effort，App 不强依赖）。
   - `MSG_NOTIF_CLOSE`（App→launcher，可选用途）：App 告知结束/退出→launcher 收尾（清 active/SIGCONT 兜底）。
-  - 号段/结构以 `meow_ipc.h` 回填为准（拟 `0x0025/0x0026`，见 §13 决策点）。
+  - 号段/结构以 `meow_ipc.h` 回填为准。**已实现（M2.82，agent-206 · 9b41957）**：`MSG_NOTIF_OPEN=0x0028` / `MSG_NOTIF_CLOSE=0x0029`（`0x0025/0x0026` 已被通知查询/清除 IPC 占用）；SDK 侧 `meow_ui_nav`/`meow_ui_media` 封装同步落地，顶部下滑手势→IPC、launcher SIGSTOP→读帧→叠加→接管输入→SIGCONT（面板内 App 崩溃即关）。
 - **launcher 叠加会话（复用电源菜单对 App 的冻结模板）**：收到 `MSG_NOTIF_OPEN`（且当前在 App 前台会话，
   `launch_app` waitpid 循环内）→ **SIGSTOP App** → 读回 App 帧（`memcpy` fb0 buffer0 → back_buf，App 帧恒
   buffer0 不走 `fb_backup_player`；同 `pm_capture_app_frame`）→ 写 `/tmp/meow_notif_active`（同