docs: 仓库文档同步 M6.4(0.8.4)——README 版本行+新能力(SDK 演进批次/锁屏 PIN/面板批2+overview 自校验)；SPEC_REF 补 SDK §3.5 扩展模块速查+system.pin 锁屏键+面板 batch2/UTF-8 加固

README.md

@@ -3,7 +3,7 @@
 > 把 HiBy R3 Pro II 便携播放器（君正 X1600，MIPS32r2 / mipsel / musl 静态软浮点，480×720，无 GPU 软渲染）变成一个可扩展的「第二系统 + 应用框架」。
 > MeowOS 与官方 HibyOS 共存于同一台设备：开机由引导选单二选一；启动后 MeowOS 作为主控层，提供自己的桌面 UI、应用框架、服务管理与系统组件。
 >
-> 版本：**M6.0（0.8.0，已自刷验收）**（M6.1 备料全齐——netmgrd 期3/powermgr 期2/面板 PIN 鉴权+首页仪表盘/WiFi 录入 UI/服务名统一 meow_*，待打包自刷；历史：M2.69→M2.96 全链路自刷验收：控件库/主界面 MD3 双布局/M3 导航栈/M5 通知跳转/媒体会话/Now Playing/SDK nav+media 封装/字库启动竞态修复**/M2.84-88**：installed 图标修复+残帧pan加固/物理键EVIOCGKEY双源/签名鉴权 2B/meow_route 音频路由/amsd 二期(picker 契约)/流媒体客户端二期(封面·歌词后台·大歌单分页)/MeowPanel 实时画面+遥控+通知实时化/中文拼音 IME**/M2.89**：开机选单抢屏回归修复+watchdog SIGUSR1 不误杀框架 App+amsd 失联修复+顶部下滑手势分流**/M2.90**：**meow_audiod 独占音频守护**（AUDIOD_DESIGN，meow_route 并入退役）+MIUIx 顶级主题+流媒体客户端文案中文化+面板字体库 tar.gz 导入导出**/M2.91-96**：audiod 开机武装 hbc3000 FPGA（根治 PCM 启动内核死锁）+svc_power 充电态权威链(mp2731)+amsd 注册自愈（`am rescan`）/Now Playing 死循环修复+状态栏充电闪电+插孔消抖（三路）/audiod 长流护栏+ALSA 几何收窄 period=1024×4（根治长流停摆）+watchdog 音量存盘毁设置修复/音量反转四路统一（CS43198 寄存器=衰减量，`dac=255-pct*255/100`）+炸耳安全修复（dac_vol_mute 写 255 真静音）；**M6.0-6.1**：网络管理服务 **meow_netmgrd** 期1-3（接口统一层+连接普查三实体+DNS 代理+策略引擎防自锁+WiFi 录入 UI）+功耗管理服务 **meow_powermgr** 期0-2（查看/功耗分解 top/历史/事件/mp2731 实测充电功率）+MeowPanel 增强（4 位 PIN 鉴权+首页仪表盘/电源页/进程服务页）+服务名统一 meow_*（audiod/mdnsd→meow_audiod/meow_mdns））。版本号单点 = 板上 `/etc/meowos_version`，见「构建」。本仓库是一个**自带 SDK、包管理、媒体会话、独占音频服务、网页面板、流媒体客户端的完整第三方系统**。
+> 版本：**M6.4（0.8.4，已自刷验收）**（M6.1→M6.4 全链自刷验收——**M6.1**：netmgrd 期3/powermgr 期2/面板 PIN 鉴权+首页仪表盘/WiFi 录入 UI/服务名统一 meow_*；**M6.2**：锁屏 PIN 全量（`system.pin` 同源面板）+VOL_DOWN×3 框架门控+显示名 name[49]（amsd/launcher UTF-8 整序列截断）；**M6.3**：设置页 5s 修复（309 网络异步步骤机+跳过字体 sha 校验）+310 锁屏三连（输入穿透/解锁状态栏消失/App 死亡残影）；**M6.4**：310 二期 **EVIOCGRAB 锁屏独占触控**（未冻结 App 锁屏输入隔离）+主界面应用名截断；历史：M2.69→M2.96 全链路自刷验收：控件库/主界面 MD3 双布局/M3 导航栈/M5 通知跳转/媒体会话/Now Playing/SDK nav+media 封装/字库启动竞态修复**/M2.84-88**：installed 图标修复+残帧pan加固/物理键EVIOCGKEY双源/签名鉴权 2B/meow_route 音频路由/amsd 二期(picker 契约)/流媒体客户端二期(封面·歌词后台·大歌单分页)/MeowPanel 实时画面+遥控+通知实时化/中文拼音 IME**/M2.89**：开机选单抢屏回归修复+watchdog SIGUSR1 不误杀框架 App+amsd 失联修复+顶部下滑手势分流**/M2.90**：**meow_audiod 独占音频守护**（AUDIOD_DESIGN，meow_route 并入退役）+MIUIx 顶级主题+流媒体客户端文案中文化+面板字体库 tar.gz 导入导出**/M2.91-96**：audiod 开机武装 hbc3000 FPGA（根治 PCM 启动内核死锁）+svc_power 充电态权威链(mp2731)+amsd 注册自愈（`am rescan`）/Now Playing 死循环修复+状态栏充电闪电+插孔消抖（三路）/audiod 长流护栏+ALSA 几何收窄 period=1024×4（根治长流停摆）+watchdog 音量存盘毁设置修复/音量反转四路统一（CS43198 寄存器=衰减量，`dac=255-pct*255/100`）+炸耳安全修复（dac_vol_mute 写 255 真静音）；**M6.0-6.1**：网络管理服务 **meow_netmgrd** 期1-3（接口统一层+连接普查三实体+DNS 代理+策略引擎防自锁+WiFi 录入 UI）+功耗管理服务 **meow_powermgr** 期0-2（查看/功耗分解 top/历史/事件/mp2731 实测充电功率）+MeowPanel 增强（4 位 PIN 鉴权+首页仪表盘/电源页/进程服务页）+服务名统一 meow_*（audiod/mdnsd→meow_audiod/meow_mdns））。版本号单点 = 板上 `/etc/meowos_version`，见「构建」。本仓库是一个**自带 SDK、包管理、媒体会话、独占音频服务、网页面板、流媒体客户端的完整第三方系统**。
 >
 > 许可证：Apache-2.0（见 [`LICENSE`](LICENSE)）。本仓库为非官方第三方项目。
 >
