AskaEth/MeowOS-For-R3P2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
349 Commits 1 Branch 0 Tags
707bbd8a0265477aea2dc154719ce09f0904f49b
Commit Graph
82 Commits
Author SHA1 Message Date
AskaEth 707bbd8a02 feat(ncm): 断网保持登录态 + 离线模式（可见提示/缓存可播/联网自动回在线）（M9） 
用户报告：「一断网就退出到扫码登录界面，不会保持账号态切离线，缓存列表形同虚设」。
上一条已把失败分成 NETWORK/AUTH；本条把结论落到 App 状态与 UI。

- 会话状态机（appstate.c）：只有 NCM_ERR_AUTH（401/403/301/302）清 cookie；网络类失败
  （不可达/超时/TLS/5xx/-460）只置 g_st.offline，账号态与 session.enc 一律保留；
  appstate_ensure_uid 同语义（原先任何 AUTH 都清 cookie，网络故障不得进入该分支）。
- 启动（app.c）：根页改由 ncm_session_boot_decide 决定——有本地会话就进 home（无网也是），
  只有无本地会话才进扫码；打印 boot 决策日志。
- 离线 UX：首页个人卡「离线模式」红标 + 页脚提示 + 空态「离线模式/可播放已缓存」；
  歌单页/搜索页/播放页/缓存页分别给出离线文案（缓存页点播照旧走 NCM_QUEUE_CACHE，本地可播）。
- 恢复：home 可见时每 30s 静默重试一次（强制绕过接口缓存，成功即回在线并重绘）；
  任何真实网络成功（home/playlist worker）也会清离线态。
- 防误判：接口缓存命中（120s 旧响应）不算「回在线」——home_worker 用
  ncm_apicache_hits() 差分识别，避免离线提示被缓存命中闪掉。
 2026-11-05 11:45:20 +08:00
AskaEth 8557da6fca feat(ncm): 失败分类 + 登录门决策核心（M9：断网不再被当会话过期） 
根因：传输层/服务端暂不可用与鉴权失败共用「负错误码」一个通道，登录门只能按
NCM_ERR_AUTH 判断，任何上游映射偏差都会变成「退出登录」：
- ncm_login.c 把任何业务码 !=200（含 -460 风控）都当 AUTH；ncm_api.c 把 -460 也映射 AUTH；
- api/login 层完全不看 HTTP 状态：401/403 与 5xx/网关 HTML 都落进 JSON/缺字段分支，
  反过来 5xx 与网络故障无法区分；
- http 层握手/写入失败把 mbedtls 裸负码（如 -0x7280）直接返回，上层按 NCM_ERR_* 比不中。

改动：
- core/ncm_session.{h,c}（新）：ncm_err_classify / ncm_err_is_network /
  ncm_http_status_class|err / ncm_gate_decide / ncm_session_boot_decide。
  语义：NETWORK={NET,TLS,TIMEOUT,SVC,历史裸码}；AUTH 仅 NCM_ERR_AUTH；
  401/403→AUTH，408/425/429/5xx→SVC，其它非 2xx→HTTP；启动时有本地会话就先信它
  （无网→离线进 home，绝不进扫码）。
- NCM_ERR_SVC=-17（服务端 5xx/429、业务码 -460：暂不可用、可重试，不是登录失效）。
- ncm_http.c：http_ret_norm 在 done: 统一归一（超时/证书/其它→NET），裸 mbedtls 码不再穿透。
- ncm_api.c：api_status_gate 先按 HTTP 状态定性再解析 body；业务码加 302→AUTH、-460→SVC。
- ncm_login.c：status_check/refresh 先过状态门；301/302→AUTH、-460→SVC、其它非 200→HTTP
  （不再因一次未知响应把用户踢回扫码）。
- ncm_apicache：新增命中计数，供 App 区分「真网络成功」与「离线读到旧缓存」。
- build_core.sh / build_ncm.sh：核心源列表加 ncm_session.c。
 2026-11-05 11:45:20 +08:00
AskaEth 7d4906828d build(ncm): 宿主交叉适配层 + 全量测试补跑（M8） 
- 新增 build_ncm_cross_host.sh：同构 HOME 复用容器脚本，串起 sdk/vendor/host-mbedtls/core/tests/ncm
- libs_common.sh 工具链路径改为 MEOW_R3PROII_ROOT/$HOME 可覆盖，容器默认不变
- build_mbedtls.sh 递归清理 library/ 与 3rdparty/ 旧对象，修宿主/mipsel 混架构归档
- test_ncm_core.c 改用 $TMPDIR，Termux /tmp 不可写不再导致 store/cache/tag 用例失败
- REPORT §40：构建/测试/热更结果（ncm md5 1bbd2a55…，Music du 前后恒定）
 2026-11-05 11:34:45 +08:00
AskaEth e60642217a test(ncm): M6 缓存命名宿主单测（63 PASS）+ core 全量用例 + REPORT §39 
- 新增 test/test_ncm_cache.c + build_ncm_cache_host.sh（纯 libc：真实 ncm_cache.c +
  ncm_tag.c，仅桩 strlcpy/mkdir_p/档位映射，不依赖 vendor/mbedtls）
- 覆盖：实际档映射、降级后写入名、hires 命中已存 exhigh/lossless、低档不命中高档、
  旧命名命中/扫描/删除/双点名迁移、列表去重、LRU/清空/删除兼容、level_from_path 边界
- test_ncm_core.c 新增 test_cache_actual_naming（接入 core 全量测试集，同语义断言）
- REPORT §39：命名/命中/兼容方案、质量取舍与未执行项（vendor/交叉/真机）
 2026-11-04 21:11:00 +08:00
