iBook/ipad_app

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 源码文件由后续步骤自动生成。