docs: 更新 README 反映 1.0 最新代码状态

- 新增功能特性:国际化、引导页、设置中心、最近作品
- 更新项目结构:8 个 View + 新增管理器和国际化文件
- 修正克隆地址为 Gitea 仓库
- 补充 AI 超分辨率技术细节(ODR、流式混合、vImage)
- 新增国际化章节(9 语言)
- 补充文档表格

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
empty
2026-02-07 20:27:40 +08:00
parent 8a04d9774d
commit cfc39c75fc

View File

@@ -10,9 +10,13 @@
- 📹 **视频转 Live Photo** — 导入相册视频,一键生成系统可识别的 Live Photo
- ✂️ **精准裁剪** — 时长裁剪1~1.5s+ 多比例模板(锁屏/全面屏/4:3/1:1
- 🎨 **AI 超分辨率** — 集成 Real-ESRGAN智能提升画面清晰度
- 🎨 **AI 超分辨率** — 集成 Real-ESRGAN智能提升画面清晰度On-Demand Resources 按需下载)
- 🖼️ **封面帧选择** — 滑杆精选最佳静态封面
- 📱 **壁纸引导** — 系统版本适配的设置步骤引导
- 🌍 **9 语言国际化** — 简/繁中文、英、日、韩、法、西、阿拉伯语,应用内切换
- 🎯 **首次引导** — 4 页 Onboarding 流程,快速了解核心功能
- ⚙️ **设置中心** — 语言切换、缓存管理、权限状态、隐私政策
- 🕐 **最近作品** — 自动记录历史作品,缩略图预览,一键设为壁纸
## 📱 系统要求
@@ -25,7 +29,7 @@
### 克隆项目
```bash
git clone https://github.com/yourusername/to-live-photo.git
git clone https://git.let5see.xyz/let5see/to-live-photo.git
cd to-live-photo
```
@@ -49,23 +53,32 @@ xcodebuild -scheme to-live-photo \
```
to-live-photo/
├── Sources/LivePhotoCore/ # Swift Package - 核心库
│ ├── LivePhotoCore.swift # 生成管线、数据模型
│ ├── AIEnhancer/ # Real-ESRGAN 超分辨率
│ └── Resources/ # metadata.mov, ML 模型
├── to-live-photo/ # iOS App
│ ├── Views/ # SwiftUI 视图
│ │ ├── HomeView.swift # 首页导入
│ │ ├── EditorView.swift # 编辑裁剪
│ │ ├── ProcessingView.swift # 处理进度
│ │ ├── ResultView.swift # 保存结果
│ │ ── WallpaperGuideView.swift # 壁纸引导
│ ├── AppState.swift # 全局状态管理
└── DesignSystem.swift # Soft UI 设计令牌
└── docs/ # 文档
├── USER_GUIDE.md # 用户手册
├── TEST_MATRIX.md # 测试矩阵
── APP_STORE_METADATA.md # 上架信息
├── Sources/LivePhotoCore/ # Swift Package - 核心库
│ ├── LivePhotoCore.swift # 生成管线、数据模型
│ ├── AIEnhancer/ # Real-ESRGAN 超分辨率5 个模块)
│ └── Resources/ # metadata.mov
├── to-live-photo/ # iOS App
│ ├── Views/ # SwiftUI 视图8 个)
│ │ ├── OnboardingView.swift # 首次引导
│ │ ├── HomeView.swift # 首页导入 + 最近作品
│ │ ├── EditorView.swift # 编辑裁剪
│ │ ├── ProcessingView.swift # 处理进度
│ │ ── ResultView.swift # 保存结果
│ ├── WallpaperGuideView.swift # 壁纸引导
│ ├── SettingsView.swift # 设置中心
└── PrivacyPolicyView.swift # 隐私政策 / 使用条款
├── AppState.swift # 全局状态 + 导航路由
├── ContentView.swift # 根视图 + 截屏保护
── DesignSystem.swift # Soft UI 设计令牌
│ ├── LanguageManager.swift # 多语言切换
│ ├── RecentWorksManager.swift # 最近作品管理
│ ├── Analytics.swift # 埋点统计
│ ├── Localizable.xcstrings # 主国际化文件9 语言)
│ └── InfoPlist.xcstrings # Info.plist 国际化
├── scripts/ # 构建 & 国际化脚本
├── app-store-screenshots/ # App Store 截图8 语言 × 6 张)
├── livephotomaker-pages/ # 官网子模块8 语言)
└── docs/ # 文档
```
## 🔧 技术架构
@@ -88,10 +101,27 @@ normalize → extractKeyFrame → aiEnhance → writePhotoMetadata → writeVide
### AI 超分辨率
- 模型Real-ESRGAN x4plusCore ML64MB
- 处理512×512 分块 + 64px 重叠 + 线性混合
- 模型Real-ESRGAN x4plusCore ML通过 On-Demand Resources 按需下载
- 处理512×512 分块 + 64px 重叠 + 流式线性混合(内存优化)
- 格式转换vImage 加速 BGRA↔RGBA
- 放大:约 2.25x(输入 512→输出 2048
## 🌍 国际化
支持 9 种语言,应用内实时切换:
| 语言 | 代码 |
|-----|------|
| 简体中文 | zh-Hans |
| 繁体中文 | zh-Hant |
| English | en |
| 日本語 | ja |
| 한국어 | ko |
| Français | fr |
| Español | es |
| العربية | ar |
| 跟随系统 | — |
## 📋 开发规范
### Git 提交类型
@@ -117,6 +147,8 @@ normalize → extractKeyFrame → aiEnhance → writePhotoMetadata → writeVide
| [TASK.md](TASK.md) | 里程碑与任务追踪 |
| [docs/USER_GUIDE.md](docs/USER_GUIDE.md) | 用户使用手册 |
| [docs/TEST_MATRIX.md](docs/TEST_MATRIX.md) | 测试用例矩阵 |
| [docs/APP_STORE_METADATA.md](docs/APP_STORE_METADATA.md) | 上架信息 |
| [docs/APP_STORE_METADATA_I18N.md](docs/APP_STORE_METADATA_I18N.md) | 多语言上架信息 |
## 📜 许可证