docs(repo): 仓库公开文档同步到 M2.73/0.7.68 + 修 fw_content.conf 过期 md5(meow_svcd da6ebc66/meow_svc_perf fa073bf9, 否则打包 md5 强校验失败中止) (agent-171)

patch_v2/meowpanel/README.md

@@ -8,9 +8,10 @@ C 静态二进制，内嵌 HTTP/JSON 服务器 + 前端静态托管 + 框架专
   （launcher/sdk/设置/通知）绝不依赖它。
 - **协议**：`devdocs/plan/MEOWPANEL_PROTOCOL.md`（HTTP/JSON 端点；本实现以「实现为准，协议/README 记录出入」）。
 - **数据路径**（`SYSTEM_FRAMEWORK_SERVICES.md §2/§4`）：读侧（`/api/{status,perf,system}`）经 `meow_svc_perf`
-  IPC（`MSG_PERF_QUERY→RESULT`）聚合，**绝不各自爬 /proc**；动作侧（`/api/system/{reboot,shutdown,ota}`）经
+  IPC（`MSG_PERF_QUERY→RESULT`）聚合，**绝不各自爬 /proc**（M2.73 起 perf 聚合含 `network` 段）；动作侧（`/api/system/{reboot,shutdown,ota}`）经
   `meow_svc_power` IPC（`MSG_POWER_ACTION→STATUS`），不再直连 `poweroff`/写 mtd5。两专项服务为**板载 svcd 托管**
   （`trigger=boot`），拔卡保留，与无卡依赖最小化自洽。
+- **⚠️ OTA 检查升级 ≠ 升级**：前端「检查升级」只读 `GET /api/system` 的 `ota{current,available,latest}`，**勿 `POST /api/system/ota`**（那是触发升级进升级模式）。
 
 ---
 
@@ -27,7 +28,7 @@ cd /home/Aska/Project/R3ProII/patch_v2/meowpanel
 - 两分支均以 `-Os -Wall -Wextra` 复核，**0 warning**。
 - 产出（本次构建实测）：
   - `meowpanel`：mipsel 静态，`ELF 32-bit LSB executable, MIPS, MIPS32 rel2, statically linked, stripped`，
-    体积约 **166 KB**（固件阈值内）。md5：`ea1d6a58cbc0d312498d3925e2fd2127`。
+    体积约 **166 KB**（固件阈值内）。md5：`11ed76ecb2e1c5773a01f0fb056a2df5`。
   - `meowpanel_host`：aarch64 动态链接（宿主编译，仅供调试），体积约 **77 KB**。
 - 依赖：仅 libc + Linux 内核头（`linux/input.h`），零第三方库（设备无 python3/lua）。
 - 头文件引用：`-I patch_v2/meow_launcherd`（`meow_ipc.h` 帧格式 / `m_perf_*`/`m_power_*`/`POWER_*`，
@@ -76,7 +77,7 @@ http://<host>.local:8080/
 | GET | `/`、`/meowpanel.css`、`/meowpanel.js`、`/assets/<f>` | 静态托管 | ✅ |
 | GET | `/api/status` | 性能+系统（`meow_svc_perf` IPC subset=all 透传） | ✅ |
 | GET | `/api/perf` | 仅性能（subset=perf 透传） | ✅ |
-| GET | `/api/system` | perf IPC + boot/network/ota 局部补全（见注） | ✅ |
+| GET | `/api/system` | perf IPC + boot/network/ota 局部补全（network 含蓝牙，无网口；`ota` 只读检查，勿误触升级） | ✅ |
 | POST | `/api/system/reboot`、`/shutdown`、`/ota` | `meow_svc_power` IPC | ✅ |
 | GET | `/api/settings` | 全量+元数据（items/count/groups） | ✅ |
 | GET | `/api/settings/:key` | 单项 | ✅ |
@@ -203,9 +204,7 @@ http://<host>.local:8080/
    **改为直接镜像同一份 `settings.conf`**（同款 parse/save 契约）。改哪边都会落同一文件，实体/网页/CLI 仍同步（listener/落盘）。
 3. **`display.brightness` 元数据**：`g_defs` 为 `min=0 max=255 def=101`；但语义 clamp 到 `[brightness_min(1),100]`
    （防 101 闪屏）。后端给前端 `min=1 max=100`（协议 §3.2 期望），读值经 clamp 后返回（默认→100）。若回改协议可注明「原始表 0-255，面板展示语义 1-100」。
-4. **`/api/system` 的 `network`/`ota`**：由性能服务聚合（`SYSTEM_FRAMEWORK_SERVICES §4.1`）后，后端只补
-   `boot.default`（读 `/data/meow_boot_default`）、`network.hostname_local`（hostname+.local）与 `ota{current=version,available:false,url:null}`；
-   **wifi/ethernet/ota.available 不编造**（服务未聚合，前端对缺失字段显示占位）。若回改协议可注明「network/ota 待并入 perf 服务」。
+4. **`/api/system` 的 `network`/`ota`**：**M2.73** 起 perf 服务已聚合 `network` 段（真实 WiFi `wpa_cli`/`ip` + 蓝牙 `hci0`/sysfs + `hostname_local`，SYSTEM 子集），后端直接透传；只补 `boot.default`（读 `/data/meow_boot_default`）与 `ota{current=version,available:false,url:null}`。**网络栏以「蓝牙」为准**（设备无网口，无 `以太网` 一行，`bluetooth.available=false` 显示「无蓝牙」）。若回改协议可注明「network 已并入 perf 服务，ota 为面板占位」。
 5. **`/api/files` 上传/删除/重命名等 path**：前端对这些操作传**绝对路径**（`d.path/子项`），列表传**相对 root**；
    后端 `normalize_path` 对两者均容错（相对则拼 root，绝对则直用），符合协议「白名单根 + 规范化」。
 6. **`GET /api/files` 返回值**：`files_list` 返回 `500` 语义时以 500 封装（协议未定义 `root` 之外错误枚举，用通用错误信封）。
@@ -234,7 +233,7 @@ http://<host>.local:8080/
 patch_v2/meowpanel/
 ├── meowpanel.c             # 后端源码（单文件，约 2700 行）
 ├── build_meowpanel.sh      # 交叉编译 + host 分支（-Wall -Wextra 0 warning）
-├── meowpanel               # 交叉产物（mipsel 静态，165 KB，md5 a8224ef9…）
+├── meowpanel               # 交叉产物（mipsel 静态，约 166 KB，md5 11ed76ec…）
 ├── meowpanel_host          # 宿主编译（本机 ld，调试用）
 ├── services.d/
 │   └── meowpanel.conf      # 部署到 TF 卡 MeowOS/services.d/meowpanel.conf