全屏滑条统一路径+对比色(112/115) + 字体索引+查列表+丢失降级(113) + 文档刷新(114) + svcd CLI文档+mips-repo拆bins/mpk(116)
This commit is contained in:
MeowOS Dev committed
1 parent
b75ecce5de
commit
19a001f007
22 files changed
+666
-129
No files matched your search
+24
-19
@@ -9,7 +9,7 @@
|
||||
### 1.1 板载（NAND rootfs / /data）
|
||||
- 设置持久化：**板载** `/usr/data/meow/settings.conf`（UBIFS，小文件 <10KB，跨换卡保留）`[SYSTEM_SETTINGS §2][MEOWOS_API §3]`
|
||||
- **板载服务目录**：`/usr/data/meow/services.d/<name>.conf`（M2.54，Data 区，恒定存在、权威优先；首启由 `S89meow_svcd` 预置 `mdnsd.conf`）。与 TF `MeowOS/services.d/` 双源，同名板载优先 + WARN；板载 `trigger=boot` 服务不依赖卡（拔卡保留）`[meow_svcd.md][meow_svcd.c]`
|
||||
- **主机名**：设置键 `system.hostname`（SET_STR，默认 `meowos`；RFC1035 首标签），`S89meow_svcd` 开机读 settings `sethostname`；供自研 mDNS 应答器公布 `<host>.local` `[SYSTEM_SETTINGS §1][mips-repo/meow_mdns]`
|
||||
- **主机名**：设置键 `system.hostname`（SET_STR，默认 `meowos`；RFC1035 首标签），`S89meow_svcd` 开机读 settings `sethostname`；供自研 mDNS 应答器公布 `<host>.local` `[SYSTEM_SETTINGS §1][mips-repo/bins/meow_mdns]`
|
||||
- `/etc/meowos_version`：版本唯一来源（launcher 运行时 `load_meowos_version` 读；`MEOWOS_VERSION` 宏仅作 dev 占位兜底）`[DEV_NOTES #4]`
|
||||
- `/tmp`：tmpfs，开机清空；开机模式标记 `/tmp/meow_boot_mode`、电源菜单 `/tmp/meow_power_menu{,_active}`、app 沉浸 `/tmp/meowapp_state` `[BOOT_SELECTOR §1][KEY_CONTROL §9][APPS §3.5]`
|
||||
- 日志启动缓冲 `/tmp/meow_boot.log`（256KB 滚动，卡出现后自动迁卡）`[APPS §4.5]`
|
||||
@@ -22,17 +22,17 @@
|
||||
├── Music/ # 播放器标准索引目录
|
||||
├── MeowData/<pkg>/{data,cache} # 应用专属数据（exFAT 无软链，用 env 注入）
|
||||
├── MeowAPPs/ # 应用（<package>=app.json.package=目录名；app.json+二进制+资源, fonts/, backgrounds/；日志已入 MeowOS/logs[源:审计 2026-08-30]）
|
||||
├── MeowOpt/ # 板载外部工具/二进制（如 mdnsd/，卡上加载，拔卡降级不崩）`[DEV_NOTES][meow_svcd.md]`
|
||||
└── MeowOS/ # MeowOS 专属（一切非必要文件）
|
||||
└── MeowOS/ # MeowOS 专属（一切非必要文件；**MeowOpt 已废弃并入此处的 opt/**）
|
||||
├── backups/settings/setting.bak # 设置导出默认路径
|
||||
├── services.d/ # 服务配置（meow_svcd 的 <name>.conf；TF 源，与板载 /usr/data/meow/services.d 双源，同名板载优先）`[meow_svcd.md]`
|
||||
├── fonts/<family>/<weight>/ # 多字体库（每 <family>/<weight> 一套三件套；见 §5.2）
|
||||
│ ├── font.png # 预渲染灰度 PNG（bit depth 4|8，gen/gen_font.py 产物）
|
||||
│ ├── font.idx # 索引（MFNI v2，gen/gen_font.py 产物）
|
||||
│ └── font.json # 元数据 + sha256 完整性校验（schema 见 §5.2）
|
||||
│ └── font.json # 元数据 + sha256 完整性校验（schema 见 §5.2；含 weight+charset+glyph_count）
|
||||
├── config/fonts/index # 字体列表索引（M2.58：CSV family,weight,path,label,tier,glyph_count；见 §5.7）
|
||||
├── logs/ # 系统日志 meow_<bootts>.log + apps/...（见 §3 日志）
|
||||
├── notifications/（转储区，保留最新 10MB，不被电源事件清）
|
||||
├── opt/{bin,nyai,sources.list}, lib/, tools/
|
||||
├── notifications/（转储区，保留最新 10MB，不被电源事件清；文件 = notifications.log，appended CSV 行）
|
||||
├── opt/{bin,nyai,sources.list}, lib/, tools/ # 外围工具/二进制（MeowOpt 已废弃并入；mDNS 自研 meow_mdns 在固件，不入此）
|
||||
└── themes/charging/<id>/ # 充电屏主题（theme.json manifest）
|
||||
```
|
||||
`[TF_CARD_LAYOUT §1][APPS 附录][NOTIFICATION_SYSTEM §5]`
|
||||
@@ -129,10 +129,11 @@
|
||||
- 类 systemd/systemctl。**已接入系统启动链（M2.54）**：固件 `etc/init.d/S89meow_svcd` 开机自启（`-f` 前台 + 重挂循环，失败不死；置于 S84ssh 之后、S90meow_bootmenu 之前——因 S90 exec 引导选单阻塞 rcS）。由 bootmenu/launcher `fork/exec` + `waitpid` 托管仍为备选。
|
||||
- **双源 services.d**（板载优先）：板载 `/usr/data/meow/services.d/<name>.conf` + TF **`MeowOS/services.d/<name>.conf`**，两处都读；同名服务板载优先（TF 同名跳过 + WARN「<name> 板载与 TF 都存在，采用板载」）。目录式 `key=value`，未知键忽略/前向兼容：`exec`(必填)/`args`/`env`/`enabled`(0=永不自动启动,默认0)/`restart`(`always`/`on-fail`/`never`,默认on-fail)/`backoff_ms`(默认1000)/`max_restart`(默认5)/`cap`(本阶段仅解析不实装)/`trigger`(`boot`/`card-mount`/`wifi-up`,默认card-mount)。
|
||||
- **板载-trigger=boot 语义**：板载服务恒定存在，boot 触发不依赖卡（拔卡保留）；TF 服务 boot 仍需卡。
|
||||
- **服务目录规则**：**固件工具**→板载 `/usr/data/meow/services.d/<name>.conf`（Data 区，拔卡保留）；**TF 工具/第三方**→TF `MeowOS/services.d/<name>.conf`（随卡存在/消失）；**双源板载优先**（TF 同名被板载屏蔽 + WARN「<name> 板载与 TF 都存在，采用板载」）。
|
||||
- 崩溃隔离：服务=svcd **独立子进程**（`fork+execv`），svcd 只 `waitpid`/`SIGCHLD` 感知；服务死不影响 svcd/supervisor；重启受 `backoff_ms` 退避防热循环。
|
||||
- 状态机：`DISABLED/STOPPED/RUNNING/STOPPING/FAILED`；稳定运行 30s 清零 restart_count。CLI：`status/reload/start|stop|restart <name|all>/pid`（AF_UNIX 单行文本 `/tmp/meow_svcd.sock`）。
|
||||
- **卡上外部工具 = `MeowOpt/`**（TF 根下平级目录，如 `MeowOpt/mdnsd/mdnsd`）：MeowOS 启动时从卡加载，拔卡降级不崩 `[DEV_NOTES][meow_svcd.md]`。
|
||||
- **mDNS 应答器 = `meow_mdns`（自研，已拍板替代完整 mdnsd）**：`mips-repo/meow_mdns/`，**IPv4-only**（内核无 IPv6，完整 mDNSResponder/SAResponder 均 `socket(AF_INET6)` 失败），mipsel 静态 ~79KB（md5 b23de7ce）。**进固件 `/usr/bin/meow_mdns`**（不入卡），由 meow_svcd 托管（板载 `/usr/data/meow/services.d/mdnsd.conf`，`trigger=boot`、root 即可绑 5353/组播，`cap=` 空）。功能：join `224.0.0.251:5353`，应答 `<host>.local` A（wlan0 IPv4）/`_ssh._tcp` PTR/SRV/TXT/`_services._dns-sd` PTR；支持 `MEOW_MDNS_HOST`/`_ADDR`/`_PORT`/`_TTL`/`_CF`/`_QD`/`_MCAST`/`_MIF`/`_DBG`。⚠️ **手机热点隔离**：设备→主机组播被热点丢弃，avahi 只收组播应答 → 该热点下 `avahi-resolve <host>.local` 超时（网络层限制，非应答器缺陷），主机需 DNS 兜底 `[mips-repo/meow_mdns/manifest.md][meow_svcd.md]`。
|
||||
- 状态机：`DISABLED/STOPPED/RUNNING/STOPPING/FAILED`；稳定运行 30s 清零 restart_count。CLI（systemctl 式，SSH 直呼）：`status/reload/start|stop|restart <name|all>/pid`，示例 `meow_svcd status`/`meow_svcd restart mdnsd`/`meow_svcd stop all`/`meow_svcd reload`；控制走 AF_UNIX 单行文本 `/tmp/meow_svcd.sock`；守护默认后台，`-f/--foreground` 前台供 supervisor 托管。
|
||||
- **卡上外部工具 = `MeowOS/opt/`**（`{bin,nyai,sources.list}, lib/, tools/`）：MeowOS 启动时从卡加载，拔卡降级不崩。**`MeowOpt` 已废弃并入此处**；mDNS 已改为自研 `meow_mdns`（固件 `/usr/bin`），不再放卡。`[DEV_NOTES][meow_svcd.md]`。
|
||||
- **mDNS 应答器 = `meow_mdns`（自研，已拍板替代完整 mdnsd）**：`mips-repo/bins/meow_mdns/`，**IPv4-only**（内核无 IPv6，完整 mDNSResponder/SAResponder 均 `socket(AF_INET6)` 失败），mipsel 静态 ~79KB（md5 b23de7ce）。**进固件 `/usr/bin/meow_mdns`**（不入卡），由 meow_svcd 托管（板载 `/usr/data/meow/services.d/mdnsd.conf`，`trigger=boot`、root 即可绑 5353/组播，`cap=` 空）。功能：join `224.0.0.251:5353`，应答 `<host>.local` A（wlan0 IPv4）/`_ssh._tcp` PTR/SRV/TXT/`_services._dns-sd` PTR；支持 `MEOW_MDNS_HOST`/`_ADDR`/`_PORT`/`_TTL`/`_CF`/`_QD`/`_MCAST`/`_MIF`/`_DBG`。⚠️ **手机热点隔离**：设备→主机组播被热点丢弃，avahi 只收组播应答 → 该热点下 `avahi-resolve <host>.local` 超时（网络层限制，非应答器缺陷），主机需 DNS 兜底 `[mips-repo/bins/meow_mdns/manifest.md][meow_svcd.md]`。
|
||||
- `meow_settings_*`（设置后端，已定）/`meowcli`/`meow_sys_devattr`/`meow_devattr_set` `[MEOWOS_API]`
|
||||
- 后台权限：`MSG_HELLO/MSG_REGISTER.flags` 扩展 `MF_BACKGROUND`/`MF_PLAYBACK`；`PERF_BACKGROUND`/`PERF_AUDIO_BACKGROUND`（规划）`[FRAMEWORK_DESIGN 附录 A]`
|
||||
|
||||
@@ -184,7 +185,7 @@
|
||||
- 刷新率：`display.refresh_rate` enum 60/30/15（默认 60）；`display.refresh_always_max` bool false（关=允许 60→30→15 降档）。governor：连续 12 帧超预算降一档，连续 4 批≈48 帧远低预算升一档 `[SYSTEM_SETTINGS §1][PERF_SCHEDULER][MIGRATION_AC §12.1]`
|
||||
- 息屏：`display.screen_off_timeout` int 秒 默认 **30**（0=常亮）；`display.screen_off_mode` enum `panel`(面板下电+背光0+FBIOPBLANK)/`black`(背光0全黑+双击亮屏) `[SYSTEM_SETTINGS §1]`
|
||||
- 亮度 clamp：`display.brightness` 0-255 默认 101（clamp ≥ `display.brightness_min`）；`display.brightness_min` 默认 **1**（M2.39 由 25 改 1）——**与旧文档 25 冲突见 §A** `[SYSTEM_SETTINGS §1]`
|
||||
- **主机名（M2.54）**：`system.hostname`（SET_STR 默认 `meowos`，RFC1035 首标签）；`S89meow_svcd` 开机读板载 `settings.conf` 应用 `sethostname`，缺省 `meowos`/系统名；供 `meow_mdns` 公布 `<host>.local`。settings 无该键 → 默认 `meowos`。`[SYSTEM_SETTINGS §1][mips-repo/meow_mdns/manifest.md]`
|
||||
- **主机名（M2.54）**：`system.hostname`（SET_STR 默认 `meowos`，RFC1035 首标签）；`S89meow_svcd` 开机读板载 `settings.conf` 应用 `sethostname`，缺省 `meowos`/系统名；供 `meow_mdns` 公布 `<host>.local`。settings 无该键 → 默认 `meowos`。`[SYSTEM_SETTINGS §1][mips-repo/bins/meow_mdns/manifest.md]`
|
||||
|
||||
### 5.5 MeowAPPs 包结构 / .mpk / 数据
|
||||
- `<pkg>/` = 程序主体+app.json+资源；`MeowData/<pkg>/{data,cache}` = 数据；首次启动自动建 data/cache 并经 env 注入，exFAT 无软链 `[APPS 附录 §1/§2]`
|
||||
@@ -199,13 +200,14 @@
|
||||
|
||||
### 5.7 字体管理 + 应用字库接口（扩展 → SDK 统一接口 / 应用自带字库 / 多句柄）
|
||||
> 在 §5.2「TF 卡多字体库（M2.5x）」基础上**扩展**：把 MeowOS 字体管理器定义为可用字库的**唯一权威来源**，向 SDK 提供统一查询/选用接口，并支持**应用自带字库**与**多句柄（多字体）**。
|
||||
> ⚠️ **凡 `meow_font_*_h` / `meow_ui_*_h` / 列表枚举 / 句柄加载类接口均为「草案/待定案」**：当前 SDK 只有单字体 `meow_font_*` 与 `meow_ui_text*`（用当前默认字体），本小节为新功能、**未实现**，勿当作已落地。
|
||||
> ⚠️ **状态分级（2026-08-30）**：launcher 侧字体管理器（§5.7.1）与 **两级扫描/字重子菜单（agent-111，M2.58）**、`meow_font_has_glyph` 已实现；**列表枚举（§5.7.1/§5.7.2）** 落地（**agent-113，M2.58**）：「扫描结果落盘 `MeowOS/config/fonts/index`（family/weight/path/label/tier/glyph_count），SDK `meow_font_get_available_count/enumerate` 从该文件读、不依赖 launcher 内存数组；字库丢失→降级默认+日志；render 走 env `MEOW_FONT_PNG/IDX`，list 枚举走 index——两路明确」。**应用自带字库（§5.7.3）/ 多句柄（§5.7.4）/ 凡 `_h` 接口仍为「草案/未实现」**，勿当作已落地；当前 SDK 只有单字体 `meow_font_*` 与 `meow_ui_text*`（用当前默认字体）。
|
||||
> `[源:meow_font.h][源:agent-79 实现][源:meow_ui.h]`
|
||||
|
||||
> **app 未自带字库 → 跟随系统 `font.file`（M2.x 已落地）**：launcher 每次 `launch_app` 前把「当前生效字体」注入为环境变量 `MEOW_FONT_PNG`/`MEOW_FONT_IDX`（绝对路径，可选 `MEOW_FONT_APP=<family>`）；SDK `meow_ui_gfx.c load_font()` **优先读 env**，无 env 则回退卡默认 `MeowOS/fonts/default` → 固件。§5.7.3 的 `load_handle`（app 自带字库）**未实现**，故当前 app 只能跟随系统字体；一旦实现自带字库，其加载优先级应高于 env。
|
||||
|
||||
- **5.7.1 字体管理器（launcher 侧）= 可用字库唯一权威来源**
|
||||
- 唯一维护并扫描 `MeowOS/fonts/<family>/<weight>/`（+默认），产出「字体列表」（family slug / weight slug / 显示名 / glyph_count / size_list / bit_depth）。**SDK 不自行发现字库**，一律经本接口取 launcher 扫描结果。
|
||||
- 唯一维护并扫描 `MeowOS/fonts/<family>/<weight>/`（+默认），产出「字体列表」（family slug / weight slug / 显示名 / glyph_count / size_list / bit_depth）。**SDK 不自行发现字库**，一律经本接口取 launcher 扫描结果。**扫描结果落盘 `MeowOS/config/fonts/index`**（family/weight/path/label/tier/glyph_count）；SDK 读该文件（不依赖 launcher 内存数组）。
|
||||
- **释放语义（agent-113 落地结论）**：持久来源 = index 文件；`font_presets*`/`*_buf` 为「静态、有界（`FONT_PRESETS_MAX=17`）、非堆」数组 → 无内存泄漏、无运行期 free；「释放」= 两个扫描点（启动/进设置页）重建 + 固定上限防膨胀，离开字体列表视图无需显式 free（下次进设置/重扫自动重建）。⚠️ **未做「启动后即清空数组」**：`meow_font_effective_paths_tiered`（launch_app 大字库档位选库）与 `meow_font_reload_multifont` 运行期持续读 `font_presets_n`，清空会造成大字库档位退化（red line「保持档位/多字体行为」）；如需「零驻留」，须把这几个核心路径改为直接读 index（较大重构，留待后续）。
|
||||
- 扫描与校验规则沿用 §5.2：三件套 `font.png/font.idx/font.json` **缺任一件 → 该套跳过 + 日志**；`font.json` 解析 `name`（缺回退目录名）/`weight`（缺省 `regular`）/`glyph_count`/`size_list`/`bit_depth`；`sha256_png/sha256_idx` 仅 **WARN** 不硬失败（该套仍可选）。
|
||||
- 列表上限沿用 `FONT_PRESETS_MAX = 17`（1 默认 + ≤16 卡内套装，防爆）；顺序 = 默认(0) + 扫描顺序。扫描时机不变（启动 / 进设置页），**勿放热路径** `[源:agent-79 实现]`。
|
||||
- 权威列表数据模型（SDK 侧快照，枚举时填充）：
|
||||
@@ -221,17 +223,20 @@
|
||||
char path_png[320]; /* 系统库：相对卡根 MeowOS/fonts/<family>/<weight>/font.png */
|
||||
} meow_font_info;
|
||||
```
|
||||
- **5.7.2 应用可读 TF 卡字体列表（统一规范接口，app 面向）** `[源:agent-79 实现][源:meow_font.h]`
|
||||
- **5.7.2 应用可读 TF 卡字体列表（统一规范接口，app 面向；已落地，M2.58）** `[源:agent-79 实现][源:agent-113 实现][源:meow_font.h]`
|
||||
- **读取来源 = `MeowOS/config/fonts/index`**（launcher 扫 `MeowOS/fonts/<family>/<weight>/` 后落盘；CSV 每套一条 `"family","weight","path","label","tier",glyph_count`，path=卡根相对 `font.png`，label=显示名+字重+尺寸标记，tier=common|gbk|full；默认行恒为 index0）。`meow_font_get_available_count/enumerate` **只读该文件**，不再依赖 launcher 内存数组；无卡/无 index → 仅板载默认项（family=default，count=1）。index 解析在 `font/meow_font.c`（`meow_font_index_load`），SDK 经 `meow_ui.h §5.7` 暴露。
|
||||
```c
|
||||
int meow_font_get_available_count(void); /* 可用字库数（含默认） */
|
||||
int meow_font_get_available_count(void); /* 可用字库数（含默认；无卡→1） */
|
||||
int meow_font_enumerate(int idx, meow_font_info *out); /* 按序号取，越界返回 0 */
|
||||
typedef int (*meow_font_enum_cb)(const meow_font_info *info, void *ctx);
|
||||
int meow_font_enumerate_cb(meow_font_enum_cb cb, void *ctx); /* 回调式，返回套数 */
|
||||
int meow_font_select_by_id(int id); /* 选该套为 app 会话默认字体 */
|
||||
```
|
||||
- 语义：`id` = 列表序号（§5.7.1 快照）；`0` = **跟随系统默认**（用户 `font.file` 所选，app 会话不覆盖）；`>0` = **app 会话内固定用该套**（覆盖 `font.file` 至 app 结束）。成功 0，越界/加载失败返回负值。
|
||||
- 语义：`id` = 列表序号（index 行号）；`0` = **跟随系统默认**（用户 `font.file` 所选，经 env `MEOW_FONT_PNG/IDX`，app 会话不覆盖）；`>0` = **app 会话内固定用该套**（覆盖 `font.file` 至 app 结束）。成功 0，越界返回负值。
|
||||
- **字库丢失降级默认（不丢请求）+ 日志**：`select_by_id(id>0)` 加载失败（png 缺失/坏）→ **降级**到系统默认（env→卡默认→固件），并 `meow_log(MEOW_LOG_WARN, "font <path> missing, fallback default")`（落 app 日志 = SDK meow_log）；请求不丢（仍按"选过"处理）。渲染仍走 env `MEOW_FONT_PNG/IDX`（选中的那一套），**列表枚举走 index 文件**——两路明确匹配。
|
||||
- **列表快照是临时的**：launcher 仅启动/进设置页重扫，期间拔卡或改卡内字库不刷新；app 应**每次会话重新枚举**、按 `family` 持久化，勿缓存数值 id。
|
||||
- 覆盖范围：系统库 `MeowOS/fonts/<family>/<weight>/` 与默认（含固件 `/usr/share/meowos/font` 回退）都反映在列表里；app 侧「选用已有字库」**只用本接口，不直接拼路径**。
|
||||
- **launcher 侧系统设置同样降级 + 系统日志**：`font.file` 选中字体缺失 → `meow_font_ensure`/`meow_font_reload_multifont` 兜底链（font.file→卡默认→固件）回退默认，并 `logmsg("meow_font: selected font %s missing, fallback default")`（系统日志 = launcher logmsg；多字体类别缺失 → `multi_font: class %s font %s missing, fallback global`）。app 日志（SDK meow_log）与系统日志（launcher logmsg）分流明确。
|
||||
- **5.7.3 应用自带字库（按 handle 加载）** `[源:meow_font.h]`
|
||||
- 目录：`MeowAPPs/<pkg>/fonts/<handle>/{font.png,font.idx,font.json}`；`<pkg>` = `app.json.package`（反域名 app_id，见 §5.5），`<handle>` = 应用自设名字（如 `lyrics`/`reader`）。
|
||||
- `app.json` 声明（**可选**）：`"fonts": ["lyrics","reader"]`。作用 = MeowPanel 打包校验 / launcher 装包校验 / SDK 提供取证；**不声明也可运行时按 handle 加载**。
|
||||
@@ -329,10 +334,10 @@
|
||||
- **A-6 KEY_PREVIOUS(code)**：KEY_CONTROL §3 明注「KEY_PREVIOUSSONG 是 **165**；19 是另一码」；meow_ui.h `#define MEOW_KEY_PREVIOUS 19 /* KEY_PREVIOUSSONG */` 注释标错。→ **19 的标签应改**（值 19 非 prevsong；165 才是），属 meow_ui.h 注释误导。
|
||||
- **A-7 app 日志路径**：APP_LOG_MANAGER §4 写 `apps/<app_id>.log`（单文件）；meow_ui.h §9 / DEV_NOTES #9 为 **`apps/<包名>/logs/<启动时间>_<pid>.log`**（每次启动新文件）——用户已纠正，勿用单文件。→ 以 meow_ui.h/DEV_NOTES（M2.51）为准，APP_LOG_MANAGER 目录小节过时。
|
||||
- **A-8 状态栏高**：MEOW_APP_SDK §3.1「slim ~20-40px」；实际定案 **40px**（[D6] MIGRATION_AC §11.1），后被用户改为 **28px**（MUI_SBAR_H=28，字号 20，图标 ink 16/中线 14，见 M2.x 状态栏压缩）。→ 现取 28。
|
||||
- **A-9 SDK 通知转储**：NOTIFICATION_SYSTEM §8「创建 10s 后自动转储到 TF」；meow_ui.h 现仅「活动表+meow_log 打日志，真实投递 UI/D-Bus 为后续」。→ 10s 转储/TF 尚未实现，属"已定未做"。
|
||||
- **A-9 SDK 通知转储**：NOTIFICATION_SYSTEM §8「创建 10s 后自动转储到 TF」；meow_ui.h 现仅「活动表+meow_log 打日志，真实投递 UI/D-Bus 为后续」。→ **10s 转储/TF 已实现（M2.5x，#6）**：launcher 侧带 TTL 10s 转储钩子，dump 到 `MeowOS/notifications/notifications.log`（appended CSV + 10MB 滚动 + 开机清板载/内存表）；meow_ui.h 注释「真实投递 UI/D-Bus 为后续」仍指**通知中心 UI / D-Bus 桥**未做。
|
||||
- **A-10 版本来源细解**：DEV_NOTES #4「/etc/meowos_version 唯一来源；MEOWOS_VERSION 宏仅 dev 占位永不动」；APPS.md §4.6「MEOWOS_VERSION 宏=单一来源，build 时 sed 写入 etc/meowos_version」。→ 两者都强调"写入同源"，但"谁是源头"措辞矛盾；实践上 build 脚本 echo 生成 /etc/meowos_version，宏作屏显 dev 占位。
|
||||
- **A-11 `MeowOS/opt/` vs `MeowOpt/`**：§1.2 树中 `MeowOS/opt/{bin,nyai,sources.list},lib/,tools/`（nyai 包管 + 工具）与新增顶层 `MeowOpt/`（板载外部工具/二进制，如 mdnsd）并存，命名仅大小写之差、语义可能重叠。→ **两者是否为同一用途/是否需归并待确认**；当前按各自文档记录，勿混用。
|
||||
- **A-12 `fullscreen` 字段（已定 → 本次实现）**：§5.5 与 MEOW_APP_SDK §9 将 `fullscreen` 列为 app.json 字段，但 `meow_parse_app_json()` **此前并未读取该键**（实现只解析 name/exec/icon/package/framework/immersive/route./awake./service.），属"已定未做"。→ **本次实现**：launcher 启动 app/切 activity 据 `app.json fullscreen`/`route.<id>.fullscreen` 预设 SDK 全屏（env `MEOW_FULLSCREEN`），见 §5.1/§3.1。注意全屏语义由「隐藏状态栏+隐藏返回键」细化为「状态栏收合至提示线 + 保留左缘返回+顶部提示线+下滑通知中心（热区缩小）」（见 A-13）。
|
||||
- **A-13 全屏语义细化（状态栏「隐藏」→「收合至提示线」）**：既有 §3.1/§5.1 描述全屏=隐藏状态栏（`meow_ui_statusbar_height()`=0、隐藏返回键=沉浸）；本次定案细化为**进入/退出全屏：状态栏向上收出屏顶、只留一条提示线高度**，**全屏下保留**左缘返回手势 + 顶部动态伸缩提示线，且**顶部下滑仍可开通知中心（顶部热区缩小）**。→ 需在 SDK 端明确「收合（collapsed）」状态（新增 `meow_ui_statusbar_collapsed()` 等）与「隐藏」的差异，UI 依此绘制提示线。
|
||||
- **A-11 `MeowOS/opt/` vs `MeowOpt/`（已归并）**：曾有顶层 `MeowOpt/`（板载外部工具/二进制，如 mdnsd）与 `MeowOS/opt/{bin,nyai,sources.list},lib/,tools/`（nyai 包管 + 工具）并存、命名仅大小写之差。→ **已归并**：`MeowOpt` 废弃并入 `MeowOS/opt/`；mDNS 由完整 mdnsd（TF MeowOS/opt/mdnsd）改为**自研 `meow_mdns`（固件 `/usr/bin`，IPv4-only）**，不再放卡。全仓库统一用 `MeowOS/opt/`。
|
||||
- **A-12 `fullscreen` 字段（已定 → 已实现，M2.5x）**：§5.5 与 MEOW_APP_SDK §9 将 `fullscreen` 列为 app.json 字段，但 `meow_parse_app_json()` **此前并未读取该键**（实现只解析 name/exec/icon/package/framework/immersive/route./awake./service.），属"已定未做"。→ **已实现**：launcher 启动 app/切 activity 据 `app.json fullscreen`/`route.<id>.fullscreen` 预设 SDK 全屏（env `MEOW_FULLSCREEN`），见 §5.1/§3.1。全屏语义由「隐藏状态栏+隐藏返回键」细化为「状态栏收合至提示线 + 保留左缘返回+顶部提示线+下滑通知中心（热区缩小）」（见 A-13）。
|
||||
- **A-13 全屏语义细化（状态栏「隐藏」→「收合至提示线」）**：既有 §3.1/§5.1 描述全屏=隐藏状态栏（`meow_ui_statusbar_height()`=0、隐藏返回键=沉浸）；本次定案细化为**进入/退出全屏：状态栏向上收出屏顶、只留一条提示线高度**，**全屏下保留**左缘返回手势 + 顶部动态伸缩提示线，且**顶部下滑仍可开通知中心（顶部热区缩小）**。→ **已实现（M2.5x）**：SDK 端明确「收合（collapsed）=状态栏缩为提示线(4px)」vs「隐藏=高度0」；全屏下保留左缘返回+顶部伸缩滑条+顶部下滑通知中心（热区缩小）。⚠️ **全屏顶部动态伸缩滑条仍有已知问题在跟进（agent-112）**。
|
||||
- **A-14 `fonts` 键二义**：§5.7.3 `"fonts":[<handle>…]`=应用自带字库句柄数组；§5.2/§5.7.8 `"fonts":"full"|"gbk"|"common"`=字库档位字符串。→ 同名键两种语义，解析器需区分（字符串→档位 / 数组→句柄）；若避免歧义可改用专键如 `"font_tier"`（**未拍板**）。
|
||||
`[各源标注见上]`
|
||||
Reference in new issue
Block a user