A1: meow_audiod 独占音频服务（agent-244 骨架 + agent-246 真机收尾）

- meow_audiod：启动门控(/tmp/meow_boot_mode 非 meow exit 0)、IO/播放/路由三线程、
  ring ~200ms、ALSA UAPI 独占直开、切率 mute-重配-恢复、抢占(后开赢+PREEMPTED)、
  socket EOF 回收、xrun PREPARE 恢复；meow_route 轮询逻辑并入路由线程
- meow_audio CLI：status/tone/route/vol；services.d/audiod.conf(trigger=manual,on-fail)
- SDK meow_ui_audio.c 编进 meow_ui.a：懒连接/读线程分发 PREEMPTED 回调/EPIPE 标死/
  无 audiod 返回 MEOW_ERR_NOENT 不隐式直开(MEOW_AUDIO_DIRECT=1 仅调试)
- launcher：确认 MeowOS 模式后 meow_svcd start audiod(double-fork best-effort 不阻塞)
- meow_route 退役：S89 预置换 audiod.conf + 清理旧 meow_route.conf(防拉起已删二进制
  重启循环)；fw_content.conf 删 meow_route、加 meow_audiod+meow_audio(md5 打包时填)
- 真机定位并修复 ALSA UAPI 两大坑(即 ncm 播放无声根因)：
  ① hw_params 须全放行初始化(mask 全 1/interval [0,UINT_MAX])，memset 0 interval
     等价只能取 0 → refine 必空 → HW_PARAMS 恒 EINVAL
  ② access/format mask 先清零再单点(pmask 只 OR)，全 1 被 choose 成 MMAP_INTERLEAVED
     → write() 恒 EINVAL
- 附带修复：dev_write fd<0 防日志风暴丢 PCM 限频日志；SDK state 解析 app_id 截空白；
  meow_ui.h 文档负错误码表述修正
- 验证：宿主 FILE sink 全 IPC 链+抢占+tone WAV 20/20，SDK 客户端 13/13；
  qemu-mipsel 同过；真机 tone 44.1k/96k 切率 written=played、underrun=0、日志完整
- meow_ui.a 53a3edd2 → ncm 重链 d2031829(已热更到卡)；launcher a2f932a1

patch_v2/sdk/meow_ui.h

@@ -870,6 +870,52 @@ int  meow_font_set_tier(int tier);
 /* 当前字体档（初始 = MEOW_FONT_TIER_COMMON；meow_ui_init 时读 MEOW_FONT_TIER env 对齐）。 */
 int  meow_font_tier(void);
 
+/* ============================================================ */
+/* §11 独占音频客户端（devdocs/plan/AUDIOD_DESIGN.md §7；meow_ui_audio.c） */
+/* ============================================================ */
+/* 说明：App 只经本 API 喂 PCM 给 meow_audiod（独占 hw:0,0 守护，svcd 托管）。audiod 不在一律
+ * 失败（open 返回 MEOW_ERR_NOENT，负值），不做隐式直开回退；调试可用 env MEOW_AUDIO_DIRECT=1 走
+ * 自带直接 ALSA 直开路径（非正式能力，勿依赖）。
+ * 生命周期：open 取 stream_id>0 → write 喂 PCM（阻塞，socket 背压）→ pause/resume → close 释放。
+ * 被抢占（后开流赢）：SDK 内部读线程收 MSG_AUDIO_PREEMPTED → 调 on_preempt 回调 + 标写死
+ * （后续 write 返回负值，App 应重新 open）。 */
+
+/* 当前流快照（meow_audio_query 填充）。 */
+typedef struct meow_audio_state {
+    int      active;           /* 1=audiod 有活跃流（不一定是本 App 的） */
+    char     app_id[32];       /* 活跃流 app_id（无流为 "-"） */
+    uint32_t stream_id;        /* 活跃流 id */
+    uint32_t rate;             /* 活跃流采样率 */
+    uint16_t ch;               /* 活跃流声道数 */
+    uint16_t fmt;              /* 活跃流格式（AUDIO_FMT_*） */
+    uint64_t written_frames;   /* 客户端写入 ring 的帧 */
+    uint64_t played_frames;    /* 播放线程写到设备的帧 */
+    uint32_t underrun;         /* xrun 计数 */
+    int      paused;           /* 当前流是否暂停 */
+    int      route_port;       /* 当前路由口（-1 未知） */
+    int      vol;              /* 当前音量 0-100 */
+} meow_audio_state;
+
+/* 被抢占回调：by_app=抢占者 app_id（非空）。ctx 由 on_preempt 注册时传入。 */
+typedef void (*meow_audio_preempt_fn)(const char *by_app, void *ctx);
+
+/* 开流。rate/ch/fmt=App 声源原生参数（fmt 值见 meow_ipc.h AUDIO_FMT_*）。
+ * 返回 stream_id(>0)；负错误码（MEOW_ERR_NOENT=audiod 不在；MEOW_ERR_INVAL=参数非法；
+ * MEOW_ERR_NODEV=无可用 PCM 设备；MEOW_ERR_* 常量本身即负值）。open 后客户端须按内部记录的
+ * grant 格式产出 PCM。 */
+int  meow_audio_open(int rate, int ch, int fmt);
+/* 写 PCM。pcm=native fmt/ch 样本（open 传的参数），frames=帧数；内部归一成 grant 并分批发送。
+ * 返回写入帧数；<0=流已死（被抢占/audiod 断开），App 应重新 open。阻塞（socket 背压）。 */
+int  meow_audio_write(const void *pcm, int frames);
+/* 暂停(1)/恢复(0)当前流。返回 0 成功；<0 失败。 */
+int  meow_audio_pause(int sid, int paused);
+/* 关流（STOP + 释放）。返回 0；连接保留供下次 open。 */
+int  meow_audio_close(int sid);
+/* 查询 audiod 快照（填充 out）。返回 0 成功；<0 失败。 */
+int  meow_audio_query(meow_audio_state *out);
+/* 注册被抢占回调（可选；内部读线程分发）。重复调用幂等。 */
+void meow_audio_on_preempt(meow_audio_preempt_fn cb, void *ctx);
+
 #ifdef __cplusplus
 }
 #endif