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）」

KEY_CONTROL_DESIGN.md

@@ -97,6 +97,8 @@ watchdog 主循环（`for(;;)`）加按键轮询（`read /dev/input/event0/event
 2. **音量跳步**：watchdog 每按下边沿按 `audio.volume_step` 一步（不做 launcher 的线性渐变）；短按与 launcher 菜单一致，长按不连续爬（媒体落地后可补）。launcher 应用返回时 `settings_load()` 同步。
 3. **左右滑切屏**：**已落地（M2.81 Now Playing 横划页）**——主界面左滑进 Now Playing 大页；左缘返回手势保留。此处旧注「未实现切换逻辑」作废。
 4. **媒体键**：**已落地（M2.81 起路由最近活跃媒体会话）**——播放/上下曲路由到最近活跃媒体会话（MSG_PLAYCTL），无会话时「抓住」不动作。此处旧注「路由待阶段 D」作废。
-5. **插孔消抖（2026-09-01，真机日志实证）**：4.4/3.5 插拔的电气瞬态在音量键 ADC（jz_adc_aux，event2）上产生 VOL_UP 幽灵按住，launcher vol_ramp 曾从 24% 一路爬到上限 50（日志 225391 ramp 起 → 227213 爬满 → 紧随 audiod「jack changed」）。修：launcher 与 watchdog 音量键处理统一读 `/sys/class/switch/{headset,balance}/state`（节流读缓存：launcher 1s / watchdog 500ms，绝不在热路径每圈读文件），插孔状态变化后 **800ms 内忽略音量键边沿**（vol_ramp_begin 不起、在爬 ramp 中止、watchdog 单步忽略）；另有 **ramp 总时长上限 VOL_RAMP_MAX_MS=3000** 兜底，防任何「持续按住」假象一次打满。SDK 输入层（框架 App 前台时的音量路径）需同款消抖——sdk/ 归其主，另行落地。
+5. **插孔消抖（2026-09-01，真机日志实证）**：4.4/3.5 插拔的电气瞬态在音量键 ADC（jz_adc_aux，event2）上产生 VOL_UP 幽灵按住，launcher vol_ramp 曾从 24% 一路爬到上限 50（日志 225391 ramp 起 → 227213 爬满 → 紧随 audiod「jack changed」）。修：launcher 与 watchdog 音量键处理统一读 `/sys/class/switch/{headset,balance}/state`（节流读缓存：launcher 1s / watchdog 500ms，绝不在热路径每圈读文件），插孔状态变化后 **800ms 内忽略音量键边沿**（vol_ramp_begin 不起、在爬 ramp 中止、watchdog 单步忽略）；另有 **ramp 总时长上限 VOL_RAMP_MAX_MS=3000** 兜底，防任何「持续按住」假象一次打满。~~SDK 输入层需同款消抖~~ → **SDK 侧已补齐（56c569f，meow_ui.a 12cdd5d7，hello/files/流媒体客户端重链热更）**：框架 App 前台时的音量键路径同款 800ms 消抖窗。
+6. **音量反转统一（M2.95，2026-09-01）**：CS43198 音量寄存器 = **衰减量**（0=最响 255=静音），旧映射方向反（0 档炸耳、50 档最低）。launcher/audio.c + audiod + **watchdog `wd_vol_adj`** + SDK vol 四路统一 `dac = 255 - pct*255/100`。**watchdog 存盘修复（M2.93）**：`wd_vol_save` 旧 O_TRUNC 整文件重写 settings.conf 曾毁配置（整文件被抹/重复行/丢 max+step）→ 改读改写单键+去重（与 SDK 同款语义）。
+7. **播放/暂停键（164) toggle（262，2026-09-01）**：SDK `meow_ui_media` 旧按本地 `g_last_state` 判 play/pause，流媒体客户端走自有 ipc_media 线程不经 SDK meta → 恒发 cmd=1 播放、播放中按键无效。修：164 **恒发 `MSG_PLAYCTL cmd=6`（toggle）**，由源侧按当前态翻转（launcher 透传不动结构；媒体卡片/NP 页按钮按 launcher 侧 META state 判，本就准，维持现状）。同批修：App 前台状态栏音量%/亮度实时刷新（launcher 叠加层 1s 节流 stat settings.conf，mtime 变才重读同步 g_sys）。
 
 真机验收要点（§7）：应用内电源单击/长按菜单/8s 强关、音量±调音量、播放/上下曲无反应（被抓住）、launcher 菜单同样一致、电源菜单任何界面可弹（含应用内）、息屏后任意键唤醒。