AskaEth/MeowOS-For-R3P2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
216 Commits 1 Branch 0 Tags
d7bf62f448aaa2d41611f9b1d609218666aa46a5
Commit Graph
216 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
AskaEth d7bf62f448 fix(meowpanel §UTF-8): JSON 输出 UTF-8 加固——sA_str 统一消毒非法/截断字节，防任一上游坏字节拖垮整页 
事故：amsd 的 am list 把「流媒体客户端」(18B) 截成 16B，腰斩「端」字(E7 AB AF→仅剩 E7) →
面板 ams_fill 把非法 UTF-8 嵌进 /api/overview → 浏览器 JSON.parse 拒收（HTTP 200 非 JSON）。
amsd 侧已修(8588a6b)，面板侧自此防住任一上游再产坏字节，一个源的坏数据不拖垮整页。

- meowpanel.c: 新增 utf8_seq_len/utf8_seq_ok/utf8_valid_n/utf8_sanitize（C 无依赖）；sA_str 收口为
  sA_str_n：逐字节校验 UTF-8，合法序列透传、非法/截断逐字节回退 '?'（保持长度）；纯 ASCII 单遍直通。
- 覆盖点（全部经 sA_str/sA_str_n）：ams_fill(pkg/name)、svcd_fill(name/exec/state/...)、audio_fill(app/fmt/route_mode)、
  /api/apps(app.json name/pkg/ver/exec)、字体名、通知字段、崩溃/日志中心字段、设置/主题串等。
- 两处日志内联转义（api_net_log、api_logs_read）改走 sA_str_n，日志行同样消毒。
- 原始 IPC JSON（perf/power/net，含 ssid）先 utf8_valid_n 校验：坏字节时 perf/power/net/status 降级
  available:false / 503，不嵌坏字节（api_overview 首页生命线不受影响；api_system network 段坏字节回退 hostname_local）。
- 宿主自测 `--selftest`：喂「流媒体客户\xE7」给 utf8_sanitize/sA_str/ams_fill 桩，断言 JSON 完整可解析 + 无非法字节，
  且不误改完整合法名「流媒体客户端」；`meowpanel --selftest` 通过。
- 验证：build_meowpanel.sh host / 交叉均 -Werror 0 warning；真实 ams_fill 桩复现事故 → 「流媒体客户?」JSON 合法。
- 后端 meowpanel(mipsel) md5: 820b24541ed69f2e27e4a301aff10c98（README 已校正）
 2026-09-02 02:32:25 +08:00
AskaEth 3397a702aa fix(ncm §30): 真机四连症状——JSON unescape + 封面流式 + 歌单豆腐/分隔符 tofu + 首屏诊断日志 
症状/根因/修法（0 真实 NCM 业务请求；宿主+qemu 全绿）：
- ③ LRC 挤一行/时间戳未解析：ncm_json_get_str_at 不做 JSON 转义还原，
  lrc.lyric 的 \n 转义原样进串 → lrc_parse 无真实换行整段一行。修：ncm_json.c 加
  json_unescape（RFC8259 全转义 + \uXXXX/代理对），get_str_at 返回前还原。
- ⑤ 封面全 failed→give up：cover.c 静态 g_buf 288KB < 封面 1.34MB → NCM_ERR_FULL。
  设备 RAM 仅 56MB。修：cover.c 改流式写文件（ncm_http_download cb→ncm_cache_write +
  meow_img_load_file 临时文件），NCM_COVER_MAX 8MB 改下载上限（非缓冲，bss 未涨）。
- ① 162 首歌单所有条目「三个豆腐」+「加载中」：占位符 ···（U+00B7）在 default 字体缺
  该字形 → 3 豆腐（font.idx glyph 扫实证 U+00B7 MISSING）。修：占位 ···→...、全 App
  · 分隔符→/；playlist_worker 首屏打 first-screen 诊断日志。
- ② 返回首页歌单列表 1 秒方框：字体缺 U+00B7/特殊字形（◢◤/Kannada）tofu；瞬态疑 glyph
  atlas 冷缓存（SDK 内部未深挖）。修：·→/。
验证：test_ncm_core(+test_json_unescape, host+qemu) / listvirt44 / dispatch / box42 /
scroll17 / anim32 / widgets / overlay_suppress / sdk_input_keys / theme / vol / ime_fix /
pinyin / notif_gesture / notif_open / sdk_fixes / sb_collapse / ui_audio_host / notify_ipc /
notify_integration + playlist_race_sim / window_sim / search_sim / cache_evict_sim(1-9) /
player_flow_sim(P1-12) / stream_sim(16+2resume) 全 PASS；mipsel -Wall -Wextra 0 warning。
新 md5：ncm d91cd906、ncm_host b731654a、test_ncm_core_host 7a38194c。

（症状④ VOL_DOWN×3 杀 App 的 launcher 源修复 app_launcher.c 门控 !a->framework 已随
 并发 commit 54a6e82 存入 HEAD；launcher 二进制 03dfcf76 留主会话/固件打包。）
注：build_ncm_host.sh 补 SDK 292/295 的 anim/box/scroll 源（宿主链接）。
 2026-09-02 02:25:37 +08:00
AskaEth 54a6e828b7 fix(launcher): app 显示名缓冲 name[17]→[49] + json_str 截断 UTF-8 整序列保护（同 amsd 修复，M6.2 备料 launcher 03dfcf76） 2026-09-02 02:20:06 +08:00
AskaEth 8588a6b453 fix(amsd): app 显示名 name[17]→[49] + UTF-8 整序列截断（utf8_trim_incomplete）——修「流媒体客户端」18 字节被砍成 16 致 am list 输出非法 UTF-8、面板 /api/overview 被浏览器 JSON.parse 拒收（非 JSON 响应） 2026-09-02 02:15:19 +08:00
AskaEth 9d54cf89c5 sdk(ui): W_LISTVIEW 虚拟化层 — 固定 item 池 + 多行富 item + 完全自绘 (§5.5) 
在既有 W_LISTVIEW (src2 每帧取行) 之上叠加虚拟化层 (API 追加式, 旧 API 一字不改):
- 数据源 count_fn + bind_fn (index, meow_lv_item*, ctx); count 每帧实时查 (任意长度≥65535,
  不常驻 item 对象); bind 仅在行进入视口时被调一次
- 固定 item 池: 视口行数+2 静态槽 (有界 ≤96), 回滚不重绑 (同 index 命中同槽); 整表扫过后
  wrap 回收合法但每次 draw 有界 (≤视口窗口)
- 多行富 item: 主标题/副标题/左图标·缩略图/右尾件; 行高 set_item_h(px) 或 set_item_tier(1→48/2→56);
  默认 renderer 主题语义色绘制; set_item_draw 完全自绘; section 段头占位行(非粘性); 空态占位
- 集成: tap_at→meow_ui_focus_acquire (§6.4); meow_scroll_wrap(lv,1) track+fling+snap(行边界);
  选中/按压态走主题; enabled=0 变淡不响应
- 兼容: src2==NULL 走既有路径; W_LIST/W_LISTVIEW 单行用法零改动

验证(宿主): 新测试 test_meow_ui_listvirt T1-T5 全 44 PASS (10000 项滚动窗口内容正确/hit 映射/
bind 有界=count/回滚不重绑/多行渲染/截断/图标占位/段头/空态/自绘/焦点/fling 吸附);
全量回归 widgets/dispatch/box/anim/scroll/ime/pinyin/overlay/notif/sdk_input_keys/p1p2p3 全 PASS;
交叉 zig-mipsel -Wall -Wextra 全 SDK TU 0 warning; meow_ui.a 新 md5=2a2d8000b95dd211d09dc736d5538ad0

文档: MEOW_APP_SDK.md §5.5 同步虚拟化层(API 一览/池语义/集成/回归).
 2026-09-02 01:36:48 +08:00
AskaEth 85e1d03157 feat(panel): 锁屏一次性解锁端点 POST /api/system/pin-unlock-once（写 /tmp/meow_pin_unlock_once，launcher 锁屏页消费放行一次）+ 设置页 PIN 卡「一次性解锁设备」按钮 2026-09-02 01:01:54 +08:00
AskaEth 54d2791f48 sdk: 事件分发形式化（§6.4）—— 统一命中/捕获/消费/层间隔离/焦点 
根治「焦点/事件穿透」一类反复 bug。此前命中/捕获/消费/层间隔离各处 ad-hoc；
现上收为单一仲裁者（meow_ui_input.c），公共 API 只追加、不删改既有签名。

