feat: M2-M4 完成,添加 AI 增强、设计系统、App Store 准备

新增功能:
- AI 超分辨率模块 (Real-ESRGAN Core ML)
- Soft UI 设计系统 (DesignSystem.swift)
- 设置页、隐私政策页、引导页
- 最近作品管理器

App Store 准备:
- 完善截图 (iPhone 6.7"/6.5", iPad 12.9")
- App Store 元数据文档
- 修复应用图标 alpha 通道
- 更新显示名称为 Live Photo Studio

工程配置:
- 配置 Git LFS 跟踪 mlmodel 文件
- 添加 Claude skill 开发指南
- 更新 .gitignore 规则

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
empty
2025-12-16 10:24:31 +08:00
parent 64cdb82459
commit 5aba93e967
46 changed files with 5279 additions and 421 deletions

252
docs/USER_GUIDE.md Normal file
View File

@@ -0,0 +1,252 @@
# Live Photo Maker 用户手册
## 快速开始
### 第一步:导入视频
1. 打开 App在首页点击「选择视频」按钮
2. 从相册中选择一段视频(建议 2-5 秒)
3. 等待视频加载完成,自动跳转到编辑页
> 💡 **提示**:首次使用需要授权相册访问权限
---
### 第二步:编辑参数
#### 比例模板
- **iPhone 锁屏**9:19.5,适合设置为锁屏壁纸
- **全面屏**9:16适合全面屏手机
- **4:3**:经典比例
#### 时长调整
- 使用滑块选择视频片段1-1.5 秒)
- Live Photo 标准时长约 0.9 秒
#### 画面裁剪
- **双指缩放**:调整画面大小
- **拖拽移动**:调整画面位置
#### 封面帧选择
- 滑动选择器选择静态封面帧
- 预览区域实时显示效果
#### 兼容模式(推荐开启)
- 自动将视频转换为最兼容的格式
- 参数720p / 30fps / H.264 / SDR
- 适用于4K 视频、HDR 视频、HEVC 编码视频
---
### 第三步:生成 Live Photo
1. 点击「生成 Live Photo」按钮
2. 等待处理完成(通常 10-30 秒)
3. 生成成功后自动保存到相册
#### 处理阶段说明
| 阶段 | 说明 |
|------|------|
| normalize | 视频格式标准化 |
| extractKeyFrame | 提取封面帧 |
| writePhotoMetadata | 写入照片元数据 |
| writeVideoMetadata | 写入视频元数据 |
| saveToAlbum | 保存到相册 |
| validate | 校验 Live Photo |
---
### 第四步:设置为壁纸
#### iOS/iPadOS 17+ 设置方法
1. 打开系统「照片」App
2. 找到刚保存的 Live Photo左上角有 LIVE 标识)
3. 点击左下角「分享」按钮
4. 选择「用作壁纸」
5. **重要**:确保 Live Photo 图标已开启(高亮状态)
6. 点击「添加」完成设置
7. 锁屏后长按屏幕测试动态效果
#### iOS/iPadOS 16 限制
⚠️ iOS/iPadOS 16 系统不支持将 Live Photo 设置为带动态效果的锁屏壁纸。
- 可以设置为普通静态壁纸
- 升级到 iOS/iPadOS 17+ 可获得完整体验
---
## 设置页功能
### 权限状态
- 显示当前相册权限状态
- 如未授权,可点击「前往设置授权」
### 清理缓存
- 显示当前缓存大小
- 清理缓存不会影响已保存的 Live Photo
### 清空最近作品记录
- 仅清除 App 内的作品记录
- 不会删除相册中的 Live Photo
### 导出诊断报告
- 用于反馈问题时附带
- 仅包含日志和参数,不含媒体内容
---
## 常见问题 FAQ
### Q1: 为什么长按壁纸没有动画效果?
**可能原因及解决方案**
1. **低电量模式已开启**
- 前往「设置 → 电池」关闭低电量模式
2. **Live Photo 效果未开启**
- 设置壁纸时,确保 Live Photo 图标为高亮状态
3. **系统版本不支持**
- iOS/iPadOS 16 不支持锁屏动态效果
- 升级到 iOS/iPadOS 17+ 可解决
4. **照片不是 Live Photo**
- 在相册中确认照片左上角有「LIVE」标识
---
### Q2: 生成失败怎么办?
**尝试以下步骤**
1. **开启兼容模式**
- 适用于高分辨率、HDR、特殊编码的视频
2. **缩短选择时长**
- 选择 1 秒左右的片段
3. **更换视频素材**
- 尝试使用 iPhone 原生拍摄的视频
4. **清理缓存后重试**
- 前往「设置 → 清理缓存」
5. **重启 App**
- 完全退出后重新打开
---
### Q3: 相册里找不到 LIVE 标识?
**可能原因**
1. **照片未正确保存**
- 检查保存时是否提示成功
2. **查看方式不对**
- 在「照片」App 中查看不是「文件」App
3. **滤镜显示**
- 在「照片」App 中,点击「相簿 → 媒体类型 → Live Photo」查看
---
### Q4: 为什么建议开启兼容模式?
某些视频格式可能不被系统完全支持为 Live Photo 的配对视频:
| 素材类型 | 建议 |
|---------|------|
| 4K 视频 | 开启兼容模式 |
| HDR 视频 | 开启兼容模式 |
| HEVC (H.265) | 开启兼容模式 |
| H.264 1080p | 可不开启 |
兼容模式会将视频转换为:
- 分辨率720p
- 帧率30fps
- 编码H.264
- 色彩SDR
---
### Q5: 支持哪些视频格式?
**支持的格式**
- MP4 / MOV / M4V
- H.264 / HEVC (H.265) 编码
- SDR / HDR 色彩空间
- 任意分辨率(会自动缩放)
- 任意帧率(会自动调整)
**不支持**
- 网络视频链接
- 非视频文件
---
### Q6: Live Photo 占用多少存储空间?
单个 Live Photo 通常占用 **2-5 MB**
- 静态照片:约 1-2 MB
- 配对视频:约 1-3 MB
开启兼容模式后,文件体积会更小。
---
## 错误代码说明
| 错误代码 | 含义 | 建议操作 |
|---------|------|---------|
| LPB-001 | 导入失败 | 检查视频格式,换一个视频重试 |
| LPB-101 | 标准化失败 | 开启兼容模式重试 |
| LPB-201 | 提取帧失败 | 缩短视频时长,开启兼容模式 |
| LPB-301 | 元数据写入失败 | 清理缓存后重试 |
| LPB-401 | 保存失败 | 检查相册权限,检查存储空间 |
| LPB-901 | 未知错误 | 导出诊断报告并反馈 |
---
## 技术规格
### 输出参数
| 参数 | 标准模式 | 兼容模式 |
|------|---------|---------|
| 照片分辨率 | 最高 1080p | 720p |
| 视频分辨率 | 最高 1080p | 720p |
| 视频帧率 | 60fps | 30fps |
| 视频编码 | 保持原编码 | H.264 |
| 色彩空间 | 保持原色彩 | SDR |
| 时长 | ~0.9 秒 | ~0.9 秒 |
### 系统要求
- **最低支持**iOS/iPadOS 16.0
- **完整体验**iOS/iPadOS 17.0+
- **存储空间**:建议剩余 100 MB 以上
---
## 隐私说明
- 所有处理均在本地完成
- 不上传任何媒体内容到服务器
- 仅在用户明确操作时访问相册
- 诊断报告不包含媒体内容
---
## 反馈与支持
如遇到问题,请通过以下方式反馈:
1. 在 App 内「设置 → 导出诊断报告」
2. 将诊断报告通过邮件发送给我们
3. 描述问题发生的步骤和现象
我们会尽快处理您的反馈!