docs: 文档一致性整理 (agent-249) — 对齐 M2.90/0.7.85 + ncm A2: SDK 新增 §5.9 meow_audio_* 客户端 API + IME 九键数字盘注记; README 网易云三期+A2 audiod+PCM 挂死已知问题; APPS §3.7/§5 直开 hw:0,0 旧案标注被 meow_audiod 取代; SETTINGS audio.output/音量键 audiod 收口注记; FRAMEWORK §10.1 supervisor 树补 meow_audiod + 头部里程碑 M2.90; PLAN 头部截至 M2.90; SPEC_REF OPEN_QUESTIONS 摘要同步 (#4/#12/#17 清结)

This commit is contained in:
MeowOS committed 2026-09-01 03:11:10 +08:00
1 parent 697fd6ba9b
commit 57509cd582
7 files changed
+39 -8

No files matched your search

+4 -2
View File
@@ -312,6 +312,8 @@ meow_launcherd --sim-exit N # 菜单打开 N 毫秒后模拟退出
## 5. 音频通路(未来应用的出声方案) ## 5. 音频通路(未来应用的出声方案)
> **2026-09-01 更新**:常驻模式(MeowOS 主控、播放器未运行)下的出声方案**已由 `meow_audiod` 独占音频守护落地(M2.90)**——守护独占 hw:0,0、App 经 SDK `meow_audio_*` 喂 PCM(MEOW_APP_SDK §5.9 / `devdocs/plan/AUDIOD_DESIGN.md`)。本节下述 v3 候选为「会话覆盖模式(HibyOS 热键唤起、SIGSTOP 冻结播放器)」的历史推演,仅在该模式下仍有参考意义;常驻模式直开 hw:0,0 的旧结论见 §3.7。
参考 ANALYSIS.md 第 11 节结论: 参考 ANALYSIS.md 第 11 节结论:
- 声卡 = 内部唯一 card0(CS43198 双 DAC),**无混音**,谁打开谁独占;hiby_player 常驻持有 `hw:0,0`。 - 声卡 = 内部唯一 card0(CS43198 双 DAC),**无混音**,谁打开谁独占;hiby_player 常驻持有 `hw:0,0`。
@@ -456,8 +458,8 @@ Description: A simulated app
**与 launcher 一致**:install/export 复用 M2.12 `meow_pkg_install/export` 同套语义(tar.gz、gzip 管道、包名=文件名茎、同名先备份、校验 app.json、数据 init);exFAT 无符号链接,数据目录由 MeowOS 经 `MEOW_DATA_DIR/CACHE_DIR` 注入,CLI 只建目录不建链接。 **与 launcher 一致**:install/export 复用 M2.12 `meow_pkg_install/export` 同套语义(tar.gz、gzip 管道、包名=文件名茎、同名先备份、校验 app.json、数据 init);exFAT 无符号链接,数据目录由 MeowOS 经 `MEOW_DATA_DIR/CACHE_DIR` 注入,CLI 只建目录不建链接。
### 3.7 音频通路与媒体键(2026-08-31 实测定案,覆盖 §5 旧推论) ### 3.7 音频通路与媒体键(2026-08-31 实测定案,覆盖 §5 旧推论;**M2.90 起被 meow_audiod 收口,见末段**)
- **MeowOS 常驻模式(boot 直进,hiby_player 未运行)声卡空闲**:真机实测 `fuser /dev/snd/pcmC0D0p /dev/snd/controlC0` 无任何占用、`pidof hiby_player` 不存在——**MeowAPP 可直接 open `hw:0,0` 出声**(audio.output 设置键即此);无混音,后开者失败,音频焦点=先占先得(媒体会话/MPRIS 落地后再规范抢占语义)。 - **MeowOS 常驻模式(boot 直进,hiby_player 未运行)声卡空闲**:真机实测 `fuser /dev/snd/pcmC0D0p /dev/snd/controlC0` 无任何占用、`pidof hiby_player` 不存在。~~MeowAPP 可直接 open `hw:0,0` 出声~~ → **M2.90 起改走 `meow_audiod` 独占音频守护**:守护独占 hw:0,0,App 经 SDK `meow_audio_*` 客户端喂 PCM(见 MEOW_APP_SDK §5.9 / `devdocs/plan/AUDIOD_DESIGN.md`);独占+抢占(后开流赢,旧流收 PREEMPTED)、DAC 原生率跟随无 SRC、路由自动跟随插孔(meow_route 并入退役);App 直开仅 `MEOW_AUDIO_DIRECT=1` 调试用。媒体键路由最近活跃媒体会话不变。
- **会话覆盖模式(HibyOS 运行中热键唤起)**:SIGSTOP 冻结播放器,声卡仍被其持有,App 无声(§5 旧结论,仅适用该模式)。 - **会话覆盖模式(HibyOS 运行中热键唤起)**:SIGSTOP 冻结播放器,声卡仍被其持有,App 无声(§5 旧结论,仅适用该模式)。
- **物理媒体键路由**:MeowOS 与 HibyOS 不同时运行,不存在「转发给 hiby」问题;MeowOS 界面下播放/上下曲 = 全局媒体控制,路由给**最近活跃媒体会话**(**媒体会话已落地** M2.81:`MSG_META`(0x72)/`MSG_PLAYCTL`(0x73) + meow_media 最近活跃源(active_seq,30s 超时回收)+ 通知中心媒体卡片 + Now Playing 大页;**dev.player.ncm**(原 os.meow.ncm,agent-221 改名)是首真实媒体源),无会话时「抓住」不动作。 - **物理媒体键路由**:MeowOS 与 HibyOS 不同时运行,不存在「转发给 hiby」问题;MeowOS 界面下播放/上下曲 = 全局媒体控制,路由给**最近活跃媒体会话**(**媒体会话已落地** M2.81:`MSG_META`(0x72)/`MSG_PLAYCTL`(0x73) + meow_media 最近活跃源(active_seq,30s 超时回收)+ 通知中心媒体卡片 + Now Playing 大页;**dev.player.ncm**(原 os.meow.ncm,agent-221 改名)是首真实媒体源),无会话时「抓住」不动作。
+1 -1
View File
@@ -2,7 +2,7 @@
> 目标:把 R3 Pro II 打造成可扩展的"第二系统"。**MeowOS 作为主控层优先启动、拥有屏幕与输入;HibyOS 播放器降级为 MeowOS 启动的一个内置系统应用**(Android home/launcher 模型)。MeowLauncher(即 MeowOS 核心)、MeowAPPs、MeowPanel 均为其组成部分。 > 目标:把 R3 Pro II 打造成可扩展的"第二系统"。**MeowOS 作为主控层优先启动、拥有屏幕与输入;HibyOS 播放器降级为 MeowOS 启动的一个内置系统应用**(Android home/launcher 模型)。MeowLauncher(即 MeowOS 核心)、MeowAPPs、MeowPanel 均为其组成部分。
> 本文档是路线图与分阶段计划。当前技术档案见 `ANALYSIS.md`,应用规范见 `APPS.md`,框架协议见 `FRAMEWORK_DESIGN.md`。 > 本文档是路线图与分阶段计划。当前技术档案见 `ANALYSIS.md`,应用规范见 `APPS.md`,框架协议见 `FRAMEWORK_DESIGN.md`。
> **⚠️ 本文档为公开路线图,自身已过时**:里程碑/阶段划分以**实际进度为准**(权威现状见 `devdocs/WORK_STATE.md`,本仓库 gitignore 不入库)。截至 **M2.88(0.7.83)** 已达成(M2.69→M2.88 全链路:launcher 拆分/控件库/系统框架专项服务/主界面 MD3 双布局/M3 导航栈+M5 通知跳转/媒体会话+Now Playing/SDK nav+media 封装/字库启动竞态修复/**amsd 一期+二期(picker 契约)/签名鉴权 2B/meow_route 音频路由/网易云二期/MeowPanel 实时画面·遥屏/中文拼音 IME**);下方「当前主线」为实际推进序列,**按依赖因果排列,非平行**;旧「阶段拓扑序」仅作背景参考,勿按它安排开发。 > **⚠️ 本文档为公开路线图,自身已过时**:里程碑/阶段划分以**实际进度为准**(权威现状见 `devdocs/WORK_STATE.md`,本仓库 gitignore 不入库)。截至 **M2.90(0.7.85)** 已达成(M2.69→M2.90 全链路:launcher 拆分/控件库/系统框架专项服务/主界面 MD3 双布局/M3 导航栈+M5 通知跳转/媒体会话+Now Playing/SDK nav+media 封装/字库启动竞态修复/**amsd 一期+二期(picker 契约)/签名鉴权 2B/网易云三期/MeowPanel 实时画面·遥屏/中文拼音 IME/开机选单抢屏回归修复/MIUIx 顶级主题/meow_audiod 独占音频守护(meow_route 并入退役)/ncm A2 迁 audiod**);下方「当前主线」为实际推进序列,**按依赖因果排列,非平行**;旧「阶段拓扑序」仅作背景参考,勿按它安排开发。
--- ---
+2 -1
View File
@@ -1,6 +1,6 @@
# MeowOS 阶段 D:Activity / 通知 IPC 框架设计文档 # MeowOS 阶段 D:Activity / 通知 IPC 框架设计文档
> 状态:协议/架构参考稿(2026-08-28 起草;**以下协议已随 M2.15-M2.88 各里程碑落地**,消息号以 `patch_v2/meow_launcherd/meow_ipc.h` 为准)。本阶段的「只设计、不实现」为起草期口径;M0-M3/M5/§10.5/媒体会话/amsd 已实现,M4 后台服务保活与 M6 加固待排期(见 §9 进度)。 > 状态:协议/架构参考稿(2026-08-28 起草;**以下协议已随 M2.15-M2.90 各里程碑落地**,消息号以 `patch_v2/meow_launcherd/meow_ipc.h` 为准)。本阶段的「只设计、不实现」为起草期口径;M0-M3/M5/§10.5/媒体会话/amsd/meow_audiod(独占音频守护,规范 `devdocs/plan/AUDIOD_DESIGN.md`)已实现,M4 后台服务保活与 M6 加固待排期(见 §9 进度)。
> 前置:ANALYSIS.md §18(Launcher 全架构)、§11(播放器 unix socket 先例)、APPS.md、DEVELOPMENT_PLAN.md 阶段 0/D。 > 前置:ANALYSIS.md §18(Launcher 全架构)、§11(播放器 unix socket 先例)、APPS.md、DEVELOPMENT_PLAN.md 阶段 0/D。
> 实现语言:启动器 C(musl 静态 MIPS32r2,zig-mipsel-cc);应用同为 C 静态 MIPS。 > 实现语言:启动器 C(musl 静态 MIPS32r2,zig-mipsel-cc);应用同为 C 静态 MIPS。
> 补充:本文件由 plan 子代理产出设计,主会话落盘,并附「后台运行/后台播放权限」(用户追加)。 > 补充:本文件由 plan 子代理产出设计,主会话落盘,并附「后台运行/后台播放权限」(用户追加)。
@@ -147,6 +147,7 @@ meow_sysui(系统进程总监,meow_svcd 托管;最小依赖/不渲染/最
├─ meow_launcherd 系统 UI 渲染宿主(主界面/设置页/电源菜单/全局状态栏/通知中心/全局手势) ├─ meow_launcherd 系统 UI 渲染宿主(主界面/设置页/电源菜单/全局状态栏/通知中心/全局手势)
├─ meow_svcd 服务管理器(服务=独立子进程;逐个子进程崩溃隔离) ├─ meow_svcd 服务管理器(服务=独立子进程;逐个子进程崩溃隔离)
│ ├─ meow_mdns mDNS 应答器(板载 /usr/data/meow/services.d/mdnsd.conf,trigger=boot) │ ├─ meow_mdns mDNS 应答器(板载 /usr/data/meow/services.d/mdnsd.conf,trigger=boot)
│ ├─ meow_audiod 独占音频守护(M2.90;独占 hw:0,0+抢占+路由并入;HibyOS 模式门控 exit(0) 不启动——规范 devdocs/plan/AUDIOD_DESIGN.md)
│ └─ 未来媒体服务 / 其它 services.d 服务(TF MeowOS/services.d/…) │ └─ 未来媒体服务 / 其它 services.d 服务(TF MeowOS/services.d/…)
├─ 未来媒体服务 / MeowPanel(后置) ├─ 未来媒体服务 / MeowPanel(后置)
``` ```
+27 -1
View File
@@ -210,7 +210,7 @@ const char *meow_ime_text(void);
**布局(480×720 竖屏)**:键盘占底部约 40% 高(~290px),上方为输入预览行 + 候选区。键位 40×40(够 touch target),触屏点按输入。 **布局(480×720 竖屏)**:键盘占底部约 40% 高(~290px),上方为输入预览行 + 候选区。键位 40×40(够 touch target),触屏点按输入。
**物理键辅助**(兼容未来硬件键/可访问性):方向键移动光标、播放/确认键=选择、音量=翻页。B1 以触摸为主,物理键作为可选加分项(SDK 内实现)。 **物理键辅助**(兼容未来硬件键/可访问性):方向键移动光标、播放/确认键=选择、音量=翻页。B1 以触摸为主,物理键作为可选加分项(SDK 内实现)。
**[B1 后续 / 不阻塞]**:剪贴板、长按重复等仍留后续。**中文拼音 IME 已落地**(M2.88,agent-229 · `e9b6b69`,设计稿 `devdocs/plan/IME_PINYIN_DESIGN.md`):`meow_pinyin.c` 静态表词库(403 音节 + 329 词,rodata ~20.5KB 零堆)+ 音节切分 DFS+联想引擎,SDK 经 `MEOW_IME_PINYIN` 尾部追加零 ABI 破坏接入(组合条 + 候选栏 + 翻页 + 中英切换,英文零回归)。 **[B1 后续 / 不阻塞]**:剪贴板、长按重复等仍留后续。**中文拼音 IME 已落地**(M2.88,agent-229 · `e9b6b69`,设计稿 `devdocs/plan/IME_PINYIN_DESIGN.md`):`meow_pinyin.c` 静态表词库(403 音节 + 329 词,rodata ~20.5KB 零堆)+ 音节切分 DFS+联想引擎,SDK 经 `MEOW_IME_PINYIN` 尾部追加零 ABI 破坏接入(组合条 + 候选栏 + 翻页 + 中英切换,英文零回归)。**数字键盘九键布局**(M2.89,`21ff5e8`):NUM 模式改居中九键(1-9 自上而下 3×3,0 垫底居中,底行 ESC|0|退格+OK),符号行保留;宿主 test_ime_fix/test_pinyin 全 PASS。
> **实现对齐(M2.73,`meow_ui_ime.c`,以源码为准)**:实现与上表**关键出入**——① 键盘占底部约 **300px**(`KB_TOP=420`,720-420=300),键位 **44×36**(非 40×40);② **回显行 = 实时输入回显**(把 `g_ime_buf` 拼下划线 `"%s_"` 画在面板顶部条),**非候选/联想区**,候选区原留给中文输入法;**中文拼音 IME 已落地**(M2.88 agent-229,候选栏/组合条见 `meow_ime.c`/`meow_pinyin.c`);③ 关闭时**键盘区背景快照/恢复**(`ime_capture`/`ime_restore`,根治关闭后键盘像素残留);④ **配色走主题**(`meow_theme` 语义色,深/浅自动切),不硬编码黑底白键;⑤ **shift 切换大小写**;⑥ 阻塞 `meow_ui_text_input` 打字循环喂 `meow_ui_activity_ping`(重置息屏计时,进度条不卡死);⑦ **OK(回车)= 提交并关闭**(拷贝到 app `ctx->buf`)、**ESC(X)/ 点键盘外背景 = 取消并关闭**;非阻塞 `meow_ui_text_input_async` 用 `meow_ime_active()`/`meow_ime_text()` 轮询(同 close 语义)。上表「布局 40×40 / 物理键辅助 / 候选区」为设计稿表述,已按实际覆盖。 > **实现对齐(M2.73,`meow_ui_ime.c`,以源码为准)**:实现与上表**关键出入**——① 键盘占底部约 **300px**(`KB_TOP=420`,720-420=300),键位 **44×36**(非 40×40);② **回显行 = 实时输入回显**(把 `g_ime_buf` 拼下划线 `"%s_"` 画在面板顶部条),**非候选/联想区**,候选区原留给中文输入法;**中文拼音 IME 已落地**(M2.88 agent-229,候选栏/组合条见 `meow_ime.c`/`meow_pinyin.c`);③ 关闭时**键盘区背景快照/恢复**(`ime_capture`/`ime_restore`,根治关闭后键盘像素残留);④ **配色走主题**(`meow_theme` 语义色,深/浅自动切),不硬编码黑底白键;⑤ **shift 切换大小写**;⑥ 阻塞 `meow_ui_text_input` 打字循环喂 `meow_ui_activity_ping`(重置息屏计时,进度条不卡死);⑦ **OK(回车)= 提交并关闭**(拷贝到 app `ctx->buf`)、**ESC(X)/ 点键盘外背景 = 取消并关闭**;非阻塞 `meow_ui_text_input_async` 用 `meow_ime_active()`/`meow_ime_text()` 轮询(同 close 语义)。上表「布局 40×40 / 物理键辅助 / 候选区」为设计稿表述,已按实际覆盖。
@@ -725,6 +725,32 @@ meow_widget *meow_layout_spacer(int w, int h);
--- ---
### 5.9 音频客户端 API(`meow_audio_*`,M2.90 落地)
> **权威规范:`devdocs/plan/AUDIOD_DESIGN.md`**(用户定案五项决策)。**已实现**:A1(agent-244/246,audiod+CLI+SDK 客户端,M2.90 入固件)+ A2(ncm 迁 SINK_AUDIOD,e013621)。IPC 号段 `0x00C0-0x00CA` 见 `meow_ipc.h` / docs/MEOWOS_SPEC_REF §4。
MeowOS 的声卡由**独占音频守护 `meow_audiod`** 持有(`hw:0,0`;M2.90 入固件,svcd 托管,HibyOS 模式不启动)。**App 不再直开 ALSA**,一律经 SDK 客户端 `meow_ui_audio.c`(编进 `meow_ui.a`)喂 PCM:
```c
int meow_audio_open(int rate, int ch, int fmt); /* 返回 stream_id(>0);<0=错误(-EBUSY 被占且被抢等) */
int meow_audio_write(const void *pcm, int frames);/* 阻塞(socket 背压);返回写入帧数, <0=流已死 */
int meow_audio_pause(int sid, int paused); /* 1=暂停 0=恢复 */
int meow_audio_close(int sid); /* 关流 */
int meow_audio_query(meow_audio_state *out); /* 当前流/路由/音量/underrun 快照 */
/* 被抢占回调(可选):收到 MSG_AUDIO_PREEMPTED 时调(SDK 内部读线程分发) */
void meow_audio_on_preempt(void (*cb)(const char *by_app, void *ctx), void *ctx);
```
- **fmt 枚举**:1=S16_LE 2=S24_LE 3=S32_LE 4=FLOAT_LE(v1 实装 S16/S24/S32);服务端做**格式归一 + DAC 原生率跟随**(无 SRC,44.1-192k 全覆盖)。
- **独占+抢占**:后开流赢,旧流收 `MSG_AUDIO_PREEMPTED`(App 收到自行暂停 UI);**socket EOF=回收**(客户端崩溃/被 SIGKILL 不泄漏)。流绑定 socket 连接而非 App 前台状态(后台播放见 AUDIOD_DESIGN §3)。
- **懒连接 + 断线重连**:open 时连 `/usr/data/meow_audio.sock`;write 遇 EPIPE → 标记流死,App 需重新 open。**不做隐式直开回退**:audiod 不在 → open 返回 -ENOENT;调试可 `MEOW_AUDIO_DIRECT=1` 允许 App 自带直开路径(仅开发用,非正式能力)。
- **调试 CLI**(root 免鉴权,ssh 直呼):`meow_audio status` / `meow_audio tone [freq] [ms] [rate]`(正弦测试音,排查无声不用开 App)/ `route <0|2|3>` / `vol [0-100]`。
- **⚠️ ALSA UAPI 两坑(真机定位,App 自写直开路径时勿回退)**:① hw_params 须「全放行」初始化(params_any 语义:mask 全 1、interval [0,UINT_MAX]),memset 0 的 interval → HW_PARAMS 恒 EINVAL;② access/format/subformat mask 须**先清零再单点**,留全 1 会被 choose 成 MMAP_INTERLEAVED → write 恒 EINVAL。
- **⚠️ 已知问题(2026-09-01 调查中)**:M2.90 内核在 `cs43198_dai_prepare` 后第二次 `hbc3000_start` 硬挂死(驱动对重复 start 不可重入);底稿 `devdocs/plan/AUDIO_HANG_INVESTIGATION.md`。
- **ncm 迁移范式(A2,e013621)**:`ncm_app/app/play/audio_out.c` 新增 `SINK_AUDIOD` 后端(与 ALSA/FILE/NULL 并列,**默认 audiod**),被抢占回调→暂停、resume 检测流死自动重开、播放路径全量 `meow_log`;UI/缓存/解码零改动。新 App 照此接。
---
## 6. 输入层 / 生命周期(B1 部分 + B2 衔接) ## 6. 输入层 / 生命周期(B1 部分 + B2 衔接)
**B1(本阶段)**:应用不再自读 `/dev/input/event*`,meow_ui 建立输入线程,把按键/触摸翻译成语义事件回调: **B1(本阶段)**:应用不再自读 `/dev/input/event*`,meow_ui 建立输入线程,把按键/触摸翻译成语义事件回调:
+1 -1
View File
@@ -17,7 +17,7 @@
- **应用框架**:一套 C 应用 SDK(`meow_ui`),第三方 App 用统一控件 / 输入 / 主题 / 字体 / 通知 API 开发,无需自读帧缓冲、自读输入、自管返回——把每个 App 都要踩一遍的坑收口到框架里。 - **应用框架**:一套 C 应用 SDK(`meow_ui`),第三方 App 用统一控件 / 输入 / 主题 / 字体 / 通知 API 开发,无需自读帧缓冲、自读输入、自管返回——把每个 App 都要踩一遍的坑收口到框架里。
- **系统组件**:状态栏、通知中心、电源菜单、全局左缘返回手势、主界面(应用列表,**MD3/MIUIx 顶级主题×明暗**,卡片宫格/列表双布局)、设置页、服务管理器、mDNS 广播;系统进程总监 `meow_sysui`;专项子服务 `meow_svc_perf`(性能/系统只读聚合,含真实 network)与 `meow_svc_power`(关机/重启/升级/回 HiBy,含升级写保护 + dac 真实音量 + 读级鉴权放宽);**独占音频守护 `meow_audiod`**(M2.90:App 经 SDK `meow_audio_*` 喂 PCM,守护独占 `hw:0,0`——DAC 原生率跟随无 SRC、格式归一、4.4/3.5 路由自动跟随插孔、抢占+EOF 回收、CLI status/tone/route/vol,规范 `devdocs/plan/AUDIOD_DESIGN.md`);系统级崩溃捕获 `meow_crash` + App 崩溃直报;.mpk **Ed25519 签名验签** `meow_verify`(见 §2.9);MeowPanel 外部管理面板(HTTP/JSON 后端 + Web 前端,支持可选密码鉴权 + 字体库 tar.gz 导入导出,见 §2.10)。 - **系统组件**:状态栏、通知中心、电源菜单、全局左缘返回手势、主界面(应用列表,**MD3/MIUIx 顶级主题×明暗**,卡片宫格/列表双布局)、设置页、服务管理器、mDNS 广播;系统进程总监 `meow_sysui`;专项子服务 `meow_svc_perf`(性能/系统只读聚合,含真实 network)与 `meow_svc_power`(关机/重启/升级/回 HiBy,含升级写保护 + dac 真实音量 + 读级鉴权放宽);**独占音频守护 `meow_audiod`**(M2.90:App 经 SDK `meow_audio_*` 喂 PCM,守护独占 `hw:0,0`——DAC 原生率跟随无 SRC、格式归一、4.4/3.5 路由自动跟随插孔、抢占+EOF 回收、CLI status/tone/route/vol,规范 `devdocs/plan/AUDIOD_DESIGN.md`);系统级崩溃捕获 `meow_crash` + App 崩溃直报;.mpk **Ed25519 签名验签** `meow_verify`(见 §2.9);MeowPanel 外部管理面板(HTTP/JSON 后端 + Web 前端,支持可选密码鉴权 + 字体库 tar.gz 导入导出,见 §2.10)。
- **媒体会话 / Now Playing**:`MSG_META`/`MSG_PLAYCTL`(0x72/0x73)媒体会话(最近活跃源,30s 超时回收)+ 通知中心**媒体卡片** + 主界面左滑 **Now Playing 大页**;媒体键路由到最近活跃媒体会话。 - **媒体会话 / Now Playing**:`MSG_META`/`MSG_PLAYCTL`(0x72/0x73)媒体会话(最近活跃源,30s 超时回收)+ 通知中心**媒体卡片** + 主界面左滑 **Now Playing 大页**;媒体键路由到最近活跃媒体会话。
- **应用生态**:**网易云 dev.player.ncm**(`core/`:mbedtls+jsmn+qrcodegen+minimp3 ≈438KB;v1 复古 UI:登录二维码/我创建的·我收藏的双页签/搜索/歌单详情/黑胶播放页/设置,ALSA 直开 hw:0,0 播放,登录 803 已通;二期:专辑封面/歌词后台加载/大歌单分页);外置**系统文件管理器 os.meow.files**;`meow_ui` SDK 配套结构化列表 `W_LISTVIEW`、通用长按、SDK nav/media 封装、视图框架(可嵌套 view + 事件路由 + 绘制期 clip);App 通知查询/清除 IPC(0x25-27)与**点击通知跳转路由**(route_status)。 - **应用生态**:**网易云 dev.player.ncm**(`core/`:mbedtls+jsmn+qrcodegen+minimp3 ≈438KB;v1 复古 UI:登录二维码/我创建的·我收藏的双页签/搜索/歌单详情/黑胶播放页/设置,登录 803 已通;二期:专辑封面/歌词后台加载/大歌单分页;**三期**:歌单真分页(取消 256 截断)/真实专辑封面/歌词锁修复/搜索接拼音 IME 中文搜索/设置页(音质 5 档+缓存上限+清理缓存)/缓存 LRU 淘汰接生产路径/文案全中文)。**A2 起音频输出走 `meow_audiod`**(SINK_AUDIOD 默认后端,SDK `meow_audio_*` 客户端,被抢占回调→暂停;旧 ALSA 直开仅 `MEOW_AUDIO_DIRECT=1` 调试)。⚠️ **已知问题(2026-09-01,调查中)**:M2.90 设备一播 PCM 即内核硬挂死(hbc3000 驱动第二次 start 不可重入死锁,官方播放器对照序列已抓到、正查 `/dev/sa-config` 控制通道),底稿 `devdocs/plan/AUDIO_HANG_INVESTIGATION.md`;外置**系统文件管理器 os.meow.files**;`meow_ui` SDK 配套结构化列表 `W_LISTVIEW`、通用长按、SDK nav/media 封装、视图框架(可嵌套 view + 事件路由 + 绘制期 clip);App 通知查询/清除 IPC(0x25-27)与**点击通知跳转路由**(route_status)。
- **进程隔离**:系统 UI 渲染进程与 App 进程相互独立,App 卡死不会冻结整个 UI。 - **进程隔离**:系统 UI 渲染进程与 App 进程相互独立,App 卡死不会冻结整个 UI。
- **包管理**:`nyai`(固件内置 `/usr/bin/nyai`)支持 .mpk 安装/升级/导出/列表/索引,走 **version_code 安卓式版本规则**(缺 code 拒装、防降级)+ 签名分级(有签必验、`os.meow.*` 无签拒装、第三方直装告警)+ 导出过滤与体检。 - **包管理**:`nyai`(固件内置 `/usr/bin/nyai`)支持 .mpk 安装/升级/导出/列表/索引,走 **version_code 安卓式版本规则**(缺 code 拒装、防降级)+ 签名分级(有签必验、`os.meow.*` 无签拒装、第三方直装告警)+ 导出过滤与体检。
+3 -1
View File
@@ -56,7 +56,9 @@
| **音频** | `audio.volume` | int 0-100 | 60 | 系统音量(MeowOS 直写 CS43198 DAC;读回为追踪值) | | **音频** | `audio.volume` | int 0-100 | 60 | 系统音量(MeowOS 直写 CS43198 DAC;读回为追踪值) |
| | `audio.volume_max` | int 0-100 | 100 | MeowOS 内部音量上限(clamp;**不与 HibyOS user.ini 上限同步**——其带 CRC 有风险,已定案不做;用户可自设 MeowOS 上限) | | | `audio.volume_max` | int 0-100 | 100 | MeowOS 内部音量上限(clamp;**不与 HibyOS user.ini 上限同步**——其带 CRC 有风险,已定案不做;用户可自设 MeowOS 上限) |
| | `audio.volume_step` | int 1-5 | **1** | 音量键跳步(默认 1%,可配 1-5,最大 5) | | | `audio.volume_step` | int 1-5 | **1** | 音量键跳步(默认 1%,可配 1-5,最大 5) |
| | `audio.output` | string | `hw:0,0` | MeowAPPs 音频输出设备 | | | `audio.output` | string | `hw:0,0` | 音频输出设备。**M2.90 起声卡由 `meow_audiod` 独占**,App 不再直开(经 SDK `meow_audio_*`);本键仅作 audiod 开卡目标/调试直开(`MEOW_AUDIO_DIRECT=1`)参考 |
> **音频子系统(M2.90 起)**:`meow_audiod` 独占音频守护收口全部声卡交互——路由自动跟随插孔(4.4 优先,`meow_audio route` 可手动)、音量 `MSG_AUDIO_VOLUME` v1 透传写 DAC numid=1/2 + 本 `audio.volume` 键(与 watchdog/launcher 同源,不抢主权;v2 收编另定)。规范 `devdocs/plan/AUDIOD_DESIGN.md`。
| **网络** | `network.wifi_enabled` | bool | true | WiFi 开关(写 wlan0;设置页开关经 `wifi_up.sh`/`ip link set wlan0`,`ensure_wifi()` 尊重此值——关=0 则不再自动连网) | | **网络** | `network.wifi_enabled` | bool | true | WiFi 开关(写 wlan0;设置页开关经 `wifi_up.sh`/`ip link set wlan0`,`ensure_wifi()` 尊重此值——关=0 则不再自动连网) |
| | `network.bluetooth_enabled` | bool | false | 蓝牙开关(写 `hciconfig hci0 up/down`;默认关=少耗电) | | | `network.bluetooth_enabled` | bool | false | 蓝牙开关(写 `hciconfig hci0 up/down`;默认关=少耗电) |
| **系统** | `system.hostname` | string | `meowos` | 主机名(RFC1035 首标签;bootmenu 的 S89meow_svcd 开机读它 `sethostname`,缺省 `meowos`;供自研 mDNS 应答器 `meow_mdns` 公布 `<host>.local`)[源:M2.54] | | **系统** | `system.hostname` | string | `meowos` | 主机名(RFC1035 首标签;bootmenu 的 S89meow_svcd 开机读它 `sethostname`,缺省 `meowos`;供自研 mDNS 应答器 `meow_mdns` 公布 `<host>.local`)[源:M2.54] |
+1 -1
View File
@@ -349,7 +349,7 @@
--- ---
## 6. 标志性 TODO / 未决(文档未定,勿凭猜实现) ## 6. 标志性 TODO / 未决(文档未定,勿凭猜实现)
- OPEN_QUESTIONS.md 待定 ❓:多数已由后续定案/落地覆盖——#1 背景图加载(「启动加载一次+预渲染快照不每帧缩放」已落地)、#2 图处理(**cover 居中裁剪**)、#3 叠加层颜色(**固定跟明暗主题**)、#7 应用图标(**已做,app.json icon 加载缓存+首字母占位**)、#8 通知来源(**系统事件 + MeowAPP IPC + D-Bus 桥 三路**,中心 UI 已落地)、#9 下拉手势(**顶部下滑=通知中心**,与左滑返回按起始位置分流)、#10 通知存储(**TF 归档 CSV + 10MB 滚动 + 环形 200 条**)、#11 媒体活跃会话(**active_seq 最近活跃源,30s 超时回收**)、#12 多 app 音频(**App 直开 hw:0,0,不做混音**)、#13 web 实时画面(**`/api/screen.jpeg` + 增量帧**)、#14 输入注入(**本机触摸优先 5s 仲裁**)、#16 主页左滑=侧边栏 vs 返回(**Now Playing 横划页,左缘返回保留**)。**仍待定**:#4 背景色板枚举、#5 浅色文字对比度 `[OPEN_QUESTIONS]` - OPEN_QUESTIONS.md 待定 ❓:多数已由后续定案/落地覆盖——#1 背景图加载(「启动加载一次+预渲染快照不每帧缩放」已落地)、#2 图处理(**cover 居中裁剪**)、#3 叠加层颜色(**固定跟明暗主题**)、#4 背景色板枚举(**已清结**:MD3+MIUIx 色板 M2.90 落地,`display.background` 按 style×mode 派生)、#7 应用图标(**已做,app.json icon 加载缓存+首字母占位**)、#8 通知来源(**系统事件 + MeowAPP IPC + D-Bus 桥 三路**,中心 UI 已落地)、#9 下拉手势(**顶部下滑=通知中心**,与左滑返回按起始位置分流)、#10 通知存储(**TF 归档 CSV + 10MB 滚动 + 环形 200 条**)、#11 媒体活跃会话(**active_seq 最近活跃源,30s 超时回收**)、#12 多 app 音频(**已被 meow_audiod 取代(M2.90):守护独占 hw:0,0 + 抢占,App 经 SDK meow_audio_*,软混音否决**)、#13 web 实时画面(**`/api/screen.jpeg` + 增量帧**)、#14 输入注入(**本机触摸优先 5s 仲裁**)、#16 主页左滑=侧边栏 vs 返回(**Now Playing 横划页,左缘返回保留**)、#17 音频输出设置(**底层已由 audiod 收口:路由自动+CLI;设置页 UI 项留后续**)。**仍待定**:#5 浅色文字对比度(待实机观感验收)+ 2026-09-01 新增批(PCM 内核挂死调查/WiFi 录入 UI/amsd DECLARE 残余/ncm 出声终验/网易云 UI 专项) `[OPEN_QUESTIONS]`
- DEVELOPMENT_PLAN:**阶段 0(bootmenu 双系统)已落地(现网即运行中)**;阶段 B/E/F 达成;阶段 D M0-M3/M5 已落地、**M4 后台服务保活 / M6 加固 待排期** `[DEVELOPMENT_PLAN]` - DEVELOPMENT_PLAN:**阶段 0(bootmenu 双系统)已落地(现网即运行中)**;阶段 B/E/F 达成;阶段 D M0-M3/M5 已落地、**M4 后台服务保活 / M6 加固 待排期** `[DEVELOPMENT_PLAN]`
- 未定/待拍板:MeowOS 音频输出设置(只读还是可配,OPEN_QUESTIONS #17);OTA 在线「检查更新/下载」依赖 MeowPanel(本地/检查升级已可用,URL 下载待定案 #18)`[WORK_STATE][OPEN_QUESTIONS #17/#18]` - 未定/待拍板:MeowOS 音频输出设置(只读还是可配,OPEN_QUESTIONS #17);OTA 在线「检查更新/下载」依赖 MeowPanel(本地/检查升级已可用,URL 下载待定案 #18)`[WORK_STATE][OPEN_QUESTIONS #17/#18]`
- **meow_svcd 后续(M2.54 已落地大部分)**:~~接入 supervisor 启动链~~(已改 `etc/init.d/S89meow_svcd` 开机自启;bootmenu/launcher `fork+exec`+`waitpid` 仍为备选);~~写 `MeowOS/services.d/mdnsd.conf` 落地 mDNS~~(已改**板载** `/usr/data/meow/services.d/mdnsd.conf` 预置,`trigger=boot`)。剩余:`cap` setcap 真机实装(cap_net_bind_service,cap_net_raw);`wifi-up` 判定收紧。**services.d/svcd 已接入开机链(S89)**,但真机行为待验证。 `[WORK_STATE][meow_svcd.md]` - **meow_svcd 后续(M2.54 已落地大部分)**:~~接入 supervisor 启动链~~(已改 `etc/init.d/S89meow_svcd` 开机自启;bootmenu/launcher `fork+exec`+`waitpid` 仍为备选);~~写 `MeowOS/services.d/mdnsd.conf` 落地 mDNS~~(已改**板载** `/usr/data/meow/services.d/mdnsd.conf` 预置,`trigger=boot`)。剩余:`cap` setcap 真机实装(cap_net_bind_service,cap_net_raw);`wifi-up` 判定收紧。**services.d/svcd 已接入开机链(S89)**,但真机行为待验证。 `[WORK_STATE][meow_svcd.md]`