分发模型：
- 触摸沿 z 序自顶向下命中（meow_draw_hit_topdown，owner==active+enable 过滤）；
- 命中即消费；模态层永远先审（meow_ui_modal_begin/end/active/depth）；
- down 捕获（meow_ui_gesture_begin/owner/end）：命中目标捕获手势直到 up，防滑出误触下层；
- 模态存在时下层完全收不到事件——hit_topdown 恒返回模态哨兵（背板消费，不透传）；
- meow_ui_run 在 TOUCH_DOWN 自动 begin、TAP/SWIPE/LONG_PRESS/NOTIF_PULL 自动 end。

焦点模型：
- 唯一持有者（meow_ui_focus_acquire/release/owner/tap）；
- 点非 focus 区域→释放并通知（meow_ui_focus_tap，list 焦点残留根治）；
- 滚动容器（list/listview）tap_at 命中行自动 acquire，点外由 run 的 focus_tap 释放；
- lost 回调（meow_ui_focus_set_lost_cb）通知转移。

迁移（行为修复，正常交互语义不变）：
- dialog/sheet → meow_ui_modal_begin/end（模态期下层收不到；叠黑由既有整帧快照+卡片仅重绘保证）；
- list/listview tap → meow_ui_focus_acquire；
- 注入/叠加让位（overlay_input_suppressed）与模态层隔离互补，语义不变。

验证：新穿透矩阵 test_meow_ui_dispatch（M1 模态点下层不触发 / M2 弹层叠开两层层隔离 /
M3 捕获手势滑出不误触 / M4 list 焦点点外释放）ALL PASS；
全量回归 widgets/ime_fix/pinyin/overlay_suppress/notif_gesture/sdk_fixes/sb_collapse/
p1p2p3_repro/box/anim/scroll/sdk_input_keys 全 PASS；交叉 -Wall -Wextra 0 warning。

meow_ui.a 新 md5：a9fcfb6eeb07ddbdd48039df4f8f18ce（主会话统一重链，本仓未重链 App）
 2026-09-02 00:57:58 +08:00
AskaEth c3abc3fee4 feat(launcher,lock): 锁屏补充三定案—面板一次性解锁恢复口 / 设置页 PIN 管理 / 电源菜单主动锁强化 
- 面板一次性解锁恢复口：/tmp/meow_pin_unlock_once 存在即被锁屏页消费删除并放行一次
  （不校验 PIN、不清 system.pin、不重置失败计数；重启标志自然消失；lck_unlock_once_consume，
  launcher 侧只做检查/消费，panel 端点由主会话另实现）。
- 系统设置「安全 → 锁屏 PIN」页（lock_settings.c，subpage.c 脚手架）：状态（未设置/已设置/
  锁定中+剩余）/ 设置（4 位双输确认）/ 修改（需旧 PIN 一次）/ 清除（**免旧 PIN**，仅二次确认弹窗）
  / system.pin_lock_on_wake 开关；数字输入用 SDK 按钮键盘（lck_input_pin_modal）。
- 电源菜单「锁定」主动锁强化：立即熄屏 + 写 /tmp/meow_pin_locked（主动锁标志，重启消失，
  唤醒时无论 pin_lock_on_wake 是否开都必锁屏）+ rm /tmp/meow_pin_unlock_once 作废挂起绕过；
  lck_wake_should_lock() 作为唤醒门取代 lck_lock_required(1)（主菜单 2 处 + App 会话 2 处）。
- 测试：test_lock_screen 扩 51 ok——bypass 存在即消费/不存在不影响/消费后删除；清除免旧 PIN；
  主动锁标志唤醒必锁/清除后回退；全回归 settings_brightness/notif_panel/notif_tf/vol_ramp_jack 无碍；
  交叉 -Wall -Wextra 0 warning。meow_launcherd md5 bdf884756ef8a8353aa8e5dfb6e10a0a。
- SYSTEM_SETTINGS.md 同步锁屏行为段。
 2026-09-02 00:57:17 +08:00
AskaEth e948a0a44e feat(launcher,lock): MeowOS 锁屏 4 位 PIN（system.pin 同源面板，错5锁5分钟持久化，唤醒/电源菜单手动锁） 
- system.pin：4 位数字 PIN，sha256+salt 存 settings.conf（格式与面板 panel.pin 全等，绝无明文）。
  panel.pin 已设且 system.pin 未设时锁屏接受 panel.pin，首次验证成功后并入 system.pin。
- 锁屏时机：息屏唤醒后（默认开，system.pin_lock_on_wake=1 可关）+ 电源菜单「锁定」手动锁；
  开机不锁（boot 进主屏不拦）。
- 锁屏页：launcher 渲染系统级全屏页，App 不可见不可触；SDK 按钮画数字键盘（不调 IME），
  输入 4 位自动校验；● 遮罩不回显数字；错 5 次锁 5 分钟（持久化锁定戳/计数，重启不清）。
- 安全细节：锁屏页电源键=息屏（允许再睡），音量键不动，不响应左缘返回/通知中心手势。
  兜底：SSH root 删 system.pin 键即解锁（无其它后门）。HibyOS 不涉及。
- 宿主测试（test_lock_screen）：设置/校验/错5锁定持久化(重载模拟重启)/唤醒触发/开机不锁
  /panel.pin 迁移，全 PASS；既有 settings_brightness/notif_panel/notif_tf/vol_ramp_jack 回归
  无碍；交叉 -Wall -Wextra 0 warning。meow_launcherd md5 670f978e71c1e81cfe86d47c21248c9d。
 2026-09-02 00:48:23 +08:00
MeowOS 5a5e995ebd SDK 冲刺批①+②+⑤: meow_box 线性布局 + meow_anim 动画基座 + meow_scroll 滚动物理 
- meow_box（include/meow_ui_box.h + meow_ui_box.c）：竖直/水平容器；子项=固定|weight|wrap；
  margin/padding/gap；主轴对齐 start/center/end/space-between/around/evenly；交叉轴 start/center/end/stretch；
  嵌套（深度≤16 静态栈，单遍求解，无递归爆炸）。可作 meow_view 布局提供者
  （meow_view_set_layout/relayout，opt-in；未设布局的 view 保持现有绝对坐标行为）。
  新增 meow_widget_set_rect（只写字段不标脏）作为 box 写坐标的通道。
- meow_anim（include/meow_ui_anim.h + meow_ui_anim.c）：时间驱动 tween（from/to/duration/easing：
  linear/ease-out/ease-in-out/overshoot）+ update/done 回调；静态池≤16、取消、并行多动画；
  meow_anim_set_region 让每帧只 flush 动画影响区（不整屏）。meow_anim_tick 挂主循环 on_tick，
  无动画零开销（只查计数即返回）。
- meow_scroll（include/meow_ui_scroll.h + meow_ui_scroll.c）：速度跟踪（最近 N 采样加权）+ 松手 fling
  （减速度曲线，用 anim 基座驱动）+ 边界过冲 clamp + 简单回弹（不做 spring）+ 可选 snap；
  跟手拖动行为不变（track 内部调既有 set_scroll）；每帧只 redraw 列表视口区；不引 libm。
- 追加式：既有 meow_row/column/box 与全部 meow_*_create/hit/scroll 签名一行未改；旧绝对坐标永远有效；
  既有 App 免改源码。
- 验证：宿主新测试 box(42)/anim(32)/scroll(17) 全 PASS；既存 9 回归（widgets/sdk_input_keys/ime_fix/
  pinyin/overlay_suppress/notif_gesture/sdk_fixes/sb_collapse/p1p2p3_repro）全 PASS；
  离屏 demo（demo_box_scroll.c）渲染 box 布局 + 列表 fling 正常；zig-mipsel -Wall -Wextra 全 TU 0 warning；
  meow_ui.a md5 83dd6a2d0d24cc748a8659c29f1de2b5（未重链/部署 hello/files/ncm/reader，由主会话统一处理）。
 2026-09-01 23:49:24 +08:00
