meowpanel: 新增 /api/audio（audiod MSG_AUDIO_QUERY→STATE 透传, 不在时 available:false）+ 前端「音频」页(5s轮询只读)与「字体」页(列表/上传进度态/导出/409冲突确认force重试); 后端 md5 015f9cf1

patch_v2/meowpanel/README.md

@@ -28,7 +28,7 @@ cd /home/Aska/Project/R3ProII/patch_v2/meowpanel
 - 两分支均以 `-Os -Wall -Wextra` 复核，**0 warning**（`-Werror` 亦通过）。
 - 产出（本次构建实测）：
   - `meowpanel`：mipsel 静态，`ELF 32-bit LSB executable, MIPS, MIPS32 rel2, statically linked, stripped`，
-    体积约 **218 KB**（固件阈值内）。md5：`51ffc183403aa20e0d19d0f811c300b7`（本次含字体库 tar.gz 导入/导出 + 排序修复）。
+    体积约 **218 KB**（固件阈值内）。md5：`015f9cf1c12e36d133b01cf6b6648edd`（本次含 `/api/audio` 音频状态端点 + 前端「音频」「字体」页）。
   - `meowpanel_host`：aarch64 动态链接（宿主编译，仅供调试），体积约 **148 KB**。
 - 依赖：仅 libc + Linux 内核头（`linux/input.h`），零第三方库（设备无 python3/lua）。鉴权用**内联 SHA-256**（拷贝自
   `meow_verify/sha256.c` 公有领域参考写法，前缀 `mp_sha256_*` 避免符号冲突；**未改 `meow_verify/` 目录**）。
@@ -112,6 +112,7 @@ http://<host>.local:8080/
 | GET | `/api/fonts` | 字体库列表（扫描 `MeowOS/fonts/<family>/<weight>/` 三件套齐） | ✅（无卡→503） |
 | POST | `/api/fonts/import` | 上传字体库 `.tar.gz`（multipart `file`，可带 `?force=1` 覆盖） | ✅（缺件/坏json/穿越→400，冲突→409，超限→413） |
 | GET | `/api/fonts/export` | 导出 `<family>/<weight>/` 三件套为 `.tar.gz`（`?family=&weight=`） | ✅（缺件→404） |
+| GET | `/api/audio` | 音频状态快照：meow_audiod IPC `MSG_AUDIO_QUERY→STATE` 透传（当前流/路由/音量/underrun，见 §5.12） | ✅（audiod 不在→`available:false`，不报错） |
 | GET | `/api/apps` | 扫描 `MeowAPPs/` 读 `app.json` | ✅ |
 | GET | `/api/apps/:pkg` | 应用详情 | ✅ |
 | POST | `/api/apps/install` | 经 `nyai install`（multipart 或 path） | ✅ |
@@ -306,6 +307,27 @@ http://<host>.local:8080/
   再导入→逐字节一致；GNU tar/`tarfile` 均能读；目录穿越 `../`/绝对路径/软链成员/缺件/坏 font.json/多出条目/
   子目录包裹/非 gzip——全部拒绝；打包文件名 `<family>-<weight>.font.tar.gz`。见 §7 宿主测试备注。
 
+### 5.12 音频状态（`/api/audio`，新增，AUDIOD_DESIGN §8 面板对接）
+- **数据源**：`meow_audiod` 独占音频守护（板载进固件，svcd 托管；HibyOS 模式按门控不启动）。
+  后端连 `/usr/data/meow_audio.sock`（可被 `--sock-audio` / env `MEOW_AUDIO_SOCK` 覆盖，宿主/qemu 测试用，
+  与 audiod CLI 同 env），发 `MSG_AUDIO_QUERY`(0x00C7) 空负载，收 `MSG_AUDIO_STATE`(0x00C8) 文本帧
+  （`active=.. app=.. sid=.. rate=.. ch=.. fmt=.. written=.. played=.. underrun=.. paused=.. route_mode=.. port=.. vol=..`，
+  空格分隔 k=v、NUL 结尾）。**audiod 无 MSG_HELLO 握手**（见 meow_audio.c CLI），与 perf/power/launcher 路径不同。
+- **响应**：解析 k=v 为 JSON——`{available:true, active, app, sid, rate, ch, fmt, written_frames, played_frames,
+  underrun, paused, route_mode("auto"/"manual"), port, vol}`；`port` 为 amixer numid=9 路由口
+  （0=空闲 1=lineout 2=3.5 3=4.4 4=Type-C SPDIF；宿主无 amixer 时为 -1）。
+- **audiod 不在**（socket 缺失/连接拒/超时/非预期应答）→ HTTP 200 `{"available":false}`，**不报错**（面板音频页显示
+  「audiod 不可用」）。只读端点；不放测试音（真机乱响风险，tone 留给 CLI `meow_audio tone`）。
+- **前端**：「音频」页（`web/#/audio`）5s 轮询展示——当前流（app/rate/ch/fmt/已写帧/已播放帧/underrun/暂停态）+
+  路由口 + 音量 + audiod 可用性；切页即停轮询。
+
+### 5.13 字体管理页（前端 `web/#/fonts`，新增）
+- 后端 `/api/fonts*` 三端点（§5.11，agent-243 落地）的专属页面：表格列出 family/weight/name/tier/glyph_count，
+  行内「导出」（busy 防连点「打包中…」）+ 顶部「上传字体库 .tar.gz」（导入中禁用按钮=进度态）+「刷新」。
+- 上传遇 **409 CONFLICT**（同 family/weight 已存在）→ 弹确认框，确认后带 `?force=1` 重试；成功 toast 带
+  `family/weight` 与 `warning`（sha256 不符仅提示）/`hint`。
+- 设置页原「字体库」卡保留（同一后端，互不影响）。
+
 ---
 
 ## 6. 与协议的出入（「实现为准 + 原因」，供回改 MEOWPANEL_PROTOCOL.md）
