From cfc39c75fc8dea873a1481fd559f9bed6de5e62a Mon Sep 17 00:00:00 2001 From: empty Date: Sat, 7 Feb 2026 20:27:40 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20README=20=E5=8F=8D?= =?UTF-8?q?=E6=98=A0=201.0=20=E6=9C=80=E6=96=B0=E4=BB=A3=E7=A0=81=E7=8A=B6?= =?UTF-8?q?=E6=80=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增功能特性：国际化、引导页、设置中心、最近作品 - 更新项目结构：8 个 View + 新增管理器和国际化文件 - 修正克隆地址为 Gitea 仓库 - 补充 AI 超分辨率技术细节（ODR、流式混合、vImage） - 新增国际化章节（9 语言） - 补充文档表格 Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 74 +++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 53 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 91725d7..f62b7f5 100644 --- a/README.md +++ b/README.md @@ -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 x4plus（Core ML，64MB） -- 处理：512×512 分块 + 64px 重叠 + 线性混合 +- 模型：Real-ESRGAN x4plus（Core 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) | 多语言上架信息 | ## 📜 许可证