MeowOS 553a7d5d9e reader R1: os.meow.reader 书架+TXT 垂直链路骨架 
- core: 编码检测(BOM→UTF-8严格→GB18030/Big5统计, Big5与GB重叠按GB18030兜底, §3.5风险注明)
  + GB18030双字节码表(uint16[126][190]=47880B, tools/gen_gb18030_table.py 生成, 生成物入仓)
  + 流式排版器(贪心断行+Kinsoku避头尾+分页+重排锚定, rd_meas_fn 测量回调替 FreeType, 宿主可测)
  + TXT 流式加载器(按段读, 不整文件入内存, \n 恒独立换行可安全分段)
- engine: FreeType 封装(FT_New_Face 按需读文件, NO_HINTING/LIGHT 灰阶, LRU 512 key=码点+字号,
  blend565, rdft_advance 只测宽不栅格化)
- app: 书架(扫 Books/ 识别 5 后缀, 最近读置顶, 空态提示) + 阅读页(W_CUSTOM 画布 3 栏翻页
  +中央菜单占位(字号±/行距±/返回) +顶栏进度%/章节名) + 书桥(段表+flat 页索引, 渲染, 重排回锚)
  + 进度持久化(MeowData/os.meow.reader/progress/, path hash→seg/ch/fs/ls/ts)
- 取舍: 正文字体 FreeType 直读 TF MeowOS/fonts/ TTF/OTF; 无字体回退 SDK 位图字库(meow_ui_text,
  未打包字体(许可/体积), 全 glyph 兜底 R2); 页位图缓存当前+前后各1页(3×691KB), 翻页动画默认无
- 内存实测(宿主 --wrap malloc, 73页书): 书结构 130KB + 当前段刮擦~1.6MB(行/页容量按 n 偏高,R2 收紧)
  + 字形缓存~650KB + 3页位图 2.07MB ≈ 4.45MB 动态, 在 ≤8MB 阅读态预算内
- 测试: 宿主 core 58/58(enc/gb18030金标准/kinsoku/page/reflow/txt); qemu-mipsel ft_smoke PASS
  + book_smoke(12页/渲染有墨/翻页/重排回锚) PASS; reader 交叉 -Wall -Wextra 0 warning
- 产物: reader(mipsel 静态1.2MB)+build_reader.sh(vendor FreeType 可复现); vendor/二进制 gitignore
 2026-09-01 23:26:42 +08:00
MeowOS 33d3059038 feat(panel, PANEL_ENHANCE_PLAN 批2): 崩溃/日志中心 + 音频写 + 后端补缺口 
后端（meowpanel.c 0-warning，-Werror 通过）：
- /api/system 补 reboot_reason/upgrade_status（svc_power 读级 POWER_REBOOT_REASON(8)/UPGRADE_STATUS(9)）
- /api/overview net 块并入 DNS 统计（首页严格单请求；DNS 不可用省略 dns 键不谎报）
- /api/audio 补 vol_max（读 settings audio.volume_max）
- POST /api/audio/route（仅 0=auto/2=3.5/3=4.4，拒 1/4/5；写级 PIN 已护）
- POST /api/audio/volume（clamp 到 vol_max，防炸耳红线；写级 PIN 已护）
- GET /api/logs/crash（崩溃汇总：每实体崩溃数+最近时间/信号 + dmesg 计数；256KB/64 实体/5 行上限）
- /api/logs 文件列表加 group 来源分组
- 顺带补回 批1-B 前端读取的 boot.mode /tmp/meow_boot_mode（此前遗留未提交）

前端（web/meowpanel.js 双主题）：
- 音频页：路由选择器（自动/3.5/4.4）+ 音量滑条（上限 vol_max、平方锥度非线性标注、确认弹窗）
- 日志页：崩溃汇总卡 + 崩溃尾巴一键看 stdout 尾部 + 按来源分组 + 前缀过滤
- 首页：netCard 改读 overview net.dns，去掉单独 /api/net/dns

验证：宿主编译 0 warning + -Werror；自建桩测试 24/24（crash 解析/路由 1|4|5 拒 422/音量 clamp 到 50/
reboot_reason+upgrade_status 值/overview net.dns）；headless Chromium 渲染 audio/logs/home/system/
light 主题均正确。md5(meowpanel)=aed2ea17a34614acaa26dcbc8965ebb1。
 2026-09-01 23:15:52 +08:00
MeowOS 34f2834704 docs: 仓库文档同步 M6.1 2026-09-01 22:33:58 +08:00
MeowOS 06307dc4b2 M6.1 备料: launcher start audiod→meow_audiod(服务名统一收尾, e6bdd091 含286设置页迁移); fw_content 收编 286 launcher/287 powermgr期2 aedaf519/276 netmgrd期3 62369ebe 2026-09-01 22:18:24 +08:00
MeowOS 0cae95c9cc powermgr 期2: 历史采样环/功耗分解top/电源事件流 + mp2731电流接入 + BT·WiFi分档细化 
- history: 30s 节拍内存环形(RING_N=480≈4h)存 pct/est_mw/充电态/屏幕态/亮度,
  不落盘重启清零(板载写磨损不考虑); IPC MSG_PM_HISTORY(0xD4)/D5, CLI history[N]
- top: estimate breakdown 分量实时占比排序视图(2s 刷新, Ctrl-C 退,
  MEOW_PM_TOP_ONCE=1 一次输出供测试); CLI top
- events: 插拔充电器/低电阈值穿越(15%/5%/回20%)/亮灭屏/背光跳变(≥30%);
  App 前后台无可轮询导出点→诚实标注不支持(语言, 期3接 launcher)
  IPC MSG_PM_EVENTS(0xD6)/D7, CLI events[N]
- 模型: 系数路径迁 /data/meow/powermgr/power_model.conf(=/usr/data symlink,
  组件持久化目录定案); WiFi 增未关联(carrier=0→unassoc)分档; BT 细化
  rfkill+hciconfig ACL(up/connected, 有界子进程 900ms 超时, 不可用回退 up)
- mp2731 current_now 接入: 充电态实测 charge_mw=cc_voltage×current/1e9,
  charge_confidence=measured(消费侧无实测节点仍 estimated, 条件写清)
- IPC 0xD4-D7 号段本文件局部定(不动 meow_launcherd/meow_ipc.h, 严守只动本目录)

验证: 宿主 aarch64 54 PASS + qemu-mipsel 54 PASS; 交叉 -Wall -Wextra -Werror 0 warning;
固件阈值 <200KB 达标(133KB); BSS 37.6KB 起见 RSS<1MB 达标
 2026-09-01 22:13:42 +08:00
MeowOS 3b6a73ac10 feat(launcher, NETMGR_DESIGN §12): 设置页 WiFi/蓝牙子页迁 netmgr IPC + WiFi 新网络录入 UI 
- wifi_page/bt_page 查询/操作改走 netmgrd IPC（netmgr_ipc.c 客户端：
  socket /usr/data/meow_net.sock，HELLO 鉴权 → WIFI_CTL/BT_CTL → RESULT）。
- WiFi 新网络录入：扫描结果点选 →（加密网络）SDK IME 输密码 → connect →
  结果反馈 → 刷新已存网络；开放网络直连；当前连接详情含断开。
- 双轨过渡：netmgrd 不可达（NETMGR_UNREACH）回退 net.c 直连 wpa_cli/hciconfig
  （保功能），页面显示「网络管理服务未运行（直连模式）」降级占位（不崩）。
- BT 仅迁 on/off/status/paired（netmgrd BT_CTL 无连接/配对子命令，其余直连）。
- net.c net_wifi_scan 补 sec 字段（wifi_page.c 补 meow_net_t.sec）。
- 测试：+test_netmgr_ipc.c（假 socket 帧：扫描渲染/连接成功失败两态/降级占位）。
 2026-09-01 22:09:31 +08:00