AskaEth 68833cf642 feat(ncm): 下载落盘名用响应实际档 + 命中按文件名标实际档（M6 播放链路） 
- song_download_attempt：URL/类型确定后算实际档，.part/open/commit 统一用实际档键
  （hires 请求被降级为 320k mp3 → song_<id>_exhigh.mp3），eff_level=实际档
- song_local_file：命中路径由 ncm_cache_level_from_path 取文件名档位并按容器钳顶
  （mp3 永不高于极高），旧 hires.mp3 正确显示「极高」
- 移除旧「stale-degraded 改名+强制重下」与「无档位键迁移」：老卡文件读可用、不迁移
- player_flow_sim 适配：补实际档/路径档位桩与 M5 链接桩；P7/P12 期望键改实际档，
  P13 改为旧命名命中即播、不重下不迁移
 2026-11-04 21:11:00 +08:00
AskaEth 30ffe469c8 feat(ncm): 缓存实际档判定/文件名解析 + 查找档位下探（M6 core） 
- ncm_cache_actual_level：请求档 + 容器/码率/位深 + 响应生效档 → 实际档（只降不升），
  作为写盘名/播放显示/已缓存列表的唯一事实源
- ncm_cache_level_from_path：文件名档位段解析（song_<id>_<档位>，含 sky_c51）
- ncm_cache_lookup：请求档精确 miss 后按实际档逐档下探（hires 命中已存 exhigh/lossless），
  只降不升，低档请求不命中高档实体
- ncm_cache_scan：actual_level 改用统一判定；同曲同实际档的旧名+新名去重展示
 2026-11-04 21:11:00 +08:00
AskaEth a9c94c7221 fix(ncm): tag 嵌入按实际容器拒绝 MP4/M4A（ID3v2 前缀会破坏 MP4 容器） 
download 扩展名在 type 非 flac 时一律落 mp3；若服务端降级返回 MP4/M4A（"....ftyp"），
给文件加 ID3v2 头会破坏容器。ncm_tag_embed_file 现读 12 字节 magic：fLaC → VORBIS_COMMENT，
"ftyp" → NCM_ERR_ARG 拒绝（调用方 commit 裸流），其余按 MP3 处理。
test_ncm_tag 增 2 条断言（拒绝 + 原文件不变）→ 53 PASS / 0 FAIL，0 warning。
 2026-11-04 20:49:25 +08:00
AskaEth 39465ea1ef feat(ncm): 新写入的缓存文件嵌入歌曲元数据（FLAC/MP3，commit 前流式重写，失败降级裸流） 
用户需求：保留元数据分离的同时把歌曲元数据嵌进缓存文件（否则外部播放器读不到任何信息）。
- 接入点 player_manager：下载完整（dl_rc==OK）→ stream_src_finish（读端先自然收尾）→
  ncm_tag_embed_file(.tmp, 实际扩展名, {name/art_name/album_name}) → dispose join 之后才
  commit。tag 重写是同目录 .tag.tmp + rename 换 inode，解码端全程持旧 fd，播放/seek/
  .part 续传字节语义零改动。
- 容器按实际 magic 分支（ncm_tag.c）；峰值内存 64KB；失败只记 WARN、commit 裸流，
  播放主链路不受影响（用户红线）。
- 元数据分离体系不动：<cache_dir>/meta/<id>.bin 旁路照旧写读；LRU 只 stat 文件，
  无 size/etag 索引需回填（重写后 stat 自然一致）。
- test_ncm_core 新增 test_cache_tag：writer 写裸流 → 嵌入 ID3v2.3 / VORBIS_COMMENT →
  读回 → ncm_cache_scan（hires 名 + 320k mp3 体 → 实际档 EXHIGH，名称来自文件内 tag）
  → ncm_cache_remove → ncm_cache_clear。
- REPORT §38：设计/内存估算/验证/诚实遗留（本机缺 vendor 与交叉工具链，未跑整链与真机）。
 2026-11-04 20:49:25 +08:00
AskaEth f392ee5c48 feat(ncm): 首页顶栏「已缓存」入口 + 已缓存列表页（歌名/歌手/实际档位/大小，点播/单曲删除/清空） 
入口：首页 topbar 新增动作 3（MEOW_ICON_DOWNLOAD 位图，原「回播放页」顺延动作 4）→
push ACT_CACHE；左缘返回弹回首页（app.c 路由补齐 tap/swipe/touch/tick）。

列表页 app/ui/cache.c（对齐 queue.c 惯例：圆角卡/红 mini-vinyl/按压红条/当前播放行高亮）：
- 行 = 歌名 / 歌手 · 实际档位 · 大小；空态/页脚（N 首 · 合计 X MB）。
- 点行 = 点播（NCM_QUEUE_CACHE 队列，上/下一首在缓存列表内循环）；行右「删除」=单曲删除；
  顶栏「清空」=确认框 + ncm_cache_clear（与设置页「清理缓存」同语义）。
- 数据全在 worker：cache_reload → appstate_cache_list_load → ncm_cache_scan（读目录 +
  文件内 tag + 音频头探测）→ 快照；UI 线程零磁盘 IO。快照上限 512 条（最近访问优先，
  ≈116KB bss），更多条目按 mtime 保留最近的。

core：
- ncm_cache_scan / ncm_cache_remove（songs/ 池，song_<id>_<请求档>.<实际格式> 解析，
  跳过 .tmp/.part 与非数字 id；按 mtime 降序；历史双点名删除兜底）。
- ncm_api_level_from_key（缓存键后缀 ↔ 档位枚举，与 ncm_api_level_key 互逆）。
- **档位显示实际档而非请求档**：真机存在 song_171650_hires.mp3（无损请求被降级链落到
  exhigh mp3），故 scan 用 ncm_audio_probe_file 读实际容器参数后只降不升地推断
  （FLAC 16bit→无损 / 24bit→Hi-Res+，MP3 ≤128k→标准 / >128k→极高）。

