AskaEth/MeowOS-For-R3P2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
189 Commits 1 Branch 0 Tags
a5f675750be8709e5a8878fc9dc3258e983c5b04
Commit Graph
189 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
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 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
MeowOS 6a4d330a26 feat(audio): CS43198 音量按 DS1039 数据手册定档 — 感知平方锥度映射(dB衰减=(1-pct)²×96dB, pct=0→真静音255)四路统一; SPEC_REF 补数据手册事实(PCM_VOLUME_A/B=0x0B/0x0C,DSD独立音量); DSD 模式记入 AUDIOD_DESIGN §13 后期规划。audiod 47/47 PASS 2026-09-01 16:08:01 +08:00
MeowOS bdd9e898f4 feat(ncm §20): 音质体系全量——八档UI/VIP检测缓存/逐级降级下首恢复/fee门禁/默认极高HQ 
- core: 9档枚举(顺序=降级链, DOLBY映射保留不进UI/链) + level_key(sky/sky_c51)
  + level_gate(CVIP/SVIP门槛) + song_url surround档附加immerseType=c51
  + song_url_auto全档表降级(out_level回填/响应level静默降档采信/try_fn可注入)
  + vip_info(weapi v2优先v1兜底) + parse_vip_info离线可测 + NCM_ERR_VIP(-15)
- app/logic/account.c(新): account.json会员态缓存(uid/nick/vip/双expire/checked_at)
  刷新=登录后/超1天/到期后各一次不轮询; account_vip本地到期降档视图
- player_manager: 用户档按会员钳顶后逐级降级(不硬拒,缓存键仍用户档),
  fee∈{1,4}且非会员→NCM_ERR_VIP零请求(缓存命中优先), eff_level回填
- UI: 设置页八档(规格+门槛+未解锁标注,允许选定), 播放页时间行中央
  生效档/已降级至xx小字, VIP专享文案; 默认档Hi-Res→极高HQ(存量设置保留)
- 验证(0真实请求): degrade_sim 90例矩阵全PASS; player_flow_sim P1-P8全PASS;
  test_ncm_core vip解析9例宿主+qemu全PASS; 窗口/分页/缓存/封面/audiod sim全PASS;
  mipsel -Wall -Wextra 0 warning; 6页离屏rc=0。未部署真机(留主会话)
 2026-09-01 15:55:42 +08:00
MeowOS ab4dfb4f9c docs: 文档一致性整理 (agent-265) — 对齐 M2.91-96/0.7.86-0.7.91 + 261/262/264 
- README: 版本头 M2.90→M2.96；M2.91-96 批次( audiod FPGA 开机武装根治 PCM 死锁 / 充电权威链 mp2731 / amsd 注册自愈 / NP 死循环修复+充电闪电 / 插孔消抖三路 / 长流护栏+几何 period=1024×4 / wd_vol_save 毁设置修复 / 音量反转四路统一 dac=255-pct*255/100 / 炸耳修复 dac_vol_mute=255 )；流媒体客户端三期续(254 滑窗/256 封面缓冲 UX/260 FLAC dr_flac/262 播放键 toggle)；已知问题 PCM 挂死条目移除(已根治)
- MEOW_APP_SDK §5.9: 后续批次全量(FPGA 武装/长流护栏+几何/音量反转+炸耳修复/261 电平监控 rms/peak+monitor CLI, ABI 兼容)；IME 节后注拼音 IME 已落地
- FRAMEWORK_DESIGN: 头部里程碑 M2.15-M2.96；附录 B PLAYCTL 补 cmd=6 toggle
- SPEC_REF: §4 audiod 条目补 M2.91-97 加固批；音频硬件事实补衰减量语义+端口 5=audiod 强制重烧约定；现行版本 0.7.91(261 待 M2.97)；252 面板 /api/audio+字体页；OPEN_QUESTIONS 待定批更新(PCM 挂死已清结)
- SYSTEM_SETTINGS: audio.volume 衰减量注记 + 音量存盘读改写单键纪律
- KEY_CONTROL §9: SDK 插孔消抖已落地(56c569f) + 音量反转/存盘修复 + 262 播放键 cmd=6 toggle
- APPS §3.7: audiod 加固批摘要 + 262 toggle
- DEVELOPMENT_PLAN: 头部截至 M2.96
- 口径: 入库文档应用名统一中性表述「流媒体客户端（dev.player.ncm）」
 2026-09-01 15:41:33 +08:00