MeowOS cd4e2c247f feat(S89): 服务名统一 meow_*（用户定案）——S89 迁移旧 audiod.conf/mdnsd.conf 为 meow_audiod.conf/meow_mdns.conf（stop+rm+预置）；SPEC_REF/meow_svcd.md 同步。launcher main_menu.c 的 svcd start audiod 调用待 286 交还后改（避让同目录） 2026-09-01 22:08:29 +08:00
MeowOS b37dc23cd9 meow_netmgrd 期3：管控层（三实体策略引擎+防自锁+SOCK_DESTROY 实测→仅 DNS 层） 
NETMGR_DESIGN.md §6/§13 期3 落地（全在 patch_v2/meow_netmgrd/ + meow_ipc.h 追加）：
1. 策略引擎全量：/data/meow/netmgrd/net_policy.conf（/data=/usr/data）读改写单键+原子写
   （temp+rename，绝不 O_TRUNC 整文件重写——watchdog 毁设置教训）；per-实体(app:/svc:/proc:)
   net=allow|block + domain 白/黑（接通 DNS 层执行）+ global log_level；默认 allow。
2. 防自锁硬编码：dropbear/wpa_supplicant/udhcpc/meow_netmgrd/meow_svcd/meow_sysui/init 拒绝 block
   （CLI/IPC 拒 + 加载校验把手工改坏的文件里这些实体的 net=block 同样强制复位 allow——§14 红线）。
3. SOCK_DESTROY 真机实测（sockdestroy_probe.c，root @内核4.4）：**内核接受 SOCK_DESTROY 请求(rc=0)
   但未真正销毁 socket（cookie=0 与 dump-cookie 两法均 dead=0）→ 判定 no-op/不可用**。
   ⇒ 连接级执行降级为「仅 DNS 层生效」（net=block → dns_query_domain_denied 全量 deny，DNS 层落地），
   policy show 头 enfor=dns_only 明示。SDK 自愿通道/设置页迁移期外。
4. IPC 0x00EA MSG_NET_POLICY（op: show/set net/set domain/del）+ RESULT 0x00EB：读级任意、写级仅系统身份。
   CLI：policy show [entity] | set <entity> allow|block | domain <entity> +host|-host | del <entity>。
5. 两小修：①classify_exe 增认 MeowPanel 精确路径（修面板 dns flush 403；面板已有 PIN 门禁）
   ②连接未归因（inode=0/查不到）一律落 proc:unknown——修 apps 表出现「IP:port」原始端点行。
6. WiFi connect 持久化：MeowOS 模式 connect 后 wpa_cli save_config（HibyOS 只读由服务端门控）。

验证：宿主 test_netmgrd.sh 61/61 + qemu 61/61；test_netmgrd_p2/p3 宿主+qemu 全过；netmgrd_authtest 全过；
交叉 -Wall -Wextra 0 warning。真机只读实测（DNS-on 固件共存，用独立 socket+/tmp 临时 policy.json）：
policy set/domain/del 全链 + 防自锁拒绝 proc:dropbear(rc=1) + 空文件 del(size=0) + apps 无原始端点 +
resolv.conf 未触碰（测后核验固件两行形式）；Firmware meow_netmgrd(pid 8142) running 未动。

新 md5：meow_netmgrd 62369ebe29e7ef4b55067a0f14e240d0（主会话更 fw_content.conf/热更设备）。
 2026-09-01 22:08:10 +08:00
MeowOS 7ba0fde3e6 feat(panel, PANEL_ENHANCE_PLAN 批1-B): 前端五页——首页仪表盘/音频电平/电源/进程服务/系统补强/网络健壮性/PIN 卡 
- 新增 #/home 默认路由：单请求 /api/overview + 5s 节拍（电平 1s 子节拍独立），
  卡片：设备信息(boot/默认启动)/电量/音频(rms·peak dBFS 双条电平表 -60..0)/WiFi+DNS/
  在跑App与服务健康/存储/性能小条；任一源 available:false 该卡显示「—」。
- 音频页：rms(青绿)+peak(黄) 双条电平表 + deci-dB 数值 + 近30采样 sparkline，轮询提速 1s；无流占位。
- 新增 #/power：电池卡 + 功耗估算卡(est_mw + confidence 徽标 estimated/derived/measured) +
  子系统分解堆叠条(screen/wifi/bt/audio/cpu/baseline mW+占比)。
- 新增 #/proc：svcd 服务表(restart 计數>=3 高亮/来源 board|tf) + ams App 表(crashes/launches/last_kind)，
  行点开经 /api/files 列 MeowOS/logs/<pkg>/ 读最新 stdout_*.log 尾部(崩溃尾巴)；全只读，无 restart/kill。
- 系统页补强：电池行、当前运行模式(后端已有 boot.mode/current 则显示) vs 默认启动并列(不一致高亮)、
  重启原因/升级状态(后端未暴露时显示「—」)。
- 网络页健壮性(281 缺陷)：status 瞬态失败不再整页踢「不可用」占位，改顶部内联错误条 + 5s 自动重试，
  数据区保留上次成功内容。
- 设置页 PIN 卡：显示已设/未设/锁定状态，「修改 PIN」(旧+新双输入)与「清空 PIN」(旧 PIN 确认)，
  走 /api/auth/login 校验旧 PIN + PUT /api/settings/panel.pin。
- 首页置顶导航新增「首页」，默认路由 #/ 或 #/home；侧栏新增「电源」「进程·服务」入口。

验证：headless Chromium --dump-dom 静态样例数据(参照 281)，9 页 JS 0 错误，
双主题(md3/miuix × dark/light)通过；proc stdout 尾部支持 5s 重渲染后重开。
仅改 patch_v2/meowpanel/web/。
 2026-09-01 21:52:25 +08:00
MeowOS d12164305d feat(panel, PANEL_ENHANCE_PLAN 批1-A): 访问级 4 位 PIN 鉴权 + 后端只读端点 power/overview/ams/svcd + audio 电平键 
鉴权（用户定案：访问面板即需登录）：
- PANEL.pin 存 sha256+salt（salt:hex，绝不含明文）；与未来锁屏 PIN 同源预留 system.pin（g_sets 注记）。
- 未设 PIN → /api/auth/setup 首次设置流程；未设 PIN 前读/写端点全拦（require_auth 无条件，登录/设置流程除外）。
- token 128bit(16B→32hex) 只存进程内存（重启自然失效），3 天固定不滑动续期，多会话并存。
- 连错 5 次 PIN 锁 5 分钟（429 LOCKED，status 透出 lock_remaining_ms）。
- 旧密码机制 panel.auth_enabled/panel.auth_pass 兼容迁移：未设 PIN 时可暂用旧密码登录（status=legacy），设 PIN 后以 PIN 为准。

新只读端点（均需 PIN 会话）：
- /api/power: meow_powermgr MSG_PM_QUERY(0xD0)→RESULT(0xD1) battery/estimate/breakdown，confidence 原样透传。
- /api/audio: 补 rms/peak/lvlseq（追加键，ABI 兼容），抽 audio_fill() 供 overview 复用。
- /api/ams: am list 解析 App 表（pkg/name/state/pid/launches/crashes/last_kind/last_code）。
- /api/svcd: meow_svcd status all 解析服务表（name/state/pid/restart/backoff_ms/trigger/src/exit/exec）。
- /api/overview: 单线程后端只暴露聚合——perf/power/audio/net/ams/svcd 六源顺序 fan-out，任一源失败该子块 available:false，绝不假数据。

前端最小支撑：登录页（PIN 输入+首次设置双态）+ 401 自动跳登录 + token 存 localStorage 随请求带 X-MeowToken（后端亦认 Authorization: Bearer）。
红线：仅新增读级端点，未加任何写端点（音量/路由/策略等）；本任务不含批1-B 页面。

md5: meowpanel 3696e85b5eaf111f530c5c39fa68886e（mipsel 静态）/ meowpanel_host 3180e4f87e77db8717597619097805eb。
验证：host+mips -Werror 0 warning；假 IPC/am/svcd 桩六源聚合（含 power 宕机降级）PASS；PIN 全流程（设置→登录→连错5次锁→token 过期）PASS；qemu-mipsel 冒烟 PASS。
 2026-09-01 21:30:41 +08:00
MeowOS 30e2ec901f meow_netmgrd 期2.1 修复：status JSON 漏闭 bt 对象（/api/net/status res.json() 必炸） 
根因（patch_v2/meow_netmgrd.c build_status_json）：bt 对象开 '{' 后，dns 数组之后漏收 '}'，
导致 rfkill/rate 被吞进 bt、bt 与 root 均不闭合 → 外层 data 对象收尾只剩 3 个 '}'，JSON 非法，
面板 /api/net/status 纯透传 MSG_NET_STATUS_RESULT(0xE0) 后 res.json() 失败。

