docs(repo): 仓库公开文档同步到 M2.73/0.7.68 + 修 fw_content.conf 过期 md5(meow_svcd da6ebc66/meow_svc_perf fa073bf9, 否则打包 md5 强校验失败中止) (agent-171)

MEOW_APP_SDK.md

@@ -82,6 +82,8 @@ void meow_ui_fill_rect_alpha(int x, int y, int w, int h, uint32_t color, int alp
 
 > 说明：`meow_ui_text_*` 底层即 `meow_font_drawtext` + `meow_font_width_text`；`meow_ui_fill_rect_alpha` 复用 `blend565`。**模糊/毛玻璃不在 B1 承诺**（硬件无 GPU、CPU 软渲；仅在静态小区域可考虑，见 §7）。
 
+> **M2.73 渲染残影/脏区修复（以 `meow_ui_widget.c` / `meow_ui_ime.c` / `hello_app/hello.c` 为准）**：① **局部刷新不再「清底 + 只重画触发控件」**，改为按 z 栈重画刷新区内的完整控件序列（`d_paint_region`，见 §5.8.6/§5.1）——避免「重叠区里上层浮层被下层动态控件（如进度条）实时重绘时清掉/盖住」；② **IME/面板类全屏叠加控件关闭时做背景快照/恢复**（`ime_capture`/`ime_restore`），根治关闭后屏底残留像素；③ `W_LIST` 视口裁剪（只画视口内行/分隔线/文本），根治滚动时标题栏/底部脏区。
+
 ### 3.1 全局状态栏（系统级组件，A+C 方案并入）
 
 **定位**：状态栏是**系统级全局组件**，由 SDK 统一绘制——所有界面（launcher 菜单 + MeowAPP 画面）默认都显示，**仅由 SDK 运行时 `meow_ui_set_fullscreen(1)` 控制隐藏**（`fullscreen` 字段**未在 app.json 解析**，已定未做，见 §3.1 注 [源:审计 2026-08-30]）。数据由 SDK 内置状态读取器抓系统快照（与 launcher 同源单点一致），非各画各的。
@@ -209,6 +211,8 @@ const char *meow_ime_text(void);
 
 **[B1 后续 / 不阻塞]**：中文拼音 IME、词库、候选词联想、剪贴板、长按重复——作为独立里程碑，等首个中文输入场景（网易云搜索）出现再做。
 
+> **实现对齐（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 / 物理键辅助 / 候选区」为设计稿表述，已按实际覆盖。
+
 ---
 
 ### 5.2 横向分页（横向滑动切换页面）设计模板  [源:2026-08-30]
@@ -689,6 +693,10 @@ meow_widget *meow_layout_spacer(int w, int h);
 
 > **说明**：多数 Material 组件是**既有设计模板（§5.2-§5.7）的「MD3 观感化」**——如 Card=圆角容器、BottomSheet 复用 §5.7 面板、Dialog 复用 §5.6 弹窗、TabBar 联动 §5.2 分页、列表容器复用 §5.5 listview。故 Material 子集**不重复造结构**，只把这些模板的绘制观感对齐 MD3 语义色 + 统一基座。**第二批已实现（M2.71/0.7.66，见 §5.8.8）**。
 
+> **M2.73 修复（以 `meow_ui_widget.c` / `hello_app/hello.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）」。**⚠️ 暂注**：此方案当前在 **App（hello）侧**实现，属**示范/落地点**；**SDK 级全局 z 序（框架统一管理层间重绘顺序）仍待评估，未正式纳入 SDK 公共 API**——在落定前请勿把「全局 z 序」写成正式规范，App 自定义绘制如需 z 序要参照 `d_paint_region` 自行重画完整栈。
+
 #### 5.8.7 取舍 / 不做（移植思想而非照搬）
 
 > **关键（防照搬桌面 UI 框架踩坑）**：本层是**软渲 + 无 GPU + 无鼠标 + 14MB 内存/极简 rootfs** 的嵌入式环境（§11）。移植 Compose/Flutter 的**思想**（组合/状态驱动/语义色），**不照搬其运行时**：