MeowOS ad9778476a fix(§10.5): 通知中心叠加媒体保活——播放中 App 不 SIGSTOP（修播放中滑通知中心音乐停） 
- launcher: run_app_notif_overlay 入口 meow_media_app_playing() 判定（当前源+PLAYING+app_id 匹配）
  → 不 SIGSTOP/不 SIGCONT，App 续跑保 PCM；非播放中维持 SIGSTOP 模板；关闭时 unlink 标记挪到
  恢复帧上屏后（防未冻结 App 抢 present 一帧回闪）。
- SDK gfx: present() 见 /tmp/meow_notif_active（env MEOW_NOTIF_ACTIVE_FILE 覆写）自抑上屏，
  仅 App 进程（系统 UI/launcher 不抑制），200ms 节流 stat，脏区累积解除后一次上屏；
  meow_gfx_overlay_suppressed_count 供单测断言。
- SDK input: 叠加期排空丢弃本进程 evdev 副本 + EVIOCGKEY 位图静默对齐（防面板点击被 App
  双重消费/解除后边沿误判），进入沿复位触摸状态机。
- 宿主：新 test_overlay_suppress T1-T4 + test_media §8（8 用例）全 PASS；test_notif_*/
  test_sdk_*/test_vol_ramp_jack 等回归全过；zig-mipsel -Wall -Wextra 全 TU 0 warning。
- meow_launcherd fbb82036（/usr/bin 只读待固件，fw_content.conf 已更）/ meow_ui.a d6242fc2 /
  hello a073535a / files 2b799d07（已热更到卡）；ncm 未重链（ncm_app 他 agent 在改）。
 2026-09-01 15:23:32 +08:00
MeowOS 820d1e52bf fix(media): 物理播放/暂停键(164)改发 PLAYCTL cmd=6 toggle + App 前台状态栏音量%实时刷新 
Bug1: SDK meow_ui_media 按 g_last_state 本地判 play/pause，但 ncm 走自有 ipc_media
线程不经 SDK meta 上报 → g_last_state 恒 0 → 恒发 cmd=1(播放)，播放中按键无效。
修：SDK 164 恒发 cmd=6 toggle（删 g_last_state 判定），ncm apply_playctl case 6
按 player_manager_state() 当前态翻转（源是状态权威）；launcher meow_media/util
本就透传 cmd 不动结构，仅 meow_ipc.h/SPEC_REF 注释补 6=toggle。媒体卡片/NP 页
按钮（按 launcher 侧 s->state 判，来自 META 是准的）维持现状。

Bug2: App 前台时状态栏为 launcher 叠加层，App 内 SDK 改音量/亮度只写
settings.conf+DAC，launcher meow_settings 内存表不感知 → g_sys.vol 停旧值。
修：app_overlay_statusbar 前插 app_overlay_settings_poll——1s 节流 stat
settings.conf，mtime 变才 meow_settings_init 重读+sync 缓存+g_sys.vol/brightness
（meow_settings 新增 meow_settings_file_path() 访问器防硬编码分叉）。

验证：宿主 test_sdk_input_keys 19/19（K4 改 toggle 断言）、test_media +cmd=6
透传用例 ALL PASS、ncm bench/toggle_sim 10/10（新）、player_flow/cache_evict
sim PASS、ncm core 宿主+qemu-mipsel PASS、test_settings_brightness PASS；
mipsel 交叉 -Wall -Wextra 0 warning（改动文件单独验+整构建）。
真机(0.7.91)：ncm 热更（.new+mv）后 autoplay(Docu) 起播缓存曲 → meow_ipc
playctl 6 二连发 → paused(pos=139691)/resumed 日志实证 toggle 全链路。
md5：ncm 8f10eee5 / meow_ui.a 7b359ec9（gitignore）/ launcher eba4f2b2
（/usr/bin 只读，fw_content.conf 已更新待固件）。物理键 164 实体按压留用户终验。
 2026-09-01 14:44:55 +08:00
