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