修法：bt 的 dns 是末字段，收尾改为 ']}，'（数组闭 + bt 闭 + 逗号）——不应含尾逗号
（首版 '],}，' 产生 "dns":[...],} 尾逗号 JSON 非法，一并修正）。

顺手核查：build_iface_json（0xE2 单/全接口）括号配对正确、JSON 合法；conns/dns 为文本表非 JSON，不受影响。

加固：test_netmgrd.sh 增 T13b-e 端到端断言 STATUS(0xE0)/IFACE_ALL(0xE2)/IFACE_WLAN(0xE2) 的原始 JSON
可被 json.loads 完整解析（括号配对/无尾逗号/唯一有效对象）。

验证：宿主 test_netmgrd.sh 52/52、qemu-mipsel 52/52、test_netmgrd_p2(宿主+qemu) 全过、netmgrd_authtest 全过；
交叉 -Wall -Wextra 0 warning。新 meow_netmgrd md5 abfb97680b4f576f3669a3e4b3b29134（主会话热更设备）。
 2026-09-01 21:24:35 +08:00
MeowOS 8e54b2c150 docs(repo): 公开 SDK 仓 MeowOS-SDK 拆仓说明 — README 加链接 + scripts/publish_sdk.sh（subtree split 命令 + 增量同步流程） 2026-09-01 21:15:35 +08:00
MeowOS f0b73e119d 280 歌单链路三修：开A→开B 竞态防串(5194 串数据) + 92/200 批边界 Load Failed + 歌单列表盘缓存 + 孤儿 .part 回收 
ncm_app(REPORT §26, ncm 158ec367 未部署留主会话):
- 打开时快照 plid+代次：appstate_playlist_begin/open_gen/open_idx/reset +
  appstate_load_playlist_songs_ctx(快照 pl 不读 g_st.playlists[]，detail 结果落
  staging 锁内原子发布，代次/目标不匹配判 NCM_ERR_STALE 不写全局)；playlist_tick
  过期丢弃 + appstate_playlist_reset 清窗口防串。修 5194「我喜欢的音乐」3 首/串数据。
- appstate_song_ensure_range fill-and-continue：bn<m 部分返回/单批网络失败非致命
  (记 NCM_ERR_NOTFOUND/r2)，已物化保留+占位行；worker 首屏 track_ids_count>0
  降级非致命(snack)。修 92/200 首歌单点开整页 Load Failed。
- 歌单列表盘缓存 <data_dir>/playlists.bin(magic+ver+ts+数组)：home_reload 先缓存
  秒渲 + 后台静默刷新，刷新失败有数据不置错态。修返回首页卡 LOADING(275 遗留)。
- 孤儿 .part/.tmp：evict/total_bytes LRU 扫描顺续删 mtime>7 天(in-flight mtime 新鲜安全)。
验证：新 bench/playlist_race_sim(竞态防串/批边界/非致命/盘缓存/reset)+cache_evict_sim
case9(7 天回收)+window/pagination/search/stream_sim 零回归+test_ncm_core host+mipsel
PASS；build_ncm.sh -Wall -Wextra 0 warning(text 978354/bss 1496484)；0 真实请求。
遗留：appstate_logout 未联动删 playlists.bin；g_st.playlists[] 快照拷贝仍有极小交错窗。
 2026-09-01 21:06:57 +08:00
MeowOS d8eeef5c57 feat(panel, netmgr §11): MeowPanel 网络管理页—netmgrd 期2 面板侧 
后端（patch_v2/meowpanel/meowpanel.c，/api/audio 同款透传模式）：
- GET /api/net/status    → 0xE0 概览 JSON（接口表 + WiFi/BT 摘要 + 速率）
- GET /api/net/conns?entity= → 0xE8 连接表（解析 entity|本端|远端|状态|寿命|域名 → JSON，transit 截断标记）
- GET /api/net/dns       → 0xEC status（mode/enabled/upstream/缓存命中/查询/deny/resolv_modified）
- POST /api/net/dns/flush → 0xEC flush（写级：HTTP 层走 require_auth；IPC 身份由 netmgrd 判定）
- GET /api/net/log       → TF MeowOS/logs/ 最新 net_*.log tail（256KB 上限，1000 行）
- netmgrd 不在/超时/应答异常 → 503 降级 JSON（NET_UNAVAILABLE），面板其它页不受影响
- 新增 --sock-net / env MEOW_NET_SOCK（宿主/qemu 测试用）

前端（web/，MD3/MIUIx 双主题沿用 270 落地件）：
- 侧栏新增「网络」入口（#/net）；接口卡 + WiFi 摘要 + 蓝牙摘要 + 每实体连接表
  （entity 前缀筛选 + 5s 轮询）+ DNS 代理卡（统计 + 清缓存按钮）+ 日志查看器
- netmgrd 不在 → 显示「网络管理服务不可用」占位 + 重试，不白屏不报错栈

验证：宿主 cc -Wall -Wextra 0 warning；mipsel 交叉编译 0 warning；假 netmgrd IPC 桩
（Python 帧级桩）联调五端点含 entity 过滤/flush 成功与 403/503 降级全通过；headless
Chromium 渲染 #/net（服务在线/离线两态）与 #/perf #/audio 无回归。
后端起二进制 md5: 21c70046476d3bf63e76f3d63e9eca2c（mipsel 静态）。

遗留（主会话部署时决策）：netmgrd flush 写级依 SO_PEERCRED 判系统身份，面板 exe 位于
/usr/data/mnt/sd_0/MeowOS/opt/MeowPanel/（非 /usr/bin/meow_* 亦非 os.meow.* 包）→ 真机
上 flush 会被 netmgrd 拒（403）。需在 netmgrd classify_exe 增认面板路径，或接受 403 只读。
不部署到设备（留主会话热更）。
 2026-09-01 21:01:00 +08:00
MeowOS 52edf0c9e4 meow_netmgrd 期2：观测层(PID→实体归因+连接普查)+DNS 代理+事件日志+连接/DNS IPC 与 CLI 
NETMGR_DESIGN.md 期2范围落地（全在 patch_v2/meow_netmgrd/ + meow_ipc.h 追加）：
- 连接普查(§4)：每 2s 解析 /proc/net/{tcp,udp}(IPv4) → socket inode→pid（由 inode 集驱动扫
  /proc/<pid>/fd，不逐 pid 盲扫）→ 三实体归因 app:<pkg>(amsd status)/svc:<svc>(svcd 落盘状态
  /tmp/meow_svcd.status，socket 查询兜底)/proc:<comm>(无则 proc:unknown)。连接表静态 ≤512：
  entity/五元组/状态/寿命；远端 IP 由 DNS 缓存反查域名。
- DNS 代理(§5)：监听 127.0.0.1:53 UDP；启动备份 resolv.conf 写双行(127.0.0.1+原上游，崩溃零断流)；
  透传转发+缓存(TTL 尊重；≤256 条)；按源端口(port→entity)归因；域名规则 per-entity+global allow/deny
  (deny→NXDOMAIN+日志)；atexit/SIGTERM/SIGHUP 恢复；5s 自检被第三方改回即重写；HibyOS 绝不启用/绝不改 resolv。
  DNS wire(deny NXDOMAIN / forward→A+cache / NXDOMAIN id 回显) 宿主+qemu 实测 PASS。
- 事件日志(§8)：新连接/关闭/dns deny/接口状态变化；同 entity 同 dst 1 分钟去重(首条+计数)。
- IPC meow_ipc.h 追加 0x00E8 CONNS_REQ/RESULT、0x00EC DNS_CTL/RESULT（纯追加不改既有行；
  0x00EA 策略(期3)/0x00EE 事件推送(预留) 保留）。
- CLI meow_net 补 apps / conns [entity] / top(2s 刷新) / dns status|stats|flush。
- 内存：静态表禁 malloc，mipsel bss 228KB → RSS≈374KB，≤600KB 目标 / ≤1MB 预算。

宿主编译 -Wall -Wextra 0 warning；test_netmgrd.sh 48/48(宿主+qemu)、test_netmgrd_p2 全过(宿主+qemu)、
netmgrd_authtest 全过；真机(M6.0/0.8.0)只读实测 apps/conns/dns status 正确
（svc:meowpanel/svc:mdnsd/proc:dropbear 真实三实体归因），resolv.conf 测后核验原值未触碰。
 2026-09-01 20:40:46 +08:00
