docs: 全项目文档一致性审计同步 (agent-237) — README/FRAMEWORK_DESIGN/SDK/APPS/PLAN/SETTINGS/SPEC_REF 对齐 M2.88 现状(amsd/picker/签名2B/拼音IME/面板阶段C/ncm改名dev.player.ncm等),过期「未实现」表述按落地实况修正
This commit is contained in:
MeowOS committed
1 parent
d76f8bc4ba
commit
49c31f1901
7 files changed
+42
-36
No files matched your search
+7
-4
@@ -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 <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 导航+前台会话改造+看门狗返回**、**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。
|
||||
|
||||
Reference in new issue
Block a user