播放：player_manager 对 NCM_QUEUE_CACHE 用条目真实键（id+请求档+实际扩展名）直读缓存
文件，不按用户当前档键重下；song_local_file/play_is_same_song/queue 页均支持第三种队列。
宿主 mock（NCM_PAGE=cache）造 3 条缓存 + 嵌入 tag + 同步扫描。
 2026-11-04 20:49:25 +08:00
AskaEth 184ebd0ac9 feat(ncm): 缓存文件内嵌元数据模块 ncm_tag（FLAC VORBIS_COMMENT / MP3 ID3v2.3 写读 + 音频头探测） 
core/ncm_tag.c/.h（纯 libc，宿主可单测，不依赖 mbedtls/jsmn）：
- FLAC：在元数据末块之后插入 VORBIS_COMMENT（TITLE/ARTIST/ALBUM），旧 VORBIS_COMMENT
  替换、PADDING/PICTURE 原样保留；MP3：ID3v2.3 TIT2/TPE1/TALB（UTF-16LE+BOM，中英文
  与 emoji 均可），源已带 ID3v2 时先剥旧标签（不留双标签）。
- **按实际容器分支**（读 fLaC 魔数）：缓存名档位段是请求档，真机存在
  song_<id>_hires.mp3（无损请求被降级链落到 exhigh mp3），不能按名字判容器。
- 写入 = 同目录 <path>.tag.tmp + 64KB 分块搬运 + fsync + rename 原子替换；任一步失败
  即 unlink 临时件、原文件保持不变（调用方 commit 裸流降级），峰值内存 64KB。
- ncm_audio_probe_file：只读文件头探测实际容器/位深/码率（FLAC STREAMINFO / MP3 首帧），
  「已缓存列表」据此显示实际档位而非请求档。
- test/test_ncm_tag.c + build_ncm_tag_host.sh：FLAC/MP3 构建+读回、中文 roundtrip、
  旧标签替换、容器判定、3MB 分块、失败降级、探测 —— 51 断言全过，0 warning。
 2026-11-04 20:49:25 +08:00
AskaEth 7c7d891570 feat: M6.44+M6.45 收编 — 真机 0.8.45 现场保全(reader章节/key_router按键路由/WiFi连接修复/ncm bench+IME修复) 
脏工作区现场收编：devdocs/local/m6_44_45_dirty_tracked.patch(46 个已跟踪文本文件,
+3090/-585, 已对 M6.43 基线干净适配) + m6_44_45_untracked_src.tar.gz 中 patch_v2/ 下
13 个新增源文件, 合成单个提交, 内容与容器工作树(R3ProII/patch_v2)逐字节一致。

- reader 章节: 新增 core/rdchapter.{h,c} — TXT 章节规范解析器, 扫描 512KB 码位对齐段文件
  逐段流式识别标题行(行首缩进≤4/显示宽≤40/行内标点≤1 三重约束防误判), 输出标题+全书字符
  偏移+段号/段内偏移+阿拉伯章号(中文数字归一), 首章前内容归"卷首"; book/reader/rdenc/
  rdlayout/settings 接入章节跳转与进度锚点, 附 chapter_smoke/turn_repro/build_turn_repro.sh
- key_router 按键路由: 新增 meow_launcherd/key_router.{h,c} — launcher-UI 页物理键统一路由
  (P1 仅音量键), 把读取边沿+防抖+长按 held+ramp 推进从 5 个会话收敛为进程内单开;
  各页每圈 key_router_pump() 取防抖后边沿, 动作(调音量/光标导航)仍由调用页决定,
  保留 run_menu 的 meow_mode 分支; App 前台 volume_page 武装时边沿抑制;
  main_menu/now_playing/notif_center/settings_page/subpage 接入, 附 test_key_router_vol/test_np_keys
- WiFi 连接修复: meow_netmgrd connect 有界等待 wpa_state=COMPLETED(普通 10s/隐藏网络 15s,
  env 可调)修设置页连接无响应; list_networks/scan_results 的 \xNN 转义还原始字节, 修中文 SSID
  永不命中致新建同名 open 记录顶影; launcher netmgr_ipc 配读超时; 附 test_wifi_connect(桩
  wpa_cli 驱动 static wifi_connect_ex), test_netmgrd.sh 补用例; wifi_page 同步
- ncm bench: 新增 bench/lyric_sim.c、bench/plpage_sim.c, vol_sync_sim 与 ncm core/app 同步
- SDK IME 修复: shift 大小写、K_ENTER 只提交不关、阻塞 IME 循环喂 on_tick 不被遮挡、
  IME 打开 ~200ms TAP 冷却窗吞 stray-TAP; 附 sdk/test_ime_fix.c
- 同期: meow_audiod 音量异步 ACK 线程(代际防 fd/槽复用竞态)、watchdog 音量收编(首选 audiod
  权威, settings.conf 覆盖路径)、panel 文件搜索(F1-④)与蓝牙只读详情(F1-③)、各类 build 脚本同步

范围红线: third_party/legado-E-main 原开发者未跟踪, 本次不入库(保留 devdocs/local tar 参考);
二进制不入库(后续重编); devdocs/ 不入库。59 文件全部在 patch_v2/ 下, 无 third_party/devdocs。
验证: git apply --check 干净; 59 文件 md5 与容器 patch_v2 逐一比对 59/59 一致(含
key_router.c/rdchapter.c/meow_ui_ime.c/test_wifi_connect.c 抽查); 可执行位保守
(check_lgpl_release.sh 100755, build_turn_repro.sh 100644 与容器一致)。
 2026-11-04 20:02:28 +08:00