MeowOS Dev 239345bfd2 merge: SDK 公共头按模块拆分（meow_ui.h 922行→67行伞头+16 子头 include/；API 零改动，meow_ui.a md5 不变 4786158d；agent-278 隔离分支验证） 2026-09-01 20:36:05 +08:00
MeowOS a5f675750b docs(ncm §25): REPORT 根因/修法/测试证据/新ncm md5（commit a01e5ca 配套） 
§25 记录切音质后重播同曲恒「缓冲中」：根因（player_manager.c 同 idx 新 play intent
不被解码主循环识别）、修法（seq 化 intent 护栏 still_intent + 解码主循环 seq 断 +
外层自然播完收紧 state==PLAYING）、测试证据（player_flow_sim 新 P12 + P1-P11 零回归 +
stream_sim 全矩阵）、新 ncm md5 28698dd0e。用户所问「歌单离线缓存/手动刷新」顺带核实：
离线缓存未落地（appstate_load_playlists 每次网络拉取），手动刷新已落地。
 2026-09-01 20:31:49 +08:00
MeowOS a01e5ca18a fix(ncm §25): 切音质后重播同一曲被卡「缓冲中」——play intent 以 seq 标识（同 idx 再 play 重启换档） 
真机反馈：切音质后再播同一首歌，声音已出但播放页恒显示「缓冲中」。

根因（app/play/player_manager.c）：同 idx 的新播放意图不被解码主循环识别。
切音质后重播同曲 = player_manager_play(idx)，而 idx 与在播曲相同——cur_song 不变
（仍是 idx）、state 由 PLAYING 置 BUFFER、seq++。旧仍_current（cur==idx && state==BUFFER
恒真）与解码主循环（只认 cur!=idx / STOPPED）均不放过，于是：
  ①旧曲（旧档位）继续出声、state 停在 BUFFER → UI 恒「缓冲中…」（dl_done=0 无百分比）；
  ②新档位下载/缓存条目从未发起；
  ③旧曲收尾后外层把 BUFFER 当「自然播完」顺延下一首——新档位永不生效。
三条取数路径（缓存命中/边下边播/.part续传）统一受影响（根因在 intent 层）。

修法：play intent 以 seq 标识，层层判别「我的 intent 是否仍有效」：
  - 新增 still_intent(idx, my_seq)（cur==idx && state==BUFFER && seq==my_seq），取代
    仍_current（同 idx 重播时 seq 变即判过期），贯穿 预缓冲/重试退避/物化/解码 open 各护栏；
  - run_song 入口捕获 my_seq，沿 song_local_file/song_download_attempt 下传；
  - 解码主循环 seq != my_seq → break 回外层重跑 run_song（换档重播）；
  - 外层「自然播完」收紧为 state==PLAYING，不把 BUFFER（挂起新 intent）当播完顺延下一首。

验证：player_flow_sim 新增 P12（同 idx 重播换档重启）——修前恒 PLAYING 不了/键仍旧档/
downloads=0/eff=-1；修后 state 回 PLAYING、下载新档位、缓存键 1000_lossless、eff_level
按非会员钳顶回填 EXHIGH。P1-P11 零回归（宿主+qemu-mipsel ALL PASS）。build_ncm.sh
自有代码 -Wall -Wextra 0 warning。0 真实 NCM 请求。未部署真机（留主会话）。
REPORT.md 另记（docs commit）。
 2026-09-01 20:30:59 +08:00
MeowOS 4534b840c2 sdk: meow_ui.h 公共头按模块拆分（伞头聚合，API 零改动） 
- meow_ui.h（922 行）改为伞头：只做 #include 聚合 + 模块索引，不定义新 API。
- 新增 patch_v2/sdk/include/ 16 个子头（types/draw/image/theme/ime/widgets/input/
  activity/zorder/statusbar/dialog/log/notify/config/font/audio），各自自洽可单独 include，
  依赖最小化（不透明句柄前向声明 + 必要模块互引）。
- 验证：meow_ui.a md5 与主树完全一致（4786158d…，头重组 .o 逐字节等价）；
  SDK .c 用 mipsel -Wall -Wextra 0 warning；hello/files 全量重编链接通过
  （-Wall -Wextra 0 warning）；宿主 test_p1p2p3_repro(P1c/P2/P3 ALL PASS)
  + 15 个 SDK/宿主测试 PASS；16 子头自洽编译 0 warning；伞头完整性回归
  test_umbrella.c 0 warning；ncm 5 个含 meow_ui.h TÜ mipsel 交叉编译到 .o 0 warning。
- meow_ui_internal.h 及 view/nav/media/sys/vol 子头未动；build_sdk.sh 无需改。
- MEOW_APP_SDK.md 头部新增「公共头模块索引」。分支 sdk-header-split。
 2026-09-01 20:30:16 +08:00
MeowOS 51281e609f docs(ncm §24): 对外名称按约定改「网易云音乐」→「流媒体客户端」(app.json) + REPORT 补注 
task 约束：对外文档称「流媒体客户端」，不写「网易云/NetEase」。仅改显示名，package/exec 不变。
 2026-09-01 20:01:13 +08:00
MeowOS 19e8fc93ed feat(ncm §24): 流媒体客户端边下边播阶段3——.part断点续传(Range/206/200/416)+LRU防淘汰(.tmp/.part跳过)+失败重试1次退避 
按 devdocs/plan/NCM_STREAM_PLAY.md §8 阶段3：
- .part 断续传：中断留 .part，续传带 Range，206 追加 / 200 丢头段 / 416 删残留整首重下；URL 每次新拉
- LRU 防淘汰：evict/total_bytes 跳过 .tmp/.part（在播文件不被动过）
- 失败重试：预缓冲前网络失败重试 1 次，退避 800ms，重试拿新签名 URL（风控：0 真实请求，未部署）
- 顺手修：gb_to_bytes 返回 int 溢出致默认 10GB 上限失效 -> uint64_t
- 验证：stream_sim(续传 PCM 金标准+全矩阵)/player_flow_sim(P9/P10/P11)/cache_evict_sim(case7/8)/test_ncm_core 宿主+qemu-mipsel 全 PASS；build_ncm.sh 0 warning；ncm_host 离屏正常

md5 ncm f8f316a1e6f3bdd8f6b5921fdbb3f3a2
 2026-09-01 20:00:14 +08:00
MeowOS fcff0b0ac1 fw_content: M6.0 收编 meow_netmgrd/meow_net 双形态条目（8f9303b5, agent-276 期1） 2026-09-01 19:59:02 +08:00
MeowOS 79a0fed336 meow_netmgrd 期1：网络管理服务骨架+接口统一层+CLI+IPC+日志框架 
NETMGR_DESIGN.md 期1范围（→ M6.0）落地：
- meow_netmgrd 守护：svcd 托管 trigger=boot/restart=on-fail，进程内 HibyOS 只读降级
  (/tmp/meow_boot_mode != meow → 读可查/写拒+日志，热切换)。
- 接口统一层(§3)：iface 枚举(/sys/class/net+/proc/net/dev，lo/wlan0/usb-eth 热插拔节拍检测)；
  WiFi 状态/扫描/网络列表/连接/断开(wpa_cli popen 有界收割防挂死，257 教训)；IP/路由/DNS 只读
  (ip 优先 /proc/net/route+resolv.conf)；BT 状态/开关/已配对(hciconfig/bluetoothctl)；rfkill 读写；udhcpc 续租/释放(MeowOS)。
- IPC 0x00E0-0x00E7(STATUS/IFACE/WIFI_CTL/BT_CTL+各自 RESULT)：读级任意、写级仅系统身份(SO_PEERCRED
  同 svc_power)，0xE8-0xEF 期2/3 预留(仅注释)。
- CLI 双形态 meow_net(status/iface/wifi/bt/rfkill/help)：IPC 薄壳，help 本地必可用。
- 日志框架：TF MeowOS/logs/net_<bootts>.log(无卡降级 /tmp)，接口状态变化/写操作必记。
- 单线程 poll、静态表、热路径禁 malloc；mipsel 静态(0 warning)，宿主+qemu-mipsel 全过，
  真机只读验证 status/wifi scan/bt status 正确。

