'update'

ipad_app/README.md

@@ -0,0 +1,70 @@
+# iPad Reader (Offline Bundle Viewer)
+
+基于 Python 导出的 iPad 数据包 (export_ipad_bundle) 的 SwiftUI 离线浏览器。
+
+## 目标
+- 离线浏览书籍元数据、书评与批注
+- 快速导入 ZIP（`ipad_bundle_*.zip`）
+- 原生 SwiftUI + Charts 展示周/月/年/气泡统计（含今年已读）
+- 本地沙盒解压 + 简单封面缓存
+
+## 数据包结构
+```
+books_meta.json      # 书籍元信息数组
+annotations.json     # { bookId: [ {uuid, creationdate, selected, note, ...}, ... ] }
+stats.json           # { global: {...} }
+bookintro.json       # { title: review }
+covers/<id>.jpg      # 封面缩略图
+```
+
+## 运行环境
+- Xcode 15+
+- iOS 17 SDK（可改最低到 16，只要使用 Charts 框架即可）
+- Swift 5.9+
+
+## 功能概览
+- 文档导入：使用 `UIDocumentPickerViewController` (通过 `UIKit` bridge) 选择 ZIP
+- 解压：使用 `ZIPFoundation`（需 SPM 依赖）到 `Library/Application Support/ImportedBundle/<timestamp>/`
+- 模型解析：JSONDecoder -> 内存模型 + 按需懒加载 annotations
+- 统计：Swift Charts 构建 4 个图 + “已读”气泡自绘
+- 搜索：标题/作者前缀过滤（基础实现）
+
+## 目录结构
+```
+ipad_app/
+  README.md
+  Package.swift
+  Sources/
+    IpadReaderApp.swift         # 入口
+    Models/BundleModels.swift   # 数据模型
+    Services/BundleImporter.swift
+    Services/ImageCache.swift
+    ViewModels/LibraryViewModel.swift
+    Views/ContentView.swift
+    Views/BookListView.swift
+    Views/BookDetailView.swift
+    Views/StatsView.swift
+    Views/Components/BubbleMetricsView.swift
+```
+
+## 添加依赖
+在 `Package.swift` 中引用：
+```
+.package(url: "https://github.com/weichsel/ZIPFoundation", from: "0.9.0")
+```
+
+## 使用步骤
+1. 在根目录执行 `open ipad_app` 用 Xcode 打开 (或手动新建本地 Package App)
+2. 运行到模拟器或真机（首次会是空库）
+3. 点击 导入按钮，选择 Python 导出的 `ipad_bundle_*.zip`
+4. 等待解析后显示书籍列表
+5. 进入详情查看笔记与书评
+
+## 后续可扩展
+- Spotlight / CoreData 持久化
+- 批注全文搜索、高亮段落分组
+- AI 离线摘要缓存合并
+- 多次导入合并策略（按 book id 去重）
+
+---
+此目录下其余 Swift 源码文件由后续步骤自动生成。