@@ -79,7 +79,8 @@ init (rcS)
 - **状态栏（统一系统进程渲染）**：由 launcher 作为**唯一渲染主体**（主界面与 App 前台用**同一个**状态栏实例，App 不画、不做「样式一样的两套实现」）；右侧 **MD3 图标 + 变量值**（时钟/电量/WiFi/蓝牙/音量，数据源唯一由 launcher 统一喂/取，两边必然一致）；**全屏收合**：状态栏向上收出屏顶、只留提示线，**顶部保留 28px 热区**（仍可下滑通知中心）+ 左缘指示条；随主题 `ui.style` 换图标集。
 - 通知中心（顶部下滑展开，launcher 渲染，功能见 §2.6）；
 - 电源菜单、全局左缘返回手势、全屏提示线；
-- 主界面（应用列表）、设置页。
+- 主界面（应用列表）、设置页；
+- **锁屏（M6.2 起）**：`lock_screen.c` 4 位 PIN（`system.pin` 同源面板 sha256+salt）+ 息屏唤醒锁 `system.pin_lock_on_wake` + 错 5 锁 5 分钟持久化 + 电源菜单「锁定」（作废一次性绕过标志）+ 设置「安全→锁屏 PIN」页（设/改需旧、清免旧）+ `/tmp/meow_pin_unlock_once` 一次性解锁恢复口；M6.4 起锁屏用 **EVIOCGRAB 独占触控**杜绝输入穿透下层 App。
 
 **渲染与 App 进程隔离**：launcher 是系统进程，App 是独立进程。App 卡死/崩溃只影响该 App，系统 UI（状态栏/返回/通知中心）始终可用。
 