AskaEth a2aec783a7 feat(ui): M6.38批 — P1 MD3细化(SDK对话框28)+批②底部上滑回桌面+批6 ncm顶栏回播放页+批④面板后台列表+launcher UI微调(歌词页黑半透明底/播放页布局下移)+封面空artwork保留修复 
- P1: meow_ui_dialog.c 对话框底框 radius_card→MEOW_SHAPE_EXTRA_LARGE(28) 三处(:103填充/:104描边/:361 BottomSheet); meow_ui_widgets.h 新增 MEOW_SHAPE_EXTRA_LARGE 28 宏; TextField/FAB/Slider/Progress 按设计文档保留
- 批②: np_gesture.h 新增 NP_GEST_HOME+np_home_gesture(底部热区上滑,与左缘返回对称互斥); now_playing.c 新增 np_draw_home_bar(屏底左缘pill指示条)+手势衔接; test_now_playing_widgets G5b
- 批6: ncm home.c 顶栏加回播放页按钮(MEOW_ICON_QUEUE_MUSIC)→push(ACT_PLAYER), 无音频也生效
- 批④: meowpanel /api/ams/bg 只读端点+前端后台列表页+杀/清复用kill通道
- UI微调: now_playing.c 播放页布局宏下移(NP_COVER_Y 84/NP_BTN_Y 612消底部留白)+歌词页背景统一黑色半透明叠层(弃封面取色底,删 np_draw_lyric_coverbg)
- 封面保留: now_playing.c/notif_center.c 空artwork保留上一张已解码封面(防暂停/开歌单致META报空artwork后封面闪没); test_np_cover C2断言更新+mirror同步

0warning;宿主测试 test_np_cover ALL PASS;launcher/ncm/panel 宿主测试无回归。二进制留批量批次未入库
 2026-09-04 13:09:03 +08:00
AskaEth 6eccb17f9b fix(ncm): 歌单切换两bug — ①暂停态跨歌单点歌旧信息(play同曲护栏改按曲目id判同曲而非裸队列下标,切歌单后同下标换歌被吞play→修play_is_same_song) ②切歌单封面残留(playlist_tick补cover_changed/ack+invalidate重画头块);附带占位行cover_request野id修复;宿主P15/covswitch PASS,热更ncm 2026-09-04 00:14:37 +08:00
AskaEth 18014eb2b9 fix(ncm): 补play_mode持久化定义(appstate_apply_play_mode/ncm_mode_name,同agent-392播放模式) — ncm链通必需,与M6.32上卡二进制一致 2026-09-03 23:48:08 +08:00
AskaEth 76a22a6a91 fix(fw): M6.32 重编meow_ui.a+重链四App(播放页进度条取色+ncm列表gap)+面板透传 — 推卡+热更四App 
- meow_ui.a 重编(86af4d29): SDK W_PROGRESS 改读 opts.bg/fg=轨道/填充(agent-408)
- launcher 513d7603: 播放页进度条/按钮局部重绘接取色(np_grad_row/np_page_bg_row/np_theme_widgets)
  + 链新 meow_ui.a + sdk meow_lyric/lyric_view/meow_img_color; 经固件 /usr/bin 刷入
- ncm 05ff05f1 重链新 meow_ui.a(agent-409 列表项 gap 已入源), hello f35495a5 / files 5d70b7b2 重链
- meowpanel.c: audio_fill 补透传 audiod target/volctl/codec(输出目标/音量AVRCP/编解码器)
  前端 meowpanel.js 已前向兼容; 宿主 /api/audio JSON 验证含三键
- fw_content.conf launcher 0cdf940f -> 513d7603(M6.32)
- r3proii_m6_32.upt md5 8ce917ad(0.8.32, rootfs 38707200<=45088768, unpack 0 diff)
 2026-09-03 23:42:46 +08:00
AskaEth e8218b8ae9 fix(ncm): SDK圆角矩形列表项加外边距 — 实为ncm_app应用层自绘(row_bg圆角卡),调用处加NCM_ROW_GAP=8px卡间可见外距(卡高48/行距56上下对称+擦SDK行分隔线);三屏playlist/home/queue;宿主test_meow_row_gap PASS,0warning,不涉meow_ui.a无需重链 2026-09-03 23:29:45 +08:00
AskaEth 2e5b814059 feat(media): 批3歌词数据源框架 — meow_media_session扩实时歌词(lrc/tlrc/seq)+MSG_META_LYRIC上报分片+ncm上报+launcher读meow_media_lyric_* 接批1/2;宿主L1-L7全过/ncm热更27554dd8,launcher待固件收编 2026-09-03 19:49:28 +08:00
AskaEth 7ca3e5bd84 feat(ncm): 播放模式三态(随机/列表循环/单曲循环,播放页三键左)+当前实时播放列表(三键右,歌单滑窗/meow_listview虚拟化分页至5194首,当前曲高亮,点播切歌) — 模式持久化,宿主modetest/queuetest全过 2026-09-03 18:51:28 +08:00
AskaEth 671f0d1835 feat(ncm): 底部mini播放栏(替代顶栏图标) — 异Activity常驻,非播放页+有活动播放时显示:封面缩略+歌名/歌手+播放暂停+进度带+点击进播放页,宿主barhit/plsplay/home/player PASS 2026-09-03 18:07:57 +08:00
AskaEth b89b91c9c4 fix(ncm): 歌词页两bug — ①app.json单行被fgets(256)截断致keep_awake失效(改多行版部署) ②翻译行块高不含翻译致叠行(lyr_layout s_lyr_bh) 2026-09-03 14:20:14 +08:00
AskaEth 3d70a3dd2c feat: M6.10–M6.19 批量收编 + M6.19 推卡验收 
- M7 launcher 重写 5 期（虚拟化宫格/meow_theme 单一权威/横幅动画/自定义 PIN 键盘）
- OOM 通用化（cachegov 上收 SDK）、自动切歌根治、meowpanel jv_free 泄漏修复、Hello 滚动卡顿修复
- ncm 歌词 UI / 媒体通知封面 / 封面分辨率 640
- 5 bug 修复：ncm 后台化 UI 叠层+点击穿透、再进 ncm 桌面叠层、播放页新旧 UI 叠层抢刷脏区（meow_ui_gfx 恢复边沿整帧重画）、PIN 亮屏亮度跳（keys.c meow_panel_on 按 settings_brightness_clamped 恢复）、通知中心封面显歌单封面（cover.c save_cover_raw 加 is_song + 命中块守卫）
- 四 App 统一重链新 meow_ui.a 51caee4a；M6.19=0.8.19 固件 2d2331f2 推卡自刷验收全绿
 2026-09-03 12:16:01 +08:00