MeowOS 9a4ea10c64 feat(audiod): DAC 实时监控 — 数字域电平表(100ms窗口整数RMS/peak,deci-dBFS)+1s监控日志(TF audio_monitor_<bootts>.log,流停即停)+CLI monitor 电平条;STATE 补 rms/peak/lvlseq 键(ABI兼容)。宿主47/47,qemu+真机0.7.91 tone验证(1kHz 0.3幅:rms=-13.9 peak=-10.8dBFS,hwrate~44.1k健康)。audiod ab193a2b meow_audio 891ab264 2026-09-01 14:25:51 +08:00
MeowOS 70aec677ce ncm: FLAC 解码落地(dr_flac 0.13.4 单头入库) + 缓存键=歌曲ID+音质档位 
- 解码分发 decoder.c：magic(fLaC→dr_flac / 其它→minimp3)；flac ≤16bit→S16、
  >16bit→S32 满幅送 audiod(AUDIO_FMT_S32)，rate/ch/bits 按实际流，零 SRC 零裁剪
- song_url_auto 接受 flac（type 权威/url 扩展名兜底），降级语义不变；flac 下载限幅 1GB
- 缓存键 song_<id>_<level>.<ext>：同歌同档命中不重下，换档新条目旧档留 LRU；
  ext 前导点正名(修双点名)，lookup 回退历史双点名+旧无档键温和兼容
- audio_out S32 通路（AUDIOD/ALSA/WAV）+ 流死重开按 bits 还原格式
- 验证(0 真实请求)：44.1k/16 与 96k/24 自制样本宿主+qemu 帧数/时长精确、
  逐样本零误差；mp3 回归逐帧一致；player_flow_sim P1-P6(新 P6 档位键/flac ext)、
  cache_evict/cover/pagination/window/audiod_chain sim 全 PASS；mipsel 0 warning
- REPORT §19 / VENDOR_NOTES dr_flac 条目；未部署真机（留主会话）
 2026-09-01 14:14:38 +08:00
MeowOS 80bc191593 build: fw_content audiod 772cc3d8(静音安全修复) 2026-09-01 13:51:31 +08:00
MeowOS c1353ce28f fix(audiod): 安全修复 — dac_vol_mute 写255(真静音),旧版写0=CS43198最大响度,重配/回收瞬间满幅炸耳(真机事故)。772cc3d8 已热跑验证,38/38 PASS 2026-09-01 13:50:26 +08:00
MeowOS 109d48747f fix(audio): CS43198 音量寄存器=衰减量(0最响255静音),四路(launcher/audio.c+audiod+watchdog+SDK vol)统一反转映射 dac=255-pct*255/100 — 修「0档炸50档最低」。真机 audiod 热修版实测 L/R 值方向正确 2026-09-01 13:34:58 +08:00
MeowOS 84fd0a87aa fix(audiod): ALSA 几何收窄 period=1024×4(tiny_alsa惯例) — 根治长流停摆(驱动默认巨buffer致hbc3000桥周期中断稀缺wedge; tonepcm2矩阵实测60s零stall)。宿主38/38 PASS 2026-09-01 11:06:01 +08:00
MeowOS 805fcf179a chore(ncm): 随 meow_ui.a(6a82b97e, sdk meow_ui_audio 257护栏) 重链 6491ea07 并热更到卡 2026-09-01 10:36:29 +08:00
MeowOS e1e1331e44 fix(audiod): 长流卡死根治 — 防卡死护栏全量落地(AUDIOD_DESIGN §12) 
根因(级联死锁): 内核驱动 wedge(hbc3000/cs43198 时钟域族, write/PREPARE/amixer ioctl
卡死在内核) → 播放线程永不返回 → ring 填满 → IO 线程在 ring_write 无超时 cond_wait
永久睡眠 → accept 停摆(backlog 满后 CLI ECONNREFUSED) → ncm 堵 socket 写 → 全链冻结。
同效路径: popen_read_tmo 无界 waitpid 随挂死的 amixer 子进程拖死持锁线程。

修法:
- ring 写有界等待(MEOW_AUDIO_RING_WAIT_MS 缺省 5s)超时丢弃+计数(dropped=), IO 永生;
  等待期 sid 代际守卫(抢占中等待的旧流 PCM 不再注入新流 ring)
- 全部 cond 等待 timedwait 化(播放 1s 周期自愈, g_cond 改 CLOCK_MONOTONIC);
  信号处理器只置 g_stop(不再调非 async-signal-safe 的 cond_signal)