@@ -115,6 +116,7 @@ init (rcS)
 - **M2.89/90 新增**：**开机选单抢屏回归修复**（sysui S70 早拉 launcher 误入主屏→改怠速等 mode 文件，HibyOS 选单/热键链路恢复）；**watchdog SIGUSR1 仅裸沉浸 App** + SDK sigusr1 护栏（修框架 App 误杀）；**amsd 失联三修**（陈旧 revents 丢连接/收发超时/自动重连）；**MIUIx 顶级主题**（ui.style 一键切换，暖底橙调大圆角）；**meow_audiod 独占音频守护**（A1 全量，含 SDK 客户端与 `meow_audio` CLI；meow_route 并入退役）；**MeowPanel 字体库 tar.gz 导入/导出** + 文件管理自然排序；**流媒体客户端**：搜索接拼音 IME、设置页（音质/缓存上限/清理缓存）、缓存 LRU 淘汰接线、文案全中文。
 - **M2.91-96 新增**：**audiod 开机武装 hbc3000 FPGA**（路由线程启动无条件写 Output Port Switch，根治「未烧 FPGA 时 PCM 第二次 start 内核死锁」）；**svc_power 充电态权威链**（mp2731-charger/status，修 battery/status 恒 Discharging）+ 状态栏充电闪电图标；**amsd 注册自愈**（开机早于卡挂载扫空→3s 快重试+30s 合并重扫+`am rescan`）；**Now Playing 死循环修复**（空态 100% CPU/卡死）+ NP 页电源键/自动息屏；**插孔消抖**（4.4/3.5 插拔 ADC 幽灵音量键：launcher/watchdog/SDK 三路 800ms 消抖窗 + ramp 3s 上限）；**audiod 长流护栏 + 几何收窄 period=1024×4**（根治长流 ~12s 停摆：ring 有界等待/timedwait/popen 有界收割/O_NONBLOCK+poll 写/wedge 自救/心跳 watchdog）；**watchdog `wd_vol_save` O_TRUNC 毁 settings.conf 修复**（读改写单键+去重）；**音量反转四路统一**（CS43198 音量寄存器=衰减量：0 最响/255 静音，launcher/audiod/watchdog/SDK 统一 `dac=255-pct*255/100`）；**炸耳安全修复**（`dac_vol_mute` 旧写 0=最大响度 → 改 255 真静音）；**SDK 插孔消抖补齐**（meow_ui.a 12cdd5d7）+ **物理播放/暂停键（164) 改发 PLAYCTL cmd=6 toggle** + App 前台状态栏音量%实时刷新。
 - **M6.0-6.1 新增**：**网络管理服务 `meow_netmgrd`**（期1 接口统一层 WiFi/BT/rfkill/IP/DNS 只读 + 期2 连接普查三实体(app:/svc:/proc:)+DNS 代理 127.0.0.1:53 双行 resolv 零断流 + 期3 策略引擎防自锁（dropbear/wpa_supplicant/udhcpc 等拒 block）/SOCK_DESTROY 真机 no-op→仅 DNS 层生效/面板白名单/WiFi save_config；CLI `meow_net`，M6.0 期1/M6.1 期3，设计见 `devdocs/plan/NETMGR_DESIGN.md`）；**功耗管理服务 `meow_powermgr`**（期0 调研 current_now/cpufreq 不存在/背光 0-101 + 期1 权威充电链复用/经验模型 14 系数 + 期2 history 30s 环形/top 功耗分解/events/mp2731 current_now 实测充电功率（放电仍 estimated）；CLI `meow_power`，M6.0 期1/M6.1 期2，设计见 `devdocs/plan/POWER_MANAGER_DESIGN.md`）；**设置页迁 netmgr IPC + WiFi 新网络录入 UI**（扫 SSID→IME 输密码→connect，286）；**服务名统一 meow_***（S89 迁移 audiod.conf/mdnsd.conf→meow_audiod.conf/meow_mdns.conf，用户定案 cd4e2c2）；**MeowPanel 增强**（4 位 PIN 访问级鉴权 + 首页仪表盘 `/api/overview` + 电源/进程服务页 + 系统页补强，PANEL_ENHANCE_PLAN 批1）。