AskaEth cd7329d141 feat(ncm): MUSIC_U 临期主动续期 — 启动查龄超阈值后台静默刷新/eapi 会话锚点/cookie 合并+冷却 
用户定案：失效前用当前 cookie 换新登录态（用户无感）；仅刷新失败才退扫码重登。

- core/ncm_req.c|h：eapi Cookie 头补齐会话锚点 MUSIC_U/MUSIC_A（对齐 request.rs，
  补 §36.5 遗留——登录刷新/song_url 会员档依赖）；新增 ncm_req_cookie_merge
  （patch 覆盖 base 同名 cookie，MUSIC_A/__remember_me 等不丢）。
- core/ncm_login.c|h：ncm_login_refresh（eapi /api/login/token/refresh 空体，
  code200+set-cookie→merge；code!=200→NCM_ERR_AUTH 退扫码；网络/TLS→负码退避）。
- app/logic/account.c：account.json 增 last_refresh_ts + 拆分 cvip/svip；
  account_cookie_maybe_refresh（年龄阈值 12h 可配 ncm.cookie_refresh_h，单飞/boot，
  失败冷却 30min 跨 boot 持久化，AUTH 置回登录页标志）+ mark_fresh/need_relogin。
- app/ui/home.c：home_worker 先续期再拉歌单；app/ui/login.c：803 落盘后 mark_fresh；
  app/app.c：UI tick 消费回登录标志 → logout+切登录页。
- 新增测试：test_ncm_core 的 cookie_merge + eapi_musicu_hdr；bench/cookie_refresh_sim
  （端点语义，0 网络）；bench/account_cookie_sim（临期/未临期/退避/失效/冷却，0 网络）。

验证：host+qemu 核心测试 PASS；build_ncm_sims.sh 全家桶 PASS；build_ncm.sh 0 warning。
真机只读探针 2 次（设备 10.78.193.50，不写回）：refresh 走 eapi 域
interface.music.163.com 在当前网络被 TLS reset（alert 80）→ rc=-5 瞬断退避，
session.enc/deviceId md5 前后一致（登录态零损伤）。新 ncm md5 c960244b。
 2026-09-02 14:30:04 +08:00
AskaEth de18cef02c feat(ncm): 缓存分目录（songs//covers/）+ 陈旧 mp3 缓存修复 
任务1 缓存分目录（用户定案）：\n- ncm_cache_init mkdir songs/ 与 covers/ 子目录 + 一次性迁移\n  （根混放 song_*/cov*/cover_current.jpg 挪进两子目录，幂等，legacy_migrated 计数）\n- ncm_cache_path 按 id 前缀路由（cov*→covers/，其余→songs/）\n- LRU（evict/total_bytes/7天 .part 回收）只扫 songs/；clear 清 songs/+covers/ 的 song_*\n- cover.c save_cover_raw 落 covers/cover_current.jpg\n\n任务2 陈旧 mp3 缓存修复（真机实锤：hires 档键下存 mp3，播放命中旧档）：\n- song_local_file 缓存命中且用户档>EXHIGH（无损+）且实体是 .mp3 = 静默降级产物\n  → 迁移重命名到 exhigh 键 song_<id>_exhigh.mp3（选极高仍可用；目标已存在删旧）\n  → 本档视为未命中走下载（311 flac 门禁拿真无损/正确降级）\n\n验证：cache_evict_sim case10（目录迁移一次成型）+P1-9；player_flow_sim P13（迁移+miss）\n+P1-12 零回归；stream/window/search/degrade/cover_chain/test_ncm_core(host+qemu) 全 PASS；\nbuild_ncm.sh -Wall -Wextra 0 warning。0 真实请求。新 ncm md5 a90ba8c3 (text1028458/bss1364484)。
 2026-09-02 13:51:36 +08:00
AskaEth ea645ce2a6 feat(ncm): 风控加固——接口响应短 TTL 缓存 + 游客 MUSIC_A + track/all 死代码 
三（按 NCMAPI_NOTES §2.1/§4/§6）：
① 接口级响应缓存（对齐参考 apicache 2 分钟，防风控高频 ip 错误）：
   - 新增 core/ncm_apicache.{c,h}——内存 4 槽 LRU（单槽≤128KB，TTL 120s，
     键=md5(path+\x01+json)）+ 可选盘缓存 <data_dir>/ncm_api_cache/.json
     （8B 墙钟头+body，超 TTL miss 并删，30s 节流清过期）。自包含模块
     （仅 libc+pthread+clock_gettime），可独立链接无符号冲突。
   - ncm_api.c：api_post 拆「请求+解析」两段，新增 api_post_cached；四个只读
     接口接线：user_playlist/playlist_detail/song_detail/cloudsearch。
     song_url/lyric/vip 不入缓存。
   - 手动刷新绕过：ncm_api_cache_refresh_path(path) 一次性标记；home/歌单
     topbar ↻ 接入；playlist_open/search 不标记（走缓存）。
   - 盘层挂载 appstate_init；登出 appstate_logout 全清（防串账号）。
