docs: 全项目文档一致性审计同步 (agent-237) — README/FRAMEWORK_DESIGN/SDK/APPS/PLAN/SETTINGS/SPEC_REF 对齐 M2.88 现状(amsd/picker/签名2B/拼音IME/面板阶段C/ncm改名dev.player.ncm等),过期「未实现」表述按落地实况修正

This commit is contained in:
MeowOS committed 2026-08-31 19:11:25 +08:00
1 parent d76f8bc4ba
commit 49c31f1901
7 files changed
+42 -36

No files matched your search

+2 -2
View File
@@ -162,7 +162,7 @@
**约定(MeowOS 界面 = launcher 主菜单/选单/电源菜单,是唯一允许映射物理键的地方)**:
> ⚠️ **适用范围**:**除了电源键菜单(`show_power_menu`,允许"电源=确认、音量=导航")以外,所有按键信号由 MeowOS 全局接管**——**任何界面(含 MeowOS 自身的设置页 / 应用列表 / 选单、以及 MeowAPP)都不得私自定义按键行为**。物理键的语义只有一份:电源=息屏/亮屏/长按菜单/8s强关,音量=调系统音量,播放/上下曲=媒体控制(未落地前「抓住」)。任何界面(如系统设置页)**不得**把电源键/播放键映射成"返回/确认"这类自定义行为;界面导航一律走触摸(返回按钮/左缘左滑),按键语义统一由系统判。
> ⚠️ **适用范围**:**除了电源键菜单(`show_power_menu`,允许"电源=确认、音量=导航")以外,所有按键信号由 MeowOS 全局接管**——**任何界面(含 MeowOS 自身的设置页 / 应用列表 / 选单、以及 MeowAPP)都不得私自定义按键行为**。物理键的语义只有一份:电源=息屏/亮屏/长按菜单/8s强关,音量=调系统音量,播放/上下曲=媒体控制(**已落地**,M2.81 起路由最近活跃媒体会话;无会话时「抓住」)。任何界面(如系统设置页)**不得**把电源键/播放键映射成"返回/确认"这类自定义行为;界面导航一律走触摸(返回按钮/左缘左滑),按键语义统一由系统判。
| 键 | 系统语义(APP 收到的是语义事件,不是裸 keycode) |
|---|---|
@@ -459,7 +459,7 @@ Description: A simulated app
### 3.7 音频通路与媒体键(2026-08-31 实测定案,覆盖 §5 旧推论)
- **MeowOS 常驻模式(boot 直进,hiby_player 未运行)声卡空闲**:真机实测 `fuser /dev/snd/pcmC0D0p /dev/snd/controlC0` 无任何占用、`pidof hiby_player` 不存在——**MeowAPP 可直接 open `hw:0,0` 出声**(audio.output 设置键即此);无混音,后开者失败,音频焦点=先占先得(媒体会话/MPRIS 落地后再规范抢占语义)。
- **会话覆盖模式(HibyOS 运行中热键唤起)**:SIGSTOP 冻结播放器,声卡仍被其持有,App 无声(§5 旧结论,仅适用该模式)。
- **物理媒体键路由**:MeowOS 与 HibyOS 不同时运行,不存在「转发给 hiby」问题;MeowOS 界面下播放/上下曲 = 全局媒体控制,路由给**最近活跃媒体会话**(**媒体会话已落地** M2.81:`MSG_META`(0x72)/`MSG_PLAYCTL`(0x73) + meow_media 最近活跃源(active_seq,30s 超时回收)+ 通知中心媒体卡片 + Now Playing 大页;OS.meow.ncm 是首真实媒体源),无会话时「抓住」不动作。
- **物理媒体键路由**: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 改名)是首真实媒体源),无会话时「抓住」不动作。
### 3.8 版本号规则(2026-08-31 定案,对齐 Android)
- `app.json` 增加 **`version_code`**(纯数字,单调递增,**安装/升级比较的唯一依据**);`version` 仅作显示字符串(versionName 角色,可为 `1.2.3-beta` 等任意形态)。