@@ -345,6 +367,10 @@ http://<host>.local:8080/
     上限 32MB，`?force=1` 覆盖）/`/api/fonts/export`（导出，GET，`<family>-<weight>.font.tar.gz`）。前两者由前端设置页「字体库」卡接入。
     还修正了 `/api/files` 排序：**目录优先 + 名称自然排序**（数字感知 track2<track10，中文按无符号字节序，见 §5.4）。
     **导入不触发 launcher 重扫**（扫描时机=启动/进设置页），响应用 `hint` 提示。
+14. **`/api/audio`（新增，§5.12）**：协议 §2 无此端点。按 AUDIOD_DESIGN §8「MSG_AUDIO_STATE 供 MeowPanel 系统/音频页展示」落地——
+    连 audiod sock 发 `MSG_AUDIO_QUERY`(0x00C7)、收 `MSG_AUDIO_STATE`(0x00C8) k=v 文本解析为 JSON 透传；**audiod 无握手**、
+    不在时回 `{"available":false}`（200，非错误）。前端新增「音频」页（5s 轮询只读）。同批新增前端「字体」页（§5.13，
+    `/api/fonts*` 的专属页；设置页字体库卡保留）。
 
 ---
 
@@ -392,17 +418,17 @@ http://<host>.local:8080/
 
 ```
 patch_v2/meowpanel/
-├── meowpanel.c             # 后端源码（约 4560 行，-Wall -Wextra 0 warning；含可选鉴权/内联 SHA-256/实时画面+增量帧/触摸注入/通知 IPC 实时化/字体库 tar.gz 导入导出/自然排序）
+├── meowpanel.c             # 后端源码（约 4650 行，-Wall -Wextra 0 warning；含可选鉴权/内联 SHA-256/实时画面+增量帧/触摸注入/通知 IPC 实时化/字体库 tar.gz 导入导出/自然排序/audiod 状态快照）
 ├── mp_jpeg.c               # 最小 baseline JPEG 编码器（顺序 DCT + 4:2:0 + 标准 Huffman，整数定点，无 libm，-Wall -Wextra 0 warning）
 ├── mp_jpeg.h               # mp_jpeg.c 接口（RGB565 → 内存 JPEG）
 ├── build_meowpanel.sh      # 交叉编译 + host 分支（-Wall -Wextra 0 warning；meowpanel.c + mp_jpeg.c）
-├── meowpanel               # 交叉产物（mipsel 静态，约 218 KB，md5 51ffc183…）
+├── meowpanel               # 交叉产物（mipsel 静态，约 218 KB，md5 015f9cf1…）
 ├── meowpanel_host          # 宿主编译（本机 ld，调试用）
 ├── services.d/
 │   └── meowpanel.conf      # 部署到 TF 卡 MeowOS/services.d/meowpanel.conf
 ├── web/                    # 前端（已存在；部署时拷到后端同目录）
-│   ├── index.html          # 含登录页 overlay + 设置密码对话框
+│   ├── index.html          # 含登录页 overlay + 设置密码对话框 + 音频/字体导航
 │   ├── meowpanel.css       # 含登录页样式
-│   └── meowpanel.js        # API 客户端带 token/401 登录、设置页鉴权卡片
+│   └── meowpanel.js        # API 客户端带 token/401 登录、设置页鉴权卡片、音频页(5s轮询)/字体页
 └── README.md               # 本文件
 ```