M2.60→M2.61 骨架: SDK Activity 栈 + 控件归属(agent-122) + 按钮去圈/即时重绘(agent-119) + SDK 模板文档(agent-121)

- SDK §6.1 三层控件模型: Activity栈(push/pop/active) + 页面控件归属 owner + meow_ui_global_* 骨架(②) + 系统级仅内部接口(③)
- meow_widget 加 owner; live_btn_hit/meow_widget_hit 仅 active activity 命中; touch_refresh stale 保护
- 根治"全屏页触摸主页按钮闪现"(跨页面控件残留); 控件对象复用弹栈不重建
- hello 迁移双 Activity(home/full): 全屏左滑=弹栈回主页, 根左滑=退出
- agent-119 按钮去圈(纯色accent+黑12/24%)+即时局部重绘保留; agent-121 SDK模板§5.3-5.7

patch_v2/sdk/meow_ui.h

@@ -156,6 +156,43 @@ void meow_ui_request_exit(void);              /* 请求退出（相当于返回/
  * x<=0 时清掉此前画的条（填回背景色）。不发 flush，由调用方 meow_ui_flush_region 上屏。 */
 void meow_ui_swipe_hint(int x);
 
+/* ============================================================ */
+/* §6.1 控件生命周期与归属（Activity 栈 + 三层控件模型） [源:2026-08-30] */
+/* ============================================================ */
+/* 根治「跨页面控件残留」：控件命中/绘制必须严格绑定其所属页面，否则会出现
+ * "按钮已不可见但仍被触摸命中"（如全屏页触摸到主页按钮位置闪现 accent 底）。
+ *
+ * 三层职责（从 App 到系统，风险从低到高）：
+ *   ① 页面控件：归属唯一 owner Activity；命中/实时按压只在「当前 active Activity
+ *      的控件集」里生效。对象不销毁（同 Activity 内复用），弹栈回来自动恢复 →
+ *      回页面零重建。
+ *   ② App 跨 Activity 控件（SDK 托管）：钉在 App 的 Activity 栈之上、跨 Activity 常驻，
+ *      逻辑/渲染由 SDK 调度。本轮为「可用骨架」（见上 API 注释），待 B2 细化。
+ *   ③ 系统级控件（状态栏/通知中心/返回滑条/电源菜单）：仅框架内部，无公共 API（不开放）。
+ *
+ * 触摸命中分流顺序：③ 系统全局 → ② App 全局 → ① 当前 active Activity 页面控件；
+ * 某层命中即消费，否则落到下一层。 */
+
+/* ① Activity 栈。控件创建时绑定「当前 active Activity」为 owner；弹栈回来自动恢复。
+ * 栈空时 active() 返回 0（根/default Activity），故未显式管理栈的 App 默认所有控件
+ * 归属根 Activity 0。push 新 Activity（进子页/全屏）、pop 回上级（回根）。 */
+void meow_ui_activity_push(int id);
+void meow_ui_activity_pop(void);
+int  meow_ui_activity_active(void);            /* 当前 active activity id（栈空=0） */
+
+/* ② App 跨 Activity 控件（SDK 托管，骨架）。SDK 维护全局控件列表：
+ *   - 渲染：每帧（有脏区需上屏时，meow_ui_gfx present()）在 active activity 内容之上、
+ *     全局状态栏之下调用 render_cb（跨 Activity 常驻）；
+ *   - 触摸：TAP 先给 global hit_cb（返回 1=消费），否则落到 active activity 页面控件。
+ * 逻辑/渲染由 SDK 调度，App 只需声明。注：骨架，待 B2 细化。 */
+typedef void (*meow_global_render_fn)(void *ctx);   /* 每次渲染帧回调（SDK 调用） */
+typedef int  (*meow_global_hit_fn)(void *ctx, int x, int y); /* 命中返回1=消费 */
+void meow_ui_global_add(int id, meow_global_render_fn r, meow_global_hit_fn h, void *ctx);
+void meow_ui_global_remove(int id);
+
+/* ③ 系统级控件：状态栏/通知中心/左缘返回滑条/电源菜单等全局叠加层——仅 SDK 内部接口，
+ * 不向用户 App 开放任何公共悬浮/叠加层 API。既有状态栏/返回滑条逻辑（§3.1）不动。 */
+
 /* ============================================================ */
 /* §3.1 全局状态栏 / 全屏（A-0，SDK 系统级组件） */
 /* ============================================================ */