1

flutter_app/README.md

@@ -27,6 +27,29 @@ xcrun devicectl device process launch --console --terminate-existing \
   "In iOS 14+, debug mode Flutter apps can only be launched from Flutter tooling"。
   debug 调试必须用 `flutter run -d <设备ID>` 或 Xcode IDE 启动（`flutter devices` 查设备ID）；
   从图标启动只对 release 构建有效。
+## 模型热更新（多数据集模型）
+
+模型与 APK 更新走**独立通道**：启动时拉取 `GET /api/v1/app/update` 随附的
+`models` 目录（公开接口，无需登录），与 `UpdateChecker` 的 APK 检查并行。
+
+- **目录条目**：`{datasetId, datasetName, version, labels[], sizeBytes, sha256,
+  downloadUrl}`；服务器未发布模型时不返回 `models` 字段，App 回退内置
+  `assets/model.tflite`（标签 `内置`）。
+- **存储**：应用私有目录 `models/<datasetId>/`，含 `model.tflite`、
+  `labels.json`、`meta.json`（meta 记录 `{version, sha256}`）。版本与摘要都
+  未变化时跳过下载；变化则下载到 `.part` 临时文件、sha256 校验通过后
+  原子 rename 替换，失败重试一次并保留旧模型，下次启动再试。
+- **清理**：服务器下线的数据集下次同步时删除本地对应目录。
+- **并行推理合并**：识别时加载全部已下载模型（`DetectorWorker` isolate 内
+  逐模型加载，单个失败不影响其他），同帧各模型独立推理后按类别分组做
+  **跨模型 NMS**（同类别不同模型检出同一目标取高分去重，不同类别互不压制），
+  结果叠加 `modelName` 标注来源，内置模型兜底。
+
+实现：`lib/models/model_manager.dart`（下载/校验/持久化，`ModelManager`
+单例 + ChangeNotifier）、`lib/detection/detector_worker.dart`（多模型并行
+推理与 `mergeAcrossModels`）、`lib/camera/camera_screen.dart`（启动同步 +
+诊断行展示模型列表）。
+
 - **模型输入是 NHWC**：`assets/model.tflite` 做过字节级手术（开头 TRANSPOSE→RESHAPE，
   输入 [1,320,320,3]），改动记录见 git 历史，重导模型需同步处理，否则 iOS 报
   "Node number 0 (TRANSPOSE) failed to prepare"。