② 游客 MUSIC_A：ncm_req.c weapi+eapi 无 MUSIC_U 且非 login 路径补
   MUSIC_A=anonymous_token（对齐参考 cookie 伪装）。
③ track/all 死代码清理：移除 ncm_api_playlist_track_all（真实服务器 8 形态全
   404，无调用点）；ncm_api_parse_track_all 保留（离线重放/单测），注释标注
   「已验证不存在，勿用于真实请求」。

验证：新 bench/apicache_sim.c（0 网络）①TTL 内不重复请求/②过期重拉/③手动
刷新绕过/④cloudsearch 按键区分/⑤清空重拉/⑥盘缓存写入+clear 全 PASS；stream/
player_flow/window/search/cache_evict(1-9)/pagination/playlist_race sim 全
PASS；test_ncm_core host+mipsel(qemu) PASS；build_ncm.sh -Wall -Wextra 0
warning（text 1026914/data 1664/bss 1363460）；0 高频真实请求。新 ncm md5
a69c93538920eba9d42a2ebb42f8fdca（留主会话上卡）。
 2026-09-02 12:48:34 +08:00
AskaEth 986944ff24 fix(ncm): 歌词页封面拉伸铺满→等比居中放大（contain，四周主题底；方图不再变形） 2026-09-02 11:47:49 +08:00
AskaEth 2bfe1ed796 feat(ncm): 封面死链兜底链 —— 原 picUrl 失败→web 端 song/detail 重取活链→歌单封面兜底 
用户调研: 官方旧版 GET music.163.com/api/song/detail/?id=<id>&ids=[<id>] 免登录出
songs[0].album.picUrl/blurPicUrl。本批宿主实锤: 登录态 eapi 给的死链封面, 该 web 接口给不同活链
(死链 yR2VGt7.../10995116862531 -> album.picUrl p2.../6y-UleORIT.../...jpg 活 PNG 146KB)。

实现 (patch_v2/ncm_app/):
- cover_request(url, song_id): 新增第二参曲目 id; g_tgt_song 记录; 新目标重置 g_fb_done。
  player.c 三处传 s.id(专辑封面), playlist.c 传 NULL(歌单封面无兜底)。
- cover_song_detail_pic(song_id): web song/detail 重取 album.picUrl(缺 blurPicUrl);
  ids=[<id>] 的 [ ] URL 编码 %5B/%5D(裸[ ] curl 报 bad range); 带 Referer+桌面UA; ncm_http_request
  (头进 resp->headers, 体进 16KB 栈缓冲) + ncm_json 解析; 只读一次。
- cover_try_fallback(url, song_id): 仅原链确定性失败时触发; g_tgt_url 仍==url(未被换走) + 曲目非空 +
  未兜底 + 同曲 5 分钟冷却(ncm_monotonic_ms) 才下探; 拿到不同新图->记冷却/置 g_fb_done/换目标返 1
  (worker 重试新图); 无新图/冷却中/已兜底/目标被换走->返 0 走歌单封面兜底; 每步日志写清级别。
- worker: kind=1(webp)/kind=2(非图)/确定性4xx 死链分支清目标前先
  if(song[0]&&!fb_done&&cover_try_fallback(url,song)) continue; 瞬时错误仍指数退避不触发。
- 风控: 只在原链失败触发(不新增常规请求); 单曲目最多一次(g_fb_done)+5分钟冷却。

验证 (宿主+qemu, 0 新增真实 CDN 业务请求):
- cover_chain_sim T1-T12 ALL PASS(新增 T11 原链死->song/detail活链->出图+恰1次+song-detail fallback日志;
  T12 兜底也死->留歌单封面+同曲再请求 song/detail 0次(冷却)+cooldown日志)。
- cache_evict/player_flow/window/search/stream sim 全 PASS; core host+mipsel(qemu) PASS;
  build_ncm.sh 0 warning(text 1022210/bss 1362564,+64B); ncm_host UI dump exit=0。
  新 ncm md5 e1f4b7ade834b18c7910b9c3e64bc858 (未部署, 留主会话上卡)。
 2026-09-02 11:41:54 +08:00