+- **M6.2-6.4 新增（SDK 演进批次，meow_ui.a 逐批重链四 App，API 全部追加式零改动）**：**公共头拆分**（278：`meow_ui.h` 922→67 行伞头 + `include/` 16 子头，API 零改动、`meow_ui.a` md5 不变、三 App 免重链）；**布局/滚动/动画基座**（292：`meow_box` 线性布局纯计算器（固定/weight/wrap/对齐/嵌套，opt-in `meow_view_set_layout`）+ `meow_scroll` 滚动物理（速度采样+fling+边界回弹+snap）+ `meow_anim` 动画基座（静态池≤16+缓动+脏区联动，挂 on_tick 零开销））；**事件分发形式化**（293 §6.4：单一仲裁者——z 序自顶向下命中+模态哨兵+down 捕获+唯一焦点，dialog/sheet/list/scroll 已迁，穿透矩阵 M1-M4 全 PASS）；**ListView 虚拟化**（295 §5.5：vsource count/bind 数据源+固定 item 池（视口+2）+多行富 item+完全自绘钩子）；**字符串资源 i18n**（299 §13：`meow_str`/`meow_strf`/`meow_str_set_locale`，内嵌 zh_cn/en_us 双语+TF 覆盖表+locale 持久化）；**sb_icons 动作图标 + topbar 位图**（307：15 个 MD3 动作图标 `MEOW_ICON_*` + `meow_topappbar_set_item_icon`）；**`meow_img_downscale`**（308：图片降采样 ≤maxdim，ncm 封面 8.28MB→0.78MB）。详见 `MEOW_APP_SDK.md` §5.5/§6.4/§12/§13 与 `docs/MEOWOS_SPEC_REF.md` §3。
 - **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/状态机走新增挂载器。
 
@@ -181,7 +183,8 @@ init (rcS)
 - **后端**：`patch_v2/meowpanel/meowpanel.c` 单进程零第三方依赖 C 静态二进制，内嵌 HTTP/JSON 服务器（8080）+ 静态托管（`/`→index.html、`/assets/*`）+ 框架专项服务 IPC 客户端 + `settings.conf` 设置镜像。**读侧透传** `meow_svc_perf` IPC（`/api/{status,perf,system}`，单一权威源，不各自爬 /proc）、**动作侧**经 `meow_svc_power` IPC（`/api/system/{reboot,shutdown,ota}`）。
 - **能力**：设置镜像（`settings.conf` 解析 `key = value` 带空格 + 精确匹配，防 `audio.volume` 误配 `audio.volume_max`）、文件管理（白名单 `MeowOS/Music/MeowData/MeowAPPs/book`，`..` 逃逸→403；**目录优先+名称不区分大小写排序、条目上限 1024**；上传 8MB 上限、文件名净化、双重白名单、`read>1MB` 截断）、**通知中心后端**（`/api/notifications` 读 TF 归档环形 200 条 + 单删 + dismiss_all）、应用（`nyai install/export/remove`，包名=`app.json.package`；`nyai` 路径固件内置 `/usr/bin/nyai` 优先+卡上回退）、按键注入（`/dev/input/event*` evdev，只注入音量/电源/播放/上下曲，**禁返回(158)/主页(172)/确认(28)/退出(96)**）、日志（`MeowOS/logs`）。
 - **OTA 检查升级 bug 已修**：改读 `GET /api/system` 返回的 `ota` 字段，不再误触 `POST /api/system/ota` 触发升级。