- popen 收割有界: WNOHANG 300ms → SIGKILL 300ms → D 态放弃收割(泄漏换永生);
  路由线程 amixer 调用不持 g_mu; QUERY 改报 g_route_cur 缓存(IO 热路径不再 popen)
- ALSA 改 O_NONBLOCK + poll(POLLOUT,1s): 连续 3 次停摆判 wedge → PREPARE 自救无效即
  关卡进丢弃模式(stall=), 下一路 OPEN 重开重试
- server→client 下行帧单发 write 写不全即整帧丢弃(txdrop=), 杜绝半帧错位/慢客户端堵 IO
- 主线程 watchdog: IO/播放心跳 10s 静默告警; io 线程 poll 出错不退出(listener 不丢);
  backlog 4→8; RESUME/PAUSE 补 cond 唤醒
- SDK meow_ui_audio.c + CLI: connect 非阻塞+poll 2s, SO_SNDTIMEO/RCVTIMEO 2s
  (audiod 真死时 App 报错重开, 不再永久阻塞)

验证: 宿主 38/38 PASS(旧 19 回归 + 新增 T5 长流 3min 等效 31.7MB 持续灌 played==written
underrun/dropped=0 喂流中 listener 探活 15/15; T6 wedge 故障注入生存 — 旧代码同款注入
挂死(90s timeout 强制 kill), 新代码 IO/accept/preempt/SIGTERM 全活; T7 慢客户端 tx 丢弃);
qemu-mipsel 静态二进制 status/tone 全通(written=played=13230 underrun=0);
-Wall -Wextra 0 warning(host+mipsel+SDK 双端编译)。
meow_audiod md5 86a8b6793d516c90bbd12c2997b30d8f / meow_audio c23b96490842f54324b855fd9c2467a5
(fw_content.conf 已更)。暂不部署真机(主会话统一); meow_ui.a/App 重链留主会话。
 2026-09-01 10:32:15 +08:00
MeowOS 243f328499 fix(watchdog): build_watchdog.sh ROOT 路径修正(../..) 2026-09-01 10:29:22 +08:00
MeowOS c8cd6c3a54 chore(watchdog): 补 build_watchdog.sh(交叉+宿主测试), 对齐各组件 build_xxx.sh 惯例; 固件打包唯一入口仍是 scripts/build/build_fw_apps.sh 2026-09-01 10:27:53 +08:00
MeowOS 104bfe2d21 fix(watchdog): wd_vol_save 不再 O_TRUNC 毁 settings.conf(改读改写单键+去重,与SDK同款语义) — 真机实证整文件被抹/重复行/丢max+step。test_wd_fw 17/17 PASS; 52f2dadd 已热更 /usr/data/meow_watchdog 2026-09-01 10:25:18 +08:00
MeowOS 56c569f3a9 fix(sdk/input): 框架App侧插孔消抖 — 插孔变化后800ms内忽略音量键边沿(与launcher/watchdog 255同款,补齐SDK侧缺口); meow_ui.a 12cdd5d7; hello 34b01e76/files 2f44e27e/ncm 52412137 重链热更到卡。test_sdk_input_keys PASS 2026-09-01 09:28:09 +08:00
MeowOS 6200a41b71 fix(ncm): 三连修 — 封面切歌不更新/缓冲无反馈失败无声/暂停切歌边界 (REPORT §18) 
- cover worker 忙等死循环(成功后不清目标,每圈解码+换入+gen++,CPU 100%+每帧整盘重绘)
  → 成功清目标转怠速; 失败指数退避 0.5-4s 连 8 次放弃+WARN 日志; 去重加在拉目标;
  cover_get 持锁+cover_put 修绘制期 UAF; g_host_mock 防真网守卫
- 封面兜底污染修复: 不再把单曲 al_pic 写进 g_st.cover_url(否则 al_pic 缺失曲回落成
  上一首封面且撞去重 → 封面永停); plr_page_enter 强制重估自愈; pl_page_enter 回填歌单封面
- 缓冲 UI: BUFFER 态「缓冲中… N%」(g_play.dl_done/total, 下载回调累加); 播放错误中文
  错误条+snack(旧版 err 无 UI 消费者=无声死等); STOPPED 态播放键=重试; play/next 清 err