meow_ipc.h 仅追加 0x00E0-0x00E7 段(不改既有行)。
 2026-09-01 19:55:26 +08:00
MeowOS cfeb9b775b chore(fw_content): 待打包标注口径 M2.98→M6.0（版本定案：M3-M5 系列号被历史里程碑占用，M2.97 后跳 M6.0） 2026-09-01 19:48:47 +08:00
MeowOS 4a49901bc1 feat(S89): M6.0 预置 meow_netmgrd.conf + 存量热更 exec(/usr/data→/usr/bin) 迁移（同 powermgr 模式; NETMGR_DESIGN）; fw_content.conf S89 行同步 f3bb197f 2026-09-01 19:47:44 +08:00
MeowOS 980d161972 fix(launcher/amsd): amsd MSG_AMS_START 拉起缺口——pending-start 抽 meow_ams_start 模块复用启动链 + 负错误码符修复 
根因（真机日志实证，M2.92 遗留）：meow_ams_pending_start_set 误返回正错误码
(-MEOW_ERR_BUSY=+8/-MEOW_ERR_INVAL=+1)，ipc_dispatch 的 rc<0?-rc:MEOW_OK 把「有前台 App
拒绝/空包名非法」误判为 OK(0) → amsd 报 OK 但 pending 未置位 → App 永不拉起（am start 报 OK
但界面没出现/进程未起）。

launcher：
- 新增自包含模块 meow_ams_start.c/.h（ops 注入 launch=launch_app/launch_activity、
  resolve=resolve_chain、log=logmsg）：pending 状态 + 拉起决策 + picker 上下文。
- set 统一返回负 MEOW_ERR_*（根因修复）；consume 复用既有启动链路真正拉起目标 App，
  列表未就绪（state!=0）保留 pending 待 2s 重扫重试，不再静默丢弃。
- main_menu run_menu 改经 meow_ams_start_consume 消费（保留 launch_fail_toast/菜单收尾）；
  app_launcher 移除旧 g_ams_start/g_ams_pick_* 迁入模块；util meow_ipc_process 顶部同步 busy、
  meow_ipc_init 末尾 meow_ams_launcher_init()。
- build_launcher.sh 编入 meow_ams_start.c；meow_launcher_internal.h 更新挂点声明。

amsd（协议层归属说明）：cmd_start 的 busy 判定对照 launcher ACK 正幅度（busy=8），
原 (uint32_t)MEOW_ERR_BUSY=0xFFFFFFF8 永不匹配 → busy 落入 launcher offline，改 (uint32_t)(-MEOW_ERR_BUSY)。

验证：宿主 test_ams_start.c 33 断言全 PASS（合法->拉起链、activity chain 透传、空包名/非法/busy
不拉起不崩、列表未就绪保留 pending、无路由 NO ROUTE、启动失败 idx 回报、picker 取回）；
launcher 目录全量回归 test_media/bgplay/depends/notif_panel/notif_tf/settings_brightness/
vol_ramp_jack/host_icon + test_font_tier/weight 全 PASS；mipsel -Wall -Wextra 0 warning。
新 md5：meow_launcherd a8200ae1b0aa68d7262749db87377d49、meow_amsd 7ddc677ce7938bc9b95c83c17bc78295。（M2.98 待打包，未刷机）
 2026-09-01 19:40:29 +08:00
MeowOS 7e7e45ae26 docs(APP_DEV_GUIDE): 第三方开发者上手指南 + 校订 SDK 头状态行 + README 索引 
新增 docs/APP_DEV_GUIDE.md（从零到上架动线：环境→最小App→工程结构→
构建打包→签名安装→部署调试→SDK能力速查→红线→FAQ），全部以仓库现状为准；
修正 hello app.json 全字段表（framework/immersive/background_audio/depends/
icon/version+version_code）、meow_audio_*/通知/媒体会话/字体档位等事实。
同步：MEOW_APP_SDK.md 头部「设计稿→实现版」状态行（只动状态行，正文不动）；
README.md 文档索引加该指南链接。

说明：hello_app 实际无独立 app.json（包装到 MeowAPPs/<pkg>/ 根目录），指南按真实
打包形态描述；nyai 无独立 pack 命令，出包用 nyai export 或 tar czf；.mpk 须在 tar 根。
 2026-09-01 19:38:52 +08:00
MeowOS 1e97dbf54a ncm search: 历史+单曲/歌单分类+分页+误触修复+不覆写歌单上下文 (§23) 
- 搜索历史：进页自动弹键盘；meow_config 持久化 ≤12 去重最新在前；空态=历史列表(点搜/左滑删/清空)
- 结果分类单曲/歌单页签：独立结果集+独立滚动；歌单行进详情(playlist_open_pl)；单曲行播放
- 触底分页：offset 累加 limit=30/页 cloudsearch 同参数；每类各记 offset
- 误触抑制：g_press_row + g_press_delta>10（对齐 home/playlist §13.3）
- 结果改独立数组(不写 g_st.songs[])；播放搜索单曲建搜索队列(queue_src=SEARCH)，不弄丢歌单窗口
- core cloudsearch 扩展 type/offset/limit/total + 歌单解析
- bench/search_sim.c 离线回归(历史/独立集/翻页 offset/队列上下文)；host searchtap 误触自检

验证：mipsel -Wall -Wextra 0 warning；core host/mipsel PASS；search_sim PASS；
宿主离屏 search(单曲)/searchpl(歌单)/searchhist(空态历史)/searchtap(误触) 均正常；0 真实 NCM 请求。
 2026-09-01 19:21:16 +08:00
MeowOS d4928224a5 feat(S89): M2.97 预置 meow_powermgr.conf + 存量热更 exec(/usr/data→/usr/bin) 迁移; fw_content.conf 同步 M2.97(launcher 899ac22c M4+depends / audiod 176c840d 电平监控+锥度 / watchdog 553840cd 锥度 / powermgr 469dddb7 新入固件 / nyai a7d24553 depends) 2026-09-01 19:11:42 +08:00
MeowOS 7bd6962ccb feat(ncm §22): 播放页重做——封面页/歌词页双页(NCM_CACHE_DESIGN §6 定案) 
- 去标题栏(不再用 ncm_topbar)；返回=左缘手势/系统返回钮语义
- 双页结构：封面页/歌词页，屏幕正中左/右滑切换(与左缘≤24px返回、顶部通知分流)，
  页面指示点显示当前页；中部横滑=on_touch_move 锁存 page-drag + on_tap/on_swipe 判向
- 封面页：方形大图+圆角(无旋转动画)+进度条(点 seek)+MD3 矢量控制钮(prev/play/pause/next,
  新增 app/ui/ncm_icons.h 32x32 单通道 alpha，参照 sb_icons.h 范式)+元信息+实际音质档
- 歌词页：LRC 滚动(当前行居中高亮、上下渐隐)+点行跳转(新增 lyric_line_time)；
  默认=封面模糊置底(封面铺底+主题 scrim)，省电=封面背景+黑色半透明叠加层(设置 ncm.player_bg_mode)
- 日夜间：主题配色只映射到半透明叠加层/scrim/accent(红)，不动沉浸底(NCM_PLAYER_BG 恒定)
- 分带刷新沿用：封面页=封面静态带+动态带(互不重叠 bbox，tick 只刷动态带)；歌词页换行(~5s)才重画
- 性能：宿主 4 页 PPM 核验+手势自检 PASS；mipsel -Wall -Wextra 0 warning；qemu core 回归 PASS；
  0 真实请求(封面/歌词用本地样本注入)。未部署真机(主会话统一)

md5: ncm 730e0b6e / ncm_host 500ac85 / player.c 00934de / ncm_icons.h 20f0bba
 2026-09-01 18:52:14 +08:00
MeowOS ed2ae10320 app.json 二进制依赖 depends：启动前检查（launcher）+ 安装提示（nyai） 
需求（用户定案）：App 复杂功能若依赖现成 Linux 二进制（板载 /usr/bin 或卡上
MeowOS/opt/bin）能效更好，声明后系统启动 App 前检查依赖是否存在。

- depends 行式声明：depends=curl,jq:optional,ffmpeg:required（无标注默认
  required；也接受 :opt/:req；未知修饰符按 required 处理并 WARN；空项/超量丢弃）