-- **M2.78 可选密码鉴权（agent-196，默认关）**：`panel.auth_enabled`(默认0) + `panel.auth_pass`(带盐 sha256 不明文)；token 会话（`/dev/urandom`，TTL 12h，内存+卡持久化，静态屏蔽 session 文件）；未启用零回归，启用后 `/api/*` 全要会话；前端登录页 + 401 回跳 + 设置卡片。**面板增强（PANEL_ENHANCE_PLAN 批1，2026-09-01 用户定案）**：4 位 **PIN 访问级鉴权**（面板访问即需登录，与未来锁屏同源 `system.pin` 预留，未设 PIN 首访引导设置、未设前写端点拒绝；token 会话 3 天或重启失效，进程内存）；前端五页：**首页仪表盘**（`/api/overview` 聚合）+ 音频电平（rms/peak 只读）+ 电源页只读 + 进程/服务页（svcd/amsd）+ 系统页补强 + 网络健壮性 + PIN 卡；后端只读端点 `power/overview/ams/svcd` + audio 电平键；音量 clamp `vol_max`+锥度提示 / 防自锁禁停 / 确认弹窗三红线。详见 `devdocs/plan/PANEL_ENHANCE_PLAN.md`。
+- **M2.78 可选密码鉴权（agent-196，默认关）**：`panel.auth_enabled`(默认0) + `panel.auth_pass`(带盐 sha256 不明文)；token 会话（`/dev/urandom`，TTL 12h，内存+卡持久化，静态屏蔽 session 文件）；未启用零回归，启用后 `/api/*` 全要会话；前端登录页 + 401 回跳 + 设置卡片。**面板增强（PANEL_ENHANCE_PLAN 批1，2026-09-01 用户定案）**：4 位 **PIN 访问级鉴权**（面板访问即需登录，与未来锁屏同源 `system.pin` 预留，未设 PIN 首访引导设置、未设前写端点拒绝；token 会话 3 天或重启失效，进程内存）；前端五页：**首页仪表盘**（`/api/overview` 聚合）+ 音频电平（rms/peak 只读）+ 电源页只读 + 进程/服务页（svcd/amsd）+ 系统页补强 + 网络健壮性 + PIN 卡；后端只读端点 `power/overview/ams/svcd` + audio 电平键；音量 clamp `vol_max`+锥度提示 / 防自锁禁停 / 确认弹窗三红线。详见 `devdocs/plan/PANEL_ENHANCE_PLAN.md`）。
+- **面板批2 + 加固（2026-09-02）**：崩溃/日志中心 + 音频路由页 + 音量写经 clamp `vol_max` + 后端补 `reboot_reason`；**JSON 输出 UTF-8 加固**（`sA_str_n` 单遍校验、非法序列换 `?`、IPC 原始 JSON 门禁降级，防任一上游坏字节拖垮整页）；**overview 自校验纪律**：`/api/overview` 服务端发出前先自查/严格平衡检查（坏则 dump `/tmp/overview_bad.json` + 500），前端非 JSON 自动回传原始字节到 `/api/debug/report_bad_json`（落 `/tmp/overview_client_bad.txt`）；**教训**：后端 `jv_parse` **容忍尾随垃圾**，而浏览器 `JSON.parse` **不容忍**——net 块多写一个 `}` 即「Extra data」破页（batch2 DNS 并入事故），故自校验必须做与浏览器口径对齐的**严格括号/闭合平衡检查**。
 - **⚠️ 鉴权默认关**：内网信任模型（`reboot/shutdown/ota/apps/删除/上传` 等危险端点默认无鉴权，**勿把 8080 暴露到不可信网络**）；`meow_svc_power` 服务端做 `SO_PEERCRED uid==0` 基础校验。
 - **前端**：`patch_v2/meowpanel/web/`（MD3/MIUIx 双主题 + 宝塔式 + 浏览日夜）；`/usr/bin/nyai` 装 `.mpk`；launcher 的 `meow_pkg_export` / `nyai export` 导出 tar.gz（busybox tar + gzip，不需 zip）。详见 `patch_v2/meowpanel/README.md`。