- 写失败 set_err 修连环跳歌(旧版静默 break 被外层当自然播完,流死时跳完歌单+狂发 song_url);
  still_current 护栏修下载途中切歌的状态/快照过期覆盖
- 验证(0 真实请求): cover_chain_sim 7 组+player_flow_sim P1-P5 全 PASS, 旧代码对照
  T2/P2/P4 必败坐实根因; audiod_chain_sim 14/14; pagination/window/core+qemu 回归 PASS;
  宿主+mipsel 自有代码 0 warning; 9 页离屏渲染 rc=0 (含新 mock 页 playerbuf/playererr)
- ncm md5 50d41bbf4a379e925699ba013b997ffd (未部署真机, 留主会话)
 2026-09-01 05:29:09 +08:00
MeowOS 614694ad4a fix(launcher): Now Playing 死循环修复(空态不再每帧整页重画,修100%CPU/卡死) + NP页接管电源键(单击息屏/亮屏) + NP页自动息屏 + 状态栏充电闪电图标(sb_icons 新增 bolt, charging 时电量图标左邻显示)。宿主 test_sb_statusbar PASS; launcher 6de97628 待入 M2.92 2026-09-01 04:40:34 +08:00
MeowOS 4bafdb5d69 fix(keys): 插孔消抖 + 音量 ramp 3s 上限 + 亮度写日志 — 耳机插拔 ADC 幽灵音量键修复 
真机实证(meow_20260901_034946.log): 4.4 插入瞬间电气瞬态在 jz_adc_aux(event2)
产生 VOL_UP 幽灵按住, vol_ramp 24%→上限50 (225391 ramp 起→227213 爬满,
紧随 audiod jack changed). 修(限 meow_launcherd/+meow_watchdog/):
① launcher audio.c + watchdog 各自读 /sys/class/switch/{headset,balance}/state
  (节流缓存 1s/500ms, 热路径不每圈读文件), 变化后 800ms 内忽略音量键边沿
  (vol_ramp_begin 不起/在爬 ramp 中止/wd_vol_adj 单步忽略)
② ramp 总时长上限 VOL_RAMP_MAX_MS=3000 兜底防一次幽灵打满(正常长按 24→50 ~1.4s 不伤)
③ write_brightness(val,src) 全 10 调用点带源+逐写 logmsg, 亮度跳上限下次可定位
  (grep 全库: 写 backlight 仅 launcher/watchdog/svc_power/bootmenu, 无确定 255 路径)
宿主: 新 test_vol_ramp_jack 15/15 PASS(单击/长按回归+3s cap+消抖忽略/中止/恢复);
test_wd_fw 17/17 + test_settings_brightness + test_notif_tf PASS; MIPS -Wall -Wextra 0 warning
(顺带修 watchdog 既有 sys/poll.h→poll.h 重定向 warning).
watchdog 已热更设备 /usr/data(baa997ea); launcher 7be1d4eb 待固件. fw_content.conf 已更新.
遗留: SDK meow_ui_input.c 音量键路径需同款消抖(sdk/ 有主未动)
 2026-09-01 04:28:10 +08:00
MeowOS 44d170413d build: M2.91(0.7.86) fw_content — audiod a6e4c295(FPGA武装)/svc_power 39ae3aa2(充电权威链)/amsd da9a5004(注册自愈)/launcher 2aa61780(MIUIx+充电态轻刷) 2026-09-01 04:04:51 +08:00
MeowOS 997f89f879 ncm 三期三批: 歌曲对象瘦身(1324→608B)+滑动窗口(NCM_SONG_WINDOW=256, 取消1000截断支撑任意长度歌单)+播放快照解耦 — agent-251 
- core/ncm_api.h: ncm_song_t 瘦身 id24/name128/art96/al96/pic256/dt int32 (1324B→608B)
- appstate.c 滑动窗口: song_ids 全量 trackIds 索引(16384) + songs[256] 窗口感知
  (song_valid 位图/window_base/滑窗 memmove 保留重叠), ensure_range 批网格(100)对齐
  预取, songmeta.c 盘缓存 <cache_dir>/meta/<id>.bin (回滚/二次进入 0 网络请求)
