docs: 全量文档同步到 M2.83 (agent-213) — README 能力全景/框架文档消息号+M3M5落地标注/SDK listview+长按+§10.5已实现标注/APPS version_code+媒体键路由/DEVELOPMENT_PLAN 主线进度; devdocs(WORK_STATE/RECOVERY_PROMPT/DEV_NOTES)本地同步

APPS.md

@@ -59,6 +59,7 @@
   "exec": "/usr/data/mnt/sd_0/MeowAPPs/os.meow.hello/hello",
   "package": "os.meow.hello",
   "version": "0.1",
+  "version_code": 1,
   "author": "whoever"
 }
 ```
@@ -68,7 +69,9 @@
 | `name` | ✓ | 列表显示名。**v2 仅支持 ASCII**（UTF-8 中文留待 v3，需完整 UTF-8→UTF-16 转换） |
 | `exec` | ✓ | 应用可执行文件绝对路径（必须是**静态** MIPS32r2 ELF，soft/hard-float 均可） |
 | `package` | — | 反域名权威标识（如 `os.meow.hello`），launcher 取之为 app_id；**目录名=package**。缺省回退目录名 `de->d_name`；两者存在且不同 → WARN |
-| `version` / `author` | — | 保留字段，v2 不解析 |
+| `version_code` | — | **纯数字，安装/升级比较的唯一依据**（`nyai`/launcher 全走它；缺 code 拒装、新版<已装拒装），见 §3.8 |
+| `version` | — | 显示字符串（versionName 角色，`1.2.3-beta` 等任意形态，**不参与比较**），见 §3.8 |
+| `author` | — | 保留字段 |
 | `fullscreen` | — | app 级全屏：`1`=进入全屏（状态栏**收合至提示线** + **保留左缘返回/顶部提示线/下滑通知中心**，见 MEOWOS_SPEC_REF §5.1）；activity 级用它 `route.<id>.fullscreen`。**app.json `fullscreen` 字段此前未解析/已定未做 → 本次实现**（launcher 启动/切 activity 据声明预设 SDK 全屏，env `MEOW_FULLSCREEN`）[源:用户 2026-08-30] |
 | `fonts` | — | 字库档位声明：`"full"` / `"gbk"` / `"common"`（app 需大字库时可声明 `"full"`，默认小字库 `common`≈4k；launcher 据此为该 app 加载大字库 `gbk`≈20k，从已扫描的 `MeowOS/fonts/<family>/<weight>/` 里按同 family（其次同 weight）选大字库，M2.6）。**注意**：与 `"fonts":["<handle>"]`（应用自带字库句柄数组）**同名二义**，见 MEOWOS_SPEC_REF §7 A-14 [源:用户 2026-08-30] |
 
@@ -456,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 界面下播放/上下曲 = 全局媒体控制，路由给**最近活跃媒体会话**（媒体会话/MPRIS 落地后接线），无会话时「抓住」不动作。
+- **物理媒体键路由**：MeowOS 与 HibyOS 不同时运行，不存在「转发给 hiby」问题；MeowOS 界面下播放/上下曲 = 全局媒体控制，路由给**最近活跃媒体会话**（**媒体会话已落地** M2.81：`MSG_META`(0x72)/`MSG_PLAYCTL`(0x73) + meow_media 最近活跃源（active_seq，30s 超时回收）+ 通知中心媒体卡片 + Now Playing 大页；OS.meow.ncm 是首真实媒体源），无会话时「抓住」不动作。
 
 ### 3.8 版本号规则（2026-08-31 定案，对齐 Android）
 - `app.json` 增加 **`version_code`**（纯数字，单调递增，**安装/升级比较的唯一依据**）；`version` 仅作显示字符串（versionName 角色，可为 `1.2.3-beta` 等任意形态）。