导入镜框 — 文件格式

导入镜框是一个面向支持场景的恢复工具 — 例如在设备丢失且没有 iCloud 备份时恢复镜框库。它默认隐藏：只有在 Frame 支持团队为你的账户开启后，入口才会出现在设置 → 备份中。如果你认为自己需要它，请先通过 [email protected] 联系我们。

文件夹结构

导入工具会让你选择一个文件夹，其中包含一个清单文件以及它引用的照片：

My Frames/
├── frames.json
├── rayban-aviator.jpg
├── rayban-aviator-sticker.jpg
└── persol-649.jpg

照片也可以放在一个嵌套子文件夹中 — 导入工具会向下一层解析裸文件名。

frames.json

{
  "version": 1,
  "frames": [
    {
      "client_id": "5D2A7C1E-4B9F-4E2A-8C3D-1F6E9A0B2C4D",
      "name": "Ray-Ban Aviator",
      "image": "rayban-aviator.jpg",
      "sticker_image": "rayban-aviator-sticker.jpg",
      "brand": "Ray-Ban",
      "model": "RB3025",
      "shape": "aviator",
      "is_favorite": true,
      "price_amount": 161.0,
      "price_currency": "USD",
      "product_url": "https://example.com/rb3025",
      "created_at": "2026-05-01T10:00:00Z"
    },
    {
      "client_id": "0A1B2C3D-4E5F-6789-ABCD-EF0123456789",
      "name": "Persol 649",
      "image": "persol-649.jpg"
    }
  ]
}

字段

字段必填说明
client_id是UUID 字符串。设备上已存在的重复镜框会被跳过，绝不会被覆盖。
name是镜框的显示名称。
image建议主商品照片的相对路径（JPEG/PNG）。文件缺失可以容忍 — 镜框会在没有照片的情况下导入。
sticker_image, additional_image_1, additional_image_2否额外照片，路径规则与 image 相同。
brand, model, shape, size, material, color_variant否自由格式字符串。
lens_width, bridge_width, temple_length否毫米，数值。
is_favorite否布尔值，默认为 false。
price_amount, price_currency, original_price_amount, product_url否价格元数据。
created_at否ISO 8601 时间戳；默认为导入时间。
裸 JSON 镜框记录数组（不带 {"version", "frames"} 外层包装）也可以接受，作为旧版别名。

导入的行为方式