feat:人脸机器实时增量更新

lib/common/utils/json/json_tool.dart

@@ -41,6 +41,15 @@ abstract class JsonTool {
     return value.toString();
   }
 
+  /// 将后端必填 Long 或字符串标识转换为非空字符串；缺失或空值时在模型边界直接拒绝。
+  static String anyToRequiredString(Object? value) {
+    final result = anyToString(value)?.trim();
+    if (result == null || result.isEmpty) {
+      throw const FormatException('必填标识不能为空');
+    }
+    return result;
+  }
+
   /// 后端为避免 19 位 Long 在部分客户端丢失精度，可能把 ID 序列化为字符串。
   /// 这里同时兼容字符串和数字，忽略无法安全转换的异常项。
   static List<int> anyListToIntList(Object? value) {