AskaEth 9d93f1b1ef fix(ncm): 封面矩阵实锤修正 —— 200解码失败=死对象返JSON错误体(非webp)/UA改桌面浏览器(CNMPlayer UA被拦403)/非图k不定性不重试 
真机(设备恢复)CDN 行为矩阵结论并落地:
- 裸请求(无Referer)→403: 防盗链坐实, 封面请求头加 Referer https://music.163.com/。
- +Referer 仍不返真图; 全部变体只见 403/404/200+JSON错误体(43B {"code, application/json)。
  ③「200解码失败」真因=源站死对象返 200+JSON错误体, 非webp; stbi解不了→旧逻辑盲指数退避8次。
  → download_cover 回填 *out_kind(0可解码/1 webp/2非图), worker 对 kind=1/2 与确定性 4xx 一律
  立即清目标走兜底(保留歌单封面)不重试; kind=2 打 'not an image (origin error body/200)'。
- UA 分表: CNMPlayer口径 UA(Mozilla/5.0 CNMPlayer/0.1)同Referer也返403(CDN拦bot串);
  桌面 Chrome UA(旧cover.c)返200。→ NCM_COVER_UA 改回桌面浏览器 UA。
- ?param=300y300 在死对象上→404(对死链无效); 存活URL未获样本, 保留 USE_PARAM=1(标准缩略)。
- cover_chain_sim 增 T10(200+JSON→非图不重试) + stub 内容加 JPEG 魔数(过 body_is_decodable_img);
  T1-T10 ALL PASS。mipsel 0 warning(text 1020306/bss 1362500 持平)。

新 ncm md5 06896b54f31ddf55980cbf921a00d67a (未部署, 留主会话上卡)
 2026-09-02 10:50:07 +08:00
AskaEth aeb9176101 fix(ncm): 封面链分诊与修复 —— CNMPlayer 头(Referer+UA 解403)/webp 魔数内容型先判不解码走兜底/URL 追加 param=300y300 缩略图/403 与 webp 单独分诊日志不盲重试 
- cover.c: 请求头对齐 CNMPlayer(Referer https://music.163.com/ + UA Mozilla/5.0 CNMPlayer/0.1)；
  下载后先判 content-type 含 webp 或临时文件魔数 RIFF....WEBP(stb_image 不支持)，回 webp=1 不解码，
  worker 打 'webp unsupported' 立即清目标走兜底(保留歌单封面)，不再当 fetch failed 盲目指数重试；
  403 单独日志(anti-hotlink/forbidden, no retry)，确定性 4xx 不重试(沿用 311)。
- cover_request 入口 cover_norm_url 追加 ?param=300y300(已有 param= 尊重原样, 溢出保原 URL),
  缓存键/去重/下载 URL 同参版(省内存+出 jpeg)。
- ncm_app_internal.h: NCM_COVER_USE_PARAM/NCM_COVER_PARAM 共享宏(cover.c 与 sim 同源)。
- bench/cover_chain_sim.c: 补 ncm_http_download/meow_img_load_file/meow_img_downscale 桩对齐现行
  cover.c(旧 ncm_http_request 桩已过时), url_hash 同参数规则; 新增 T8 webp/T9 403 用例。
- 验证: cover_chain_sim T1-T9 ALL PASS + stream/player_flow/window/search/cache_evict/degrade/mem
  sim 全 PASS + core host+mipsel(qemu) PASS + build_ncm.sh 0 warning(text 1019834/bss 1362500 持平)
  + ncm_host UI dump exit=0。0 新增真实 CDN 请求; 设备端 CDN 矩阵因设备不可达未执行(见 REPORT 34.6)。

新 ncm md5 a7c22bd4ee3bcd02fb24046d27a33242 (未部署, 留主会话上卡)
 2026-09-02 10:37:24 +08:00
AskaEth bcc016e50e fix(ncm): 播放页歌词解析栈溢出(SIGSEGV)修复 —— lyric_parse 栈上 227KB 临时数组超 128KB 线程栈 
根因（真机 sig=11，RA 落 lyric_parse / pc 在 lib）：
app/logic/lyric.c lyric_parse() 在栈上定义
  long ttmp[NCM_LYRIC_LINES=600]; char txt[600][192]; char tl[600][192]
  = ~227KB 栈帧，远超 ncm_thread_create 统一设的 NCM_THREAD_STACK=128KB。
播放页 enter → player_manager_load_lyric → lyric_worker(128KB 线程栈) → lyric_parse → 栈溢出 SIGSEGV。
崩溃仅在「播放页前台 + 拉取歌词成功 + 解析」时触发，故与播放进度无关、autoplay 仅后台起播不崩。

修法：排序临时数组移到堆（按 s_n 计，≤600 行，峰值 ~230KB 瞬态），栈帧回到 KB 级。

复现/定位（/dev 调试 + 真机）：
- 真机通过 amd 恢复路径：/tmp/ncm_autoplay 起播缓存曲，app_on_tick 于 UI 线程调 player_play_song
  打开播放页（复现用户点曲路径；autoplay_ui_consume 承接）。原崩溃：pid sig=11 dur=3683ms；
  修复后：连续两次 play:start 无崩溃、60s+ 存活、无 crash_report。
- app.c 增 async-signal-safe SIGSEGV/SIGBUS/SIGILL 处理器（MIPS mcontext_t.pc + gregs ra/sp/fp
  → stderr + crash_report.txt），供 addr2line/链接布局定位。

验证：stream/player_flow/window/search/cache_evict sim 全 PASS；test_ncm_core host + qemu-mipsel
PASS；build_ncm.sh -Wall -Wextra 0 warning；ncm_host NCM_PAGE=player/home 离屏渲染 exit=0。
 2026-09-02 09:53:34 +08:00
AskaEth 44a790dc1d fix(ncm §33): 流媒专项批六项——流式SIGSEGV防御日志/档位保真(无损级必须flac+显示档按实际)/封面4xx不重试/收藏显隐/缓存命名迁移/topbar位图图标 
- §2① ncm_api.c level_attempt: 无损级(hires/lossless及以上)命中必须 type=flac，返回 mp3 视为该档不可用续降
  (修「hires 档静默给 mp3 被当命中」)
- §2② player_manager.c eff_level_for_resp: 显示档按响应实际格式/码率——mp3 绝不显示 Hi-Res(≤128k→标准, 否则极高),
  flac 采信链 eff; br 未知钳 ≤EXHIGH
- §1 流式 SIGSEGV(《十面埋伏》sig=11) 审计+UBSAN 探针未复现 → 落地防御日志(dl start/done/interrupt + play done fin/exp/fail/underrun)
- §3 cover.c: download_cover 回填 rc/status; 确定性 4xx(404等)不重试立即跳下一张, 仅瞬时错误退避(rc=%d status=%d 日志)
- §4 playlist.c: pl_show_fav 我创建(is_collected==0)隐藏收藏钮, 我收藏保留, 搜索歌单保守显示(评论槽并入无空洞)
- §5 ncm_cache.c 双点→单点迁移 + player_manager song_local_file 旧键→当前档位键(不重下)
- §6 home.c: topbar 动作 ⚙↻⌕ 迁移 sb_icons 位图(meow_topappbar_set_item_icon, 修 4k 字库豆腐)
- 测试: test_ncm_core 新 test_grade_flac_gate + test_cache 双点迁移断言; degrade_sim/player_flow_sim 桩 flac 化
- 验证: stream/player_flow/window/search/cache_evict/degrade sim 全 PASS + test_ncm_core host+mipsel(qemu) + mem_sim + build_ncm.sh 0 warning
- 新 ncm md5 cb818786 (text 1017110/bss 1362500), 未部署留主会话; 0 真实 NCM 业务请求
 2026-09-02 04:20:46 +08:00
AskaEth 68ce46a5d8 fix(ncm §32): 内存瘦身修 OOM 被杀 —— 封面降采样(8.28MB→0.78MB) + 瞬态 rbuf 缩减 + 线程栈显式 
真机 dmesg 实锤：OOM Kill ncm (score 460, anon-rss 26.9MB, 设备 56MB)。
画像：封面全分辨率 RGBA 8.28MB(1448x1448 原生解码驻留) 是最大可控块。

瘦身（按收益排序）：
1. sdk meow_ui_img 新增纯增量 meow_img_downscale + cover.c cover_cap(≤480px)
   → 封面 8.28MB→0.78MB，-7.65MB（mem_sim 实测 PASS）。
2. ncm_api.c 瞬态响应 rbuf：song_url→64KB、lyric/song_detail/cloudsearch/user_playlist→256KB
   （detail/track_all 保 1MB）。
3. ncm_app_internal.h 新增 ncm_thread_create（显式 128KB 栈），替换全部 14 处 pthread_create。
4. 滑动窗口/meta 复核零回退（window_sim：608B/首，6000 首 280KB 恒定）。

验证：mem_sim 封面收益 PASS + host home/player 渲染 OK + stream_sim/player_flow_sim/
window_sim/search_sim/cache_evict_sim 全 PASS + test_ncm_core host+mipsel(qemu) PASS
+ build_ncm.sh -Wall -Wextra 0 warning。真机 scp 播放在跑确认（缓存曲，0 播放请求）。

新 ncm md5 44fa16fe（text 1015150/bss 1362500）。正式部署留主会话。
 2026-09-02 03:43:42 +08:00
AskaEth 10690bc348 fix(ncm §31): 修两处 UI 数据竞态——返回首页行空白(staging发布) + 进第二个歌单显示上一歌单(换歌单清窗) 
A. 返回首页各行 2~3s 空白：appstate_load_playlists 就地 memset(g_st.playlists[])
   与 home_src2 无锁逐行绑定竞态，刷新期间 playlist_count 保留旧值 → UI 读清零行。
   照搬 s_build[] staging 范式：网络落 s_pls[] → 成功后锁内原子发布(拷回+更新count)，
   失败保留旧快照(断网离线浏览)。绝不就地清零 UI 可见数组。

B. 进第二个歌单显示上一歌单：playlist_open/refresh 同步路径不调 appstate_playlist_reset，
   pl_apply(1) 绑到上一歌单残留窗口(track_ids_count/songs)。
   新增窗口归属(歌单 id 唯一标识, 对搜索歌单同样成立): worker 首屏发布后
   appstate_playlist_window_set；refresh 目标≠归属(窗口is) → 同步 reset 再 pl_apply。
   同歌单手动刷新(id 同)保留旧内容(stale-while-revalidate)。

宿主回归：playlist_race_sim(新 F 并发读无清零态/G 开A→开B 不串)、window/search/
cache_evict/player_flow/stream_sim、test_ncm_core 宿主+mipsel 全 PASS；
build_ncm.sh -Wall -Wextra 0 warning；0 真实请求；未部署。
 2026-09-02 03:03:48 +08:00
AskaEth 97b741cf56 fix(ncm): 播放路径接通 auto_av（300 的降级链接线，修「SQ 被跳过掉标准」真机路径） 2026-09-02 02:48:43 +08:00
AskaEth 33414de7c4 fix(ncm §20.3): 降级链账户/fee感知 auto_av —— 修「SQ 被跳过掉标准」（297） 
根因：ncm_api_song_url_auto 无账户感知，依赖调用方按会员钳顶；若账户 VIP 态未就绪/
错钳到 EXHIGH，降级链从 EXHIGH 起步，LOSSLESS(无损 SQ) 被跳过，直接掉「标准」。
修法：新增 ncm_api_song_url_auto_av[_f]（§20.3 权威形态）：fee∈{1,4} 且非 CVIP →
NCM_ERR_VIP 零请求；按 account_vip 自钳顶(NONE→EXHIGH/CVIP→HIRES/SVIP→SURROUND)；
只试账户可访问档(ncm_api_level_gate<=vip)；落在最近可用档。原 auto/auto_f 行为零回归。
逐级尝试重构为共享 level_attempt（type/url 接受+静默降档采信）。
测试(bench/degrade_sim.c)：fee门禁5例 + auto_av矩阵 vip3×desired9×avail9=243例全PASS
+ 真机复现(CVIP+Hi-Res+有SQ无HiRes→落无损SQ flac)；原90例零回归。
验证：test_ncm_core_host+qemu-mipsel 全PASS；build_core/build_ncm -Wall -Wextra 0 warning。
新 ncm md5 1064a1d686390cc159f18296ee2980ee（未部署，留主会话）。
遗留：player_manager.c 仍调 auto（不传vip/fee），应改请 auto_av(account_vip()+fee)；
真机若仍掉标准需另查旧缓存 song_<id>_hires.mp3 复用或旧二进制。
 2026-09-02 02:41:09 +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
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 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 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 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 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 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 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 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 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