- playlist.c 触底分页退役→视口 ensure(±24 行), 占位行可直点(播放线程 fetch 物化),
  footer 改视口区间/总数
- 播放兼容: g_play.play_song 快照(mu), run_song 起播物化后全链路(下载/歌词/IPC META/
  播放页 UI)读快照——窗口滑出当前播放曲不崩; 边界 song_count→track_ids_count
- 验证(0 真实请求): pagination_sim 全 PASS(5191 无截断/52 批); window_sim 6000 首
  全程下滚 750 步视口全物化/song_detail 恰 60 次/回滚+0 请求/播放 fetch 不滑窗;
  core 宿主+qemu 全 PASS; mipsel -Wall -Wextra 0 warning, bss 2052068→1080900(-47%)
- 未部署真机(设备音频线排查中, 部署留主会话)
 2026-09-01 04:03:01 +08:00
MeowOS d8898afa09 fix(audiod): 开机武装 hbc3000 FPGA — 启动时无条件写 Output Port Switch(4.4→3/3.5→2/无插孔→4, 同值先写5强制重烧), 根治 PCM 启动内核死锁(未烧 FPGA 时第二次 hbc3000_start 挂死); port_name 补 4/5。真机验证: arm 日志正确+tone played=88200 underrun=0 不挂 2026-09-01 04:02:33 +08:00
MeowOS ca2290e691 fix(amsd): 注册表扫空自愈 (agent-250) — 根因: svcd trigger=boot 拉起 amsd 时 TF 卡未挂载, 启动首扫打空挂载点且此后永不重扫 → am start 报 pkg not registered (M2.90 真机日志实证). 修: registry_scan 改合并式重扫(只刷静态字段, 运行时状态/DECLARE路由保留, 源不可达绝不清表) + 主循环自愈重扫(源未通 3s 快重试/常态 30s 合并重扫) + am rescan 手动触发 + 兼容 M2.90 固件 launcher 旧 5 段 EV LAUNCH(nt==5 无 chain, epoch 不再错当 pid). 宿主+qemu+真机全链 PASS: 空目录启动 4s 自愈出 3 App, 真机 am start dev.player.ncm→OK(真pid)→kill 全通. meow_amsd da9a5004 / am 9e323faf (fw_content.conf 已更新, 待 M2.91 入固件闭环冷启动) 2026-09-01 03:41:19 +08:00
MeowOS 7cb1bdace4 meowpanel: 新增 /api/audio（audiod MSG_AUDIO_QUERY→STATE 透传, 不在时 available:false）+ 前端「音频」页(5s轮询只读)与「字体」页(列表/上传进度态/导出/409冲突确认force重试); 后端 md5 015f9cf1 2026-09-01 03:40:28 +08:00
MeowOS f149e24f28 充电态权威源 mp2731-charger/status（修 battery/status 撒谎恒 Discharging） 
真机实测：设备充电中但 battery/status 恒 Discharging；权威源为
mp2731-charger/status（Charging/Full），回退链 fusb302-typec-source/online==1
→ 旧逻辑 battery/status==Charging || ac/online==1。电量仍读 battery/capacity。

- meow_svc_power: battery/status 命令充电判定走权威链（MEOW_PS_DIR 可重定向供宿主自测）；
  svc_power_authtest 补 6 用例（mp2731 Charging/Full/Discharging + 两级回退）全 PASS
- SDK meow_ui_sys: 状态栏充电态同权威链
- launcher util.c: 抽 batt_is_charging() 公共判定；meow_sys_light 1s 轻刷补充电态（插拔实时）
- bootmenu 无充电判定（仅读 capacity）/MeowPanel 透传 power 服务：均无需改
- 真机验证（充电窗口）：新二进制 battery=88%(Charging)，对照固件内旧版 88%(Discharging)
- hello/files/ncm 随 meow_ui.a(af6703f2) 重链已热更到卡（.new+mv，md5 对核一致）

md5: meow_svc_power 39ae3aa2 / meow_launcherd 2aa61780 / hello 2444c151 /
files 691db88b / ncm 89da63ed（仅重链，源码未动）
 2026-09-01 03:25:01 +08:00
MeowOS 793a807ce3 tools: tonepcm2 支持设备参数(测 D1p) + PROBE_ONLY 模式(只探测不播放, 防挂死) 2026-09-01 03:16:52 +08:00