- launch_app_chain 冷启动时按序查 /usr/bin/<name> 与 <卡>/MeowOS/opt/bin/<name>
  （X_OK，两类命中即满足）；缺 required → 不启动（toast「缺依赖: <name>」+ 日志，
  沿用 CANNOT START 风格）；optional 缺失 → 仅 WARN 放行；只在启动时查，不做周期复查
- nyai install 对包内 app.json depends 同查并提示（不阻断安装，缺 required 标注
  「安装后启动将失败」）
- 新增 meow_dep.c（独立 TU，解析/检查/块原因），宿主测试 test_depends.c
  解析矩阵 12 用例 + 假根检查路径 12 用例全 PASS；launcher/nyai mipsel 交叉
  -Wall -Wextra 0 warning；launcher 现有宿主测试回归全过
- 文档：APPS.md §2.1 字段表 + docs/MEOWOS_SPEC_REF.md §5.5 同步；hello app.json
  加 depends:curl:optional 示例

launcher md5 899ac22c10f596909d7f35ea685744de（fw_content.conf 已更新；/usr/bin
只读，留给主会话打包固件）
 2026-09-01 18:28:07 +08:00
MeowOS 9e25db77cc feat(ncm §21): 边下边播阶段1+2——stream_src流式源+decoder双路open_cb+下载线程预缓冲/stall联动+P2 HTTP空闲超时+cache fd写者+stream_sim全矩阵PCM金标准(0真实请求,未部署) 2026-09-01 18:23:17 +08:00
MeowOS dbee37e1d6 chore(ncm): app.json 补 icon 字段(与卡上对齐) 2026-09-01 18:13:28 +08:00
MeowOS 8f8ffa605b fix(test): test_settings_brightness 期望值随亮度默认 50 同步(M2.97 陈旧) + ncm app.json 声明 background_audio=1(接 M4 后台播放) 2026-09-01 18:12:46 +08:00
MeowOS 5aabede0cd feat(launcher): M4 后台服务保活+后台播放（FRAMEWORK_DESIGN §5/§9 落地） 
- app.json 新字段 background/background_audio 解析入 struct app/meow_acct 注册表
- meow_ipc.h：MSG_REGISTER(m_register_t)/SERVICE_OK(m_ack_t.status=pid)/SERVICE_STOP/
  MSG_SYS(m_sys_t, SHUTDOWN=1/SVC_DEAD=2) 负载结构落地
- 新模块 meow_bgplay.c/h（自包含+ops 注入，仿 meow_media，宿主可单测）：
  · 后台播放保活——声明 background_audio 且媒体会话 PLAYING 的 App nav-exit 不终止，
    进程+音频流保留；UI 冻结走 §10.5 /tmp/meow_notif_active SDK present 自抑（非字面
    SIGSTOP：冻结同进程播放线程断供 PCM，§10.5 真机实证）；点图标/媒体卡片回前台=
    原进程恢复（chain/picker 忽略），停播后再退出=真退 SIGTERM
  · 无头后台服务——MSG_REGISTER spawn/stop/reap + 退避重启 1/2/4/10s cap +
    max_restart 熔断（清该 App 通知 + 注册连接广播 MSG_SYS{SVC_DEAD}，重注册复位）
  · 卡拔例外（卡上二进制后台 App/服务仍 SIGTERM 防 SIGBUS）、崩溃照收、
    关机前 meow_bgplay_kill_all 有界回收（含 MSG_SYS{SHUTDOWN} 广播）
- util.c：MSG_REGISTER/MSG_SERVICE_STOP 分发（权限/声明校验链）+ ipc_conn_alive 连接
  存活查询 + meow_ipc_process 末尾挂 meow_bg_housekeep（drain/reap/退避 tick）
- app_launcher.c：launch_app_chain 入口 resume（bg_take 原进程回前台）+ nav-exit
  保活分支 + 转后台出口（杀看门狗/写自抑标记/复位顶条，跳过退出尾）+ 冷启动自动
  拉起静态 keepalive(mode=0) 服务（exec 路径约定=App 同目录 <svc> 文件）
- main_menu.c：应用列表「·后台」标注（宫格/列表，1s tick 按 change_seq 刷新）+
  两条退出尾 kill_all + unlink NOTIF_ACTIVE
- 宿主单测 test_bgplay.c 50 项全过（真 fork 子进程走状态机 + 假时钟退避熔断）；
  test_media/test_notif_panel/test_notif_tf/test_vol_ramp_jack 回归全过；
  zig-mipsel-cc -Wall -Wextra 0 warning。launcher md5=c07d011c0769fca14d3bfb752d735463
 2026-09-01 18:09:09 +08:00
MeowOS 7db8197f9c fix(settings): display.brightness 默认值改 50(100 太亮; 存量 settings.conf 用户值优先不受影响) 2026-09-01 17:37:26 +08:00
MeowOS bce6a9a1f4 docs: 新增 docs/FIRMWARE_BINARIES.md 固件内置组件清单(源自 fw_content.conf) 2026-09-01 16:28:53 +08:00
MeowOS 0eb866d716 fix(settings): display.brightness 默认/上限 101→100 — 背光量程 0-101 且 101 满量程 PWM 闪屏(用户实测); clamp 上限 100 已有(M2.39),本次把 g_defs 默认与滑条上限一并收齐 2026-09-01 16:28:13 +08:00
MeowOS 677c0c47ac feat(meowpanel): 面板 MD3/MIUIx 双主题 × 明暗四套变量表 + 主题切换器（跟随系统/浏览器/明/暗） 
- CSS：色值全量抽为 :root 变量，[data-style]×[data-mode] 四套主题表；
  MIUIx 色值对齐设备 meow_ui_theme.c（light F7F3EE/F57200、dark 181310/FF8C4A、radius 20/28、spacing 12、细描边）；
  根属性 data-theme 更名 data-mode
- JS：默认联动设备 settings.conf（GET /api/theme 的 ui.style/display.theme）；
  面板覆盖存 localStorage（meowpanel.style / meowpanel.mode），不写设备；
  模式 system/browser/light/dark，browser 走 prefers-color-scheme 并监听日夜切换实时生效；
  旧键 meowpanel.theme 自动迁移；顶栏切换器保留原行为（本地生效 + PUT /api/theme 同步设备）
- 设置页新增「主题（面板外观）」卡：风格 MD3/MIUIx（可一键回跟随设备）+ 明暗四选一
- 后端未改：/api/theme 已透传 ui.style/display.theme，无需新增
 2026-09-01 16:26:02 +08:00
MeowOS 250c9ae8b1 feat(powermgr): meow_powermgr 期0调研+期1骨架——功耗管理专项服务（POWER_MANAGER_DESIGN） 
期0: POWER_HW_FACTS.md 真机只读取证——battery/无current_now(实时功率=derived+estimated
双轨)、无cpufreq(省电档无降频点)、背光量程0-101(非255)、rfkill可用、axp_battery为
幻影设备、无thermal zones、audiod STATE字段完备。

期1: patch_v2/meow_powermgr/ 单二进制双形态（meow_powermgr守护+meow_power CLI）：
- svcd托管 trigger=boot/restart=on-fail；HibyOS只读降级（/tmp/meow_boot_mode!=meow
  只采样电池，不碰wlan0/bt/声卡，热切换）
- 权威充电链0-diff照抄svc_power（mp2731→fusb302→battery兜底）
- 电池深加工 state/cap/mV/health/续航估算（容量差分速率环 30s×240）
- 经验功耗模型（/usr/data/meow/power_model.conf 可调，内置默认全部标注待标定）
- IPC /usr/data/meow_pm.sock MSG_PM_QUERY(0x00D0)→MSG_PM_RESULT(0x00D1) JSON，
  subset位；meow_ipc.h 0x00D0-0x00D7 号段回填
- CLI status/estimate/model 落地（IPC优先+直读降级），history/top/events/policy 期2/3桩
- 宿主桩测试36+1例全过(MEOW_PS_DIR等假节点)+qemu-mipsel全过+真机对照svc_power
  battery口径一致(93%/4270mV)；mipsel静态117KB(<200KB)；-Wall -Wextra 0 warning
 2026-09-01 16:21:12 +08:00