refactor: rename RDReaderView -> RDEpubReaderView, update pod config and docs

- Rename source module from RDReaderView to RDEpubReaderView
- Move all source files from Sources/RDReaderView/ to Sources/RDEpubReaderView/
- Update podspec: RDReaderView.podspec -> RDEpubReaderView.podspec
- Update Podfile, demo project, and CocoaPods config for new pod name
- Delete old RDReaderView pod support files from ReadViewDemo/Pods
- Add new RDEpubReaderView pod support files
- Update documentation (API ref, architecture, UML, conventions, etc.)
- Add FixedLayoutRotationTests
- Update .gitignore: exclude .DS_Store, manual unpack backups, _ssoft-output

Doc/API_REFERENCE.md

@@ -8,7 +8,7 @@
 
 ## 1. RDEPUBReaderController — 入口控制器
 
-**文件**：`Sources/RDReaderView/EPUBUI/RDEPUBReaderController.swift` 及扩展
+**文件**：`Sources/RDEpubReaderView/EPUBUI/RDEPUBReaderController.swift` 及扩展
 
 ### 1.1 初始化
 
@@ -180,7 +180,7 @@ func nativeTextSemanticSummary() -> String?
 
 ## 2. RDEPUBReaderDelegate — 委托协议
 
-**文件**：`Sources/RDReaderView/EPUBUI/RDEPUBReaderDelegate.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBUI/RDEPUBReaderDelegate.swift`
 
 所有方法均有默认空实现，可按需实现。
 
@@ -232,7 +232,7 @@ public protocol RDEPUBReaderDelegate: AnyObject {
 
 ## 3. RDEPUBReaderPersistence — 持久化协议
 
-**文件**：`Sources/RDReaderView/EPUBUI/RDEPUBReaderPersistence.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBUI/RDEPUBReaderPersistence.swift`
 
 ```swift
 public protocol RDEPUBReaderPersistence: AnyObject {
@@ -264,7 +264,7 @@ public protocol RDEPUBReaderPersistence: AnyObject {
 
 ## 4. RDEPUBReaderConfiguration — 配置模型
 
-**文件**：`Sources/RDReaderView/EPUBUI/Settings/RDEPUBReaderConfiguration.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBUI/Settings/RDEPUBReaderConfiguration.swift`
 
 | 属性 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
@@ -273,7 +273,7 @@ public protocol RDEPUBReaderPersistence: AnyObject {
 | `fontChoice` | `RDEPUBReaderFontChoice` | `.system` | 字体选择（system/serif/rounded/monospaced） |
 | `numberOfColumns` | `Int` | `1` | 每页列数（1 或 2） |
 | `columnGap` | `CGFloat` | `20` | 列间距 |
-| `displayType` | `RDReaderView.DisplayType` | `.pageCurl` | 翻页模式 |
+| `displayType` | `RDEpubReaderView.DisplayType` | `.pageCurl` | 翻页模式 |
 | `landscapeDualPageEnabled` | `Bool` | `true` | 横屏双页 |
 | `showsTableOfContents` | `Bool` | `true` | 显示目录 |
 | `allowsHighlights` | `Bool` | `true` | 允许高亮 |
@@ -301,50 +301,50 @@ public protocol RDEPUBReaderPersistence: AnyObject {
 
 ## 5. 翻页容器协议
 
-**文件**：`Sources/RDReaderView/ReaderView/RDReaderViewProtocols.swift`
+**文件**：`Sources/RDEpubReaderView/ReaderView/RDEpubReaderViewProtocols.swift`
 
-### 5.1 RDReaderPageProvider（推荐）
+### 5.1 RDEpubReaderPageProvider（推荐）
 
 ```swift
-@objc public protocol RDReaderPageProvider: NSObjectProtocol {
+@objc public protocol RDEpubReaderPageProvider: NSObjectProtocol {
 
     /// 总页数
-    func numberOfPages(in readerView: RDReaderView) -> Int
+    func numberOfPages(in readerView: RDEpubReaderView) -> Int
 
     /// 返回指定页的视图
     /// - Parameters:
     ///   - index: 页码索引（0-based）
     ///   - reusableView: 可复用的旧视图（可能为 nil）
-    func readerView(_ readerView: RDReaderView, viewForPageAt index: Int, reusableView: UIView?) -> UIView
+    func readerView(_ readerView: RDEpubReaderView, viewForPageAt index: Int, reusableView: UIView?) -> UIView
 
     /// 页面标识符（用于缓存去重）
-    @objc optional func pageIdentifier(in readerView: RDReaderView, index: Int) -> String?
+    @objc optional func pageIdentifier(in readerView: RDEpubReaderView, index: Int) -> String?
 
     /// 顶部工具栏视图
-    @objc optional func readerViewTopChrome(_ readerView: RDReaderView) -> UIView?
+    @objc optional func readerViewTopChrome(_ readerView: RDEpubReaderView) -> UIView?
 
     /// 底部工具栏视图
-    @objc optional func readerViewBottomChrome(_ readerView: RDReaderView) -> UIView?
+    @objc optional func readerViewBottomChrome(_ readerView: RDEpubReaderView) -> UIView?
 }
 ```
 
-### 5.2 RDReaderDelegate
+### 5.2 RDEpubReaderDelegate
 
 ```swift
-@objc public protocol RDReaderDelegate: NSObjectProtocol {
+@objc public protocol RDEpubReaderDelegate: NSObjectProtocol {
 
     /// 页面变化回调
-    func pageNum(readerView: RDReaderView, pageNum: Int)
+    func pageNum(readerView: RDEpubReaderView, pageNum: Int)
 
     /// 屏幕方向即将变化
-    @objc optional func readerViewOrientationWillChange(readerView: RDReaderView, isLandscape: Bool)
+    @objc optional func readerViewOrientationWillChange(readerView: RDEpubReaderView, isLandscape: Bool)
 }
 ```
 
-### 5.3 RDReaderPageNavigating
+### 5.3 RDEpubReaderPageNavigating
 
 ```swift
-public protocol RDReaderPageNavigating: AnyObject {
+public protocol RDEpubReaderPageNavigating: AnyObject {
 
     /// 当前页码
     var currentPage: Int { get }
@@ -357,19 +357,19 @@ public protocol RDReaderPageNavigating: AnyObject {
 }
 ```
 
-### 5.4 RDReaderDataSource（遗留）
+### 5.4 RDEpubReaderDataSource（遗留）
 
 ```swift
-@objc public protocol RDReaderDataSource: NSObjectProtocol {
-    func pageCountOfReaderView(readerView: RDReaderView) -> Int
-    func pageContentView(readerView: RDReaderView, pageNum: Int, containerView: UIView?) -> UIView
-    func pageIdentifier(readerView: RDReaderView, pageNum: Int) -> String?
-    @objc optional func topToolView(readerView: RDReaderView) -> UIView?
-    @objc optional func bottomToolView(readerView: RDReaderView) -> UIView?
+@objc public protocol RDEpubReaderDataSource: NSObjectProtocol {
+    func pageCountOfReaderView(readerView: RDEpubReaderView) -> Int
+    func pageContentView(readerView: RDEpubReaderView, pageNum: Int, containerView: UIView?) -> UIView
+    func pageIdentifier(readerView: RDEpubReaderView, pageNum: Int) -> String?
+    @objc optional func topToolView(readerView: RDEpubReaderView) -> UIView?
+    @objc optional func bottomToolView(readerView: RDEpubReaderView) -> UIView?
 }
 ```
 
-通过 `RDReaderLegacyDataSourceAdapter` 自动适配到 `RDReaderPageProvider`。
+通过 `RDEpubReaderLegacyDataSourceAdapter` 自动适配到 `RDEpubReaderPageProvider`。
 
 ---
 

Doc/ARCHITECTURE.md

@@ -22,7 +22,7 @@ ReadViewSDK 是一个 iOS EPUB 阅读器 SDK，支持文本重排（Reflowable
 │                    ReadViewDemo (Demo App)                    │
 │  ViewController · LaunchAutomationPlan · UITests             │
 └──────────────────────────────┬──────────────────────────────┘
-                               │ imports RDReaderView
+                               │ imports RDEpubReaderView
 ┌──────────────────────────────▼──────────────────────────────┐
 │                       EPUBUI 层                              │
 │  RDEPUBReaderController · Coordinators · Settings · TextPage │
@@ -30,8 +30,8 @@ ReadViewSDK 是一个 iOS EPUB 阅读器 SDK，支持文本重排（Reflowable
 └──────────────────────────────┬──────────────────────────────┘
                                │
 ┌──────────────────────────────▼──────────────────────────────┐
-│                    RDReaderView 层                            │
-│  RDReaderView · FlowLayout · PreloadController               │
+│                    RDEpubReaderView 层                            │
+│  RDEpubReaderView · FlowLayout · PreloadController               │
 │  SpreadResolver · TapRegionHandler · PagingController        │
 └──────────────────────────────┬──────────────────────────────┘
                                │
@@ -54,7 +54,7 @@ ReadViewSDK 是一个 iOS EPUB 阅读器 SDK，支持文本重排（Reflowable
 |---|---|---|
 | **EPUBCore** | EPUB 文件解析、资源管理、WebView 渲染、JS 桥接 | `RDEPUBParser`, `RDEPUBPublication`, `RDEPUBWebView` |
 | **EPUBTextRendering** | HTML→NSAttributedString 转换、排版、分页、全书构建 | `RDEPUBTextBookBuilder`, `RDEPUBCoreTextPageFrameFactory` |
-| **RDReaderView** | 通用翻页容器、手势识别、页面预加载、双页布局 | `RDReaderView`, `RDReaderFlowLayout`, `RDReaderPreloadController` |
+| **RDEpubReaderView** | 通用翻页容器、手势识别、页面预加载、双页布局 | `RDEpubReaderView`, `RDEpubReaderFlowLayout`, `RDEpubReaderPreloadController` |
 | **EPUBUI** | 阅读器控制器、协调器模式、设置面板、按需加载、磁盘缓存 | `RDEPUBReaderController`, `RDEPUBReaderPaginationCoordinator` |
 
 ---
@@ -310,10 +310,10 @@ RDEPUBWebView (UIView)
 
 ---
 
-## 7. 翻页容器架构（RDReaderView）
+## 7. 翻页容器架构（RDEpubReaderView）
 
 ```
-RDReaderView (UIView)
+RDEpubReaderView (UIView)
     │
     ├─ 三种翻页模式:
     │   ├─ .pageCurl        → UIPageViewController (翻页动画)
@@ -321,14 +321,14 @@ RDReaderView (UIView)
     │   └─ .verticalScroll   → UICollectionView (垂直滚动)
     │
     ├─ 组合对象:
-    │   ├─ RDReaderPagingController      // 翻页状态管理、请求队列
-    │   ├─ RDReaderPreloadController     // 页面预加载、缓存管理
-    │   ├─ RDReaderSpreadResolver        // 双页展开计算
-    │   └─ RDReaderTapRegionHandler      // 点击区域分类（左/中/右）
+    │   ├─ RDEpubReaderPagingController      // 翻页状态管理、请求队列
+    │   ├─ RDEpubReaderPreloadController     // 页面预加载、缓存管理
+    │   ├─ RDEpubReaderSpreadResolver        // 双页展开计算
+    │   └─ RDEpubReaderTapRegionHandler      // 点击区域分类（左/中/右）
     │
     ├─ 数据源协议:
-    │   ├─ RDReaderPageProvider (新)     // 格式无关，优先级高
-    │   └─ RDReaderDataSource (旧)      // 遗留兼容，通过 Adapter 适配
+    │   ├─ RDEpubReaderPageProvider (新)     // 格式无关，优先级高
+    │   └─ RDEpubReaderDataSource (旧)      // 遗留兼容，通过 Adapter 适配
     │
     └─ 手势流:
         点击 → TapRegionHandler → 分类（左/中/右）
@@ -351,7 +351,7 @@ struct RDEPUBReaderConfiguration {
     var numberOfColumns: Int                 // 1 或 2
     var columnGap: CGFloat                   // 默认 20
     var theme: ReaderTheme                  // 6 种主题
-    var displayType: RDReaderView.DisplayType // pageCurl/horizontal/vertical
+    var displayType: RDEpubReaderView.DisplayType // pageCurl/horizontal/vertical
     var onDemandChapterWindowSize: Int       // 默认 3（奇数，最小 3，最大 15）
     var metadataParsingConcurrency: Int      // 默认 CPU 核心数
     var chapterWindowRadius: Int             // 内存缓存窗口半径
@@ -374,7 +374,7 @@ struct RDEPUBReaderConfiguration {
 ## 9. 目录结构
 
 ```
-Sources/RDReaderView/
+Sources/RDEpubReaderView/
 ├── EPUBCore/                          # EPUB 解析与 WebView 渲染
 │   ├── Models/                        # 数据模型
 │   │   ├── RDEPUBAnnotationModels.swift
@@ -428,19 +428,19 @@ Sources/RDReaderView/
 │   ├── RDEPUBDTCoreTextRenderer.swift # DTCoreText 渲染器实现
 │   ├── RDEPUBChapterData.swift        # 章节查询门面
 │   ├── RDEPUBTextIndexTable.swift     # 全书索引表
-│   └── RDPlainTextBookBuilder.swift   # 纯文本 (.txt) 构建器
+│   └── RDEpubPlainTextBookBuilder.swift   # 纯文本 (.txt) 构建器
 │
 ├── ReaderView/                        # 通用翻页容器
 │   ├── Paging/                        # 翻页子系统
-│   │   ├── RDReaderPagingController.swift
-│   │   ├── RDReaderPreloadController.swift
-│   │   ├── RDReaderSpreadResolver.swift
-│   │   └── RDReaderTapRegionHandler.swift
-│   ├── RDReaderView.swift             # 主容器视图
-│   ├── RDReaderView+*.swift           # 扩展（CollectionView/PageCurl/ToolView/ContentAccess）
-│   ├── RDReaderFlowLayout.swift       # 自定义 CollectionView 布局
-│   ├── RDReaderContentCell.swift      # 滚动模式 Cell
-│   └── RDReaderPageChildViewController.swift  // 翻页模式子 VC
+│   │   ├── RDEpubReaderPagingController.swift
+│   │   ├── RDEpubReaderPreloadController.swift
+│   │   ├── RDEpubReaderSpreadResolver.swift
+│   │   └── RDEpubReaderTapRegionHandler.swift
+│   ├── RDEpubReaderView.swift             # 主容器视图
+│   ├── RDEpubReaderView+*.swift           # 扩展（CollectionView/PageCurl/ToolView/ContentAccess）
+│   ├── RDEpubReaderFlowLayout.swift       # 自定义 CollectionView 布局
+│   ├── RDEpubReaderContentCell.swift      # 滚动模式 Cell
+│   └── RDEpubReaderPageChildViewController.swift  // 翻页模式子 VC
 │
 └── EPUBUI/                            # 阅读器 UI
     ├── ReaderController/              # 控制器与协调器
@@ -494,7 +494,7 @@ Sources/RDReaderView/
 | **Builder** | `RDEPUBBookPageMap.Builder` 增量构建页码映射 |
 | **Strategy** | `RDEPUBTextRenderer` 协议，可替换渲染器实现 |
 | **Pipeline** | `RDEPUBTextTypesetterPipeline` 排版管线（8 个逻辑阶段，封装为 5-6 个顶层调用） |
-| **Adapter** | `RDReaderLegacyDataSourceAdapter` 适配旧数据源协议 |
+| **Adapter** | `RDEpubReaderLegacyDataSourceAdapter` 适配旧数据源协议 |
 | **三级缓存** | 内存 → 磁盘摘要 → 全书分页，逐级降级 |
 | **Token 取消** | `paginationToken` 确保过期异步任务不干扰新任务 |
 | **Frozen Parameters** | 后台任务冻结 `renderSignature`，避免运行中参数漂移 |

Doc/AUDIT_FINAL.md

@@ -1,6 +1,6 @@
 # ReadViewSDK 代码审查报告
 
-> 审查范围：`Sources/RDReaderView/` 全部 184 个 Swift 文件（约 32,300 行）
+> 审查范围：`Sources/RDEpubReaderView/` 全部 184 个 Swift 文件（约 32,300 行）
 > 审查维度：并发安全、内存管理、API 正确性、Swift/iOS 平台特定、架构与依赖
 > 审查日期：2026-06-26
 
@@ -134,7 +134,7 @@ let stillChanged = abs(currentSize.width - self.lastTextPaginationPageSize!.widt
 
 ### H-10 · 依赖版本未锁定
 
-`RDReaderView.podspec` 中 DTCoreText、SnapKit、SSAlertSwift 无版本约束：
+`RDEpubReaderView.podspec` 中 DTCoreText、SnapKit、SSAlertSwift 无版本约束：
 
 ```ruby
 s.dependency 'ZIPFoundation', '~> 0.9'   # ✅ 已锁定
@@ -143,7 +143,7 @@ s.dependency 'SnapKit'                    # ❌ 无约束
 s.dependency 'SSAlertSwift'               # ❌ 无约束
 ```
 
-**位置：** `RDReaderView.podspec:17-20`
+**位置：** `RDEpubReaderView.podspec:17-20`
 
 ---
 

Doc/BUSINESS_LOGIC.md

@@ -298,14 +298,14 @@ return builder.build()
 
 **触发条件：** `landscapeDualPageEnabled && isLandscape && !verticalScroll`
 
-**页面配对逻辑（RDReaderSpreadResolver）：**
+**页面配对逻辑（RDEpubReaderSpreadResolver）：**
 
 - 有封面页：封面独占一屏，后续页面两两配对
   - 配对规则：`(coverIndex, nil)`, `(1, 2)`, `(3, 4)`, ...
 - 无封面页：标准偶奇配对
   - 配对规则：`(0, 1)`, `(2, 3)`, `(4, 5)`, ...
 
-**封面感知布局（RDReaderFlowLayout）：**
+**封面感知布局（RDEpubReaderFlowLayout）：**
 
 ```
 封面页: [====全屏宽度====]
@@ -314,7 +314,7 @@ return builder.build()
 
 ### 5.3 页面预加载
 
-`RDReaderPreloadController` 管理两个缓存：
+`RDEpubReaderPreloadController` 管理两个缓存：
 - `preloadedPageViews` - 预渲染的页面视图
 - `pageCurlCachedViews` - 当前显示的页面视图
 
@@ -580,7 +580,7 @@ protocol RDEPUBReaderPersistence {
 
 ## 9. 纯文本 (.txt) 支持
 
-`RDPlainTextBookBuilder` 复用 EPUB 渲染管线处理 .txt 文件：
+`RDEpubPlainTextBookBuilder` 复用 EPUB 渲染管线处理 .txt 文件：
 
 1. **解码：** 依次尝试 UTF-8 → GB18030 → GBK
 2. **分章：** 正则匹配 `^(第[零一二三四五六七八九十百千万\d]+[章节回卷].*)$`

Doc/CFI_SUBSYSTEM.md

@@ -34,7 +34,7 @@ epubcfi(/6/4!ch01.xhtml/4/2/1:3)
 
 顶层 CFI 模型，对应一个完整的 `epubcfi(...)` 字符串。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFI.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFI.swift`
 
 ```swift
 public struct RDEPUBCFI: Codable, Equatable, Hashable {
@@ -66,7 +66,7 @@ public enum RDEPUBCFISideBias: String, Codable {
 
 路径模型，由一组 `RDEPUBCFIStep` 组成，描述从根节点到目标节点的遍历序列。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIPath.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIPath.swift`
 
 ```swift
 public struct RDEPUBCFIPath: Codable, Equatable, Hashable {
@@ -95,7 +95,7 @@ public struct RDEPUBCFIStep: Codable, Equatable, Hashable {
 
 范围模型，表示文档中的一个连续区域，由父级 CFI 和起止 CFI 组成。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIRange.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIRange.swift`
 
 ```swift
 public struct RDEPUBCFIRange: Codable, Equatable, Hashable {
@@ -116,7 +116,7 @@ public struct RDEPUBCFIRange: Codable, Equatable, Hashable {
 
 将 CFI 字符串解析为结构化模型。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIParser.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIParser.swift`
 
 ```swift
 public enum RDEPUBCFIParser {
@@ -154,7 +154,7 @@ print(cfi.textAssertion?.exact)      // Optional("目标文本")
 
 将 CFI 模型序列化为标准字符串。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFISerializer.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFISerializer.swift`
 
 ```swift
 public enum RDEPUBCFISerializer {
@@ -192,7 +192,7 @@ let serialized = RDEPUBCFISerializer.serialize(cfi)
 
 将 CFI 解析为可直接用于资源定位的结果。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIResolver.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIResolver.swift`
 
 ```swift
 public struct RDEPUBCFIResolverResult: Equatable {
@@ -228,7 +228,7 @@ print(result.chapterOffset)  // Optional(80)
 
 从已知的章节信息生成 CFI。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIGenerator.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIGenerator.swift`
 
 ```swift
 public enum RDEPUBCFIGenerator {
@@ -274,7 +274,7 @@ public enum RDEPUBCFIGenerator {
 
 从 HTML 源码中提取带有 `id` 属性的元素路径映射。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIDOMPathBuilder.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIDOMPathBuilder.swift`
 
 ```swift
 public enum RDEPUBCFIDOMPathBuilder {
@@ -296,7 +296,7 @@ public enum RDEPUBCFIDOMPathBuilder {
 
 当 CFI 精确定位失败时（如 DOM 结构变更），恢复引擎通过多级降级策略尝试找到最佳匹配位置。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIRecoveryEngine.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIRecoveryEngine.swift`
 
 ### 5.1 恢复置信度
 
@@ -361,7 +361,7 @@ let result = RDEPUBCFIRecoveryEngine.recover(
 
 文本断言用于在 CFI 定位后验证所指位置的文本内容是否符合预期，增强定位鲁棒性。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFITextAssertion.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFITextAssertion.swift`
 
 ```swift
 public struct RDEPUBCFITextAssertion: Codable, Equatable, Hashable {
@@ -393,7 +393,7 @@ print(assertion?.suffix) // Optional("后续内容")
 
 提供宽松解析接口，兼容非标准 CFI 格式。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFICompatibility.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFICompatibility.swift`
 
 ```swift
 public enum RDEPUBCFICompatibility {
@@ -418,7 +418,7 @@ public enum RDEPUBCFICompatibility {
 
 CFI 映射是章节级别的索引结构，将 CFI 路径映射到章节文本偏移量，是容错恢复引擎的核心数据源。
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIMap.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIMap.swift`
 
 ### 8.1 RDEPUBCFIMap
 
@@ -506,7 +506,7 @@ public struct RDEPUBCFITokenAnchor: Codable, Equatable {
 
 ## 9. 错误类型（RDEPUBCFIError）
 
-**文件**：`Sources/RDReaderView/EPUBCore/CFI/RDEPUBCFIError.swift`
+**文件**：`Sources/RDEpubReaderView/EPUBCore/CFI/RDEPUBCFIError.swift`
 
 ```swift
 public enum RDEPUBCFIError: Error, Equatable {

Doc/CHAPTER_RUNTIME.md

@@ -16,8 +16,8 @@
 - 渐进补全：后台逐步补全所有章节的页码信息
 
 **关键文件**：
-- `Sources/RDReaderView/EPUBUI/ReaderController/ChapterRuntime/` 目录
-- `Sources/RDReaderView/EPUBUI/ReaderController/RDEPUBReaderPaginationCoordinator.swift`
+- `Sources/RDEpubReaderView/EPUBUI/ReaderController/ChapterRuntime/` 目录
+- `Sources/RDEpubReaderView/EPUBUI/ReaderController/RDEPUBReaderPaginationCoordinator.swift`
 
 ---
 

Doc/CONCERNS.md

@@ -105,15 +105,15 @@
 ## Evidence（仓库路径）
 
 - Build flags：`Podfile`
-- Pod metadata/toolchain：`RDReaderView.podspec`
-- Archive extraction：`Sources/RDReaderView/EPUBCore/RDEPUBParser+Archive.swift`
-- Resource path validation（post-extraction）：`Sources/RDReaderView/EPUBCore/RDEPUBParser+Resources.swift`
-- Scheme handler reads full file bytes：`Sources/RDReaderView/EPUBCore/RDEPUBResourceURLSchemeHandler.swift`
-- WebView bridge + message handling：`Sources/RDReaderView/EPUBCore/RDEPUBWebView+JavaScriptBridge.swift`
-- External link opening：`Sources/RDReaderView/EPUBUI/RDEPUBReaderController.swift`
-- UserDefaults persistence implementation：`Sources/RDReaderView/EPUBUI/RDEPUBReaderPersistence.swift`
-- Hidden paginator web view：`Sources/RDReaderView/EPUBCore/RDEPUBPaginator.swift`
-- Debug logging：`Sources/RDReaderView/EPUBCore/RDEPUBWebViewDebug.swift`
+- Pod metadata/toolchain：`RDEpubReaderView.podspec`
+- Archive extraction：`Sources/RDEpubReaderView/EPUBCore/RDEPUBParser+Archive.swift`
+- Resource path validation（post-extraction）：`Sources/RDEpubReaderView/EPUBCore/RDEPUBParser+Resources.swift`
+- Scheme handler reads full file bytes：`Sources/RDEpubReaderView/EPUBCore/RDEPUBResourceURLSchemeHandler.swift`
+- WebView bridge + message handling：`Sources/RDEpubReaderView/EPUBCore/RDEPUBWebView+JavaScriptBridge.swift`
+- External link opening：`Sources/RDEpubReaderView/EPUBUI/RDEPUBReaderController.swift`
+- UserDefaults persistence implementation：`Sources/RDEpubReaderView/EPUBUI/RDEPUBReaderPersistence.swift`
+- Hidden paginator web view：`Sources/RDEpubReaderView/EPUBCore/RDEPUBPaginator.swift`
+- Debug logging：`Sources/RDEpubReaderView/EPUBCore/RDEPUBWebViewDebug.swift`
 - Vendored dependencies：`Pods/`、`ReadViewDemo/Pods/`
 
 ---

Doc/CONVENTIONS.md

@@ -6,43 +6,43 @@
 
 ## 语言与工程约束
 
-- **主要语言**：Swift（Podspec 声明 `s.swift_versions = ["5.10"]`，见 `RDReaderView.podspec`）
-- **最低系统版本**：Podspec `iOS 15.0`（`RDReaderView.podspec`），示例工程 Podfile/构建设置里常见为 `iOS 15.6`（`Podfile`）
+- **主要语言**：Swift（Podspec 声明 `s.swift_versions = ["5.10"]`，见 `RDEpubReaderView.podspec`）
+- **最低系统版本**：Podspec `iOS 15.0`（`RDEpubReaderView.podspec`），示例工程 Podfile/构建设置里常见为 `iOS 15.6`（`Podfile`）
 - **依赖管理**：CocoaPods（`Podfile`、`ReadViewDemo/Podfile`、`Podfile.lock`）
 
 ## 命名约定
 
 **文件/类型命名（Swift）：**
-- 以类型名为文件名的单文件组织较常见：`Sources/RDReaderView/EPUBCore/RDEPUBParser.swift`
+- 以类型名为文件名的单文件组织较常见：`Sources/RDEpubReaderView/EPUBCore/RDEPUBParser.swift`
 - 大量使用前缀区分模块域：
-  - `RD...`：阅读器 UI/控制器相关（如 `Sources/RDReaderView/RDReaderView.swift`、`Sources/RDReaderView/RDURLReaderController.swift`）
-  - `RDEPUB...`：EPUB Core/UI/渲染相关（如 `Sources/RDReaderView/EPUBCore/RDEPUBModels.swift`）
-- Extension 文件使用 `+` 命名：`Sources/RDReaderView/EPUBUI/RDEPUBReaderController+ContentDelegates.swift`
+  - `RD...`：阅读器 UI/控制器相关（如 `Sources/RDEpubReaderView/RDEpubReaderView.swift`、`Sources/RDEpubReaderView/RDEpubURLReaderController.swift`）
+  - `RDEPUB...`：EPUB Core/UI/渲染相关（如 `Sources/RDEpubReaderView/EPUBCore/RDEPUBModels.swift`）
+- Extension 文件使用 `+` 命名：`Sources/RDEpubReaderView/EPUBUI/RDEPUBReaderController+ContentDelegates.swift`
 
 **变量/函数命名：**
-- 基本遵循 Swift lowerCamelCase：`parse(epubURL:)`（`Sources/RDReaderView/EPUBCore/RDEPUBParser.swift`）
-- 常量多用 `static let`：`kRDEPUBHighlightAttributeName`（`Sources/RDReaderView/EPUBCore/Models/RDEPUBAnnotationModels.swift`）
+- 基本遵循 Swift lowerCamelCase：`parse(epubURL:)`（`Sources/RDEpubReaderView/EPUBCore/RDEPUBParser.swift`）
+- 常量多用 `static let`：`kRDEPUBHighlightAttributeName`（`Sources/RDEpubReaderView/EPUBCore/Models/RDEPUBAnnotationModels.swift`）
 
 ## 代码风格与排版（从现有代码归纳）
 
 **缩进与换行：**
-- 多数文件使用 4 空格缩进（示例：`ReadViewDemo/ReadViewDemo/ViewController.swift`、`Sources/RDReaderView/EPUBCore/RDEPUBModels.swift`）
+- 多数文件使用 4 空格缩进（示例：`ReadViewDemo/ReadViewDemo/ViewController.swift`、`Sources/RDEpubReaderView/EPUBCore/RDEPUBModels.swift`）
 - 历史代码中更常见”强制换行/多行括号”风格
 
 **空行与分组：**
 - UI 相关文件常用空行分隔属性/初始化/布局段落
-- `// MARK:` 用于分区组织（示例：`Sources/RDReaderView/RDReaderGestureController.swift`、`Sources/RDReaderView/EPUBTextRendering/RDPlainTextBookBuilder.swift`）
+- `// MARK:` 用于分区组织（示例：`Sources/RDEpubReaderView/RDEpubReaderGestureController.swift`、`Sources/RDEpubReaderView/EPUBTextRendering/RDEpubPlainTextBookBuilder.swift`）
 
 **类型组织：**
 - 偏好用 `extension` 拆分职责/协议实现（示例：`ReadViewDemo/ReadViewDemo/ViewController.swift` 的 `UITableViewDataSource/Delegate`）
-- API 暴露处使用 `public`、`public final class`、`public enum/struct`（示例：`Sources/RDReaderView/EPUBCore/RDEPUBModels.swift`）
-- “对外只读、内部可写”常用 `public internal(set)`（示例：`Sources/RDReaderView/EPUBCore/RDEPUBParser.swift`）
+- API 暴露处使用 `public`、`public final class`、`public enum/struct`（示例：`Sources/RDEpubReaderView/EPUBCore/RDEPUBModels.swift`）
+- “对外只读、内部可写”常用 `public internal(set)`（示例：`Sources/RDEpubReaderView/EPUBCore/RDEPUBParser.swift`）
 
 ## 导入与依赖使用
 
 **import：**
 - UIKit/UI 文件：`import UIKit`（大量文件）
-- Core/模型文件：`import Foundation`（如 `Sources/RDReaderView/EPUBCore/RDEPUBModels.swift`）
+- Core/模型文件：`import Foundation`（如 `Sources/RDEpubReaderView/EPUBCore/RDEPUBModels.swift`）
 - 三方依赖按需引入：
   - `SnapKit`：布局
   - `SSAlertSwift`：弹窗/提示
@@ -52,15 +52,15 @@
 
 ## 错误处理与日志
 
-- Core 解析层倾向用 `throws` + 自定义 `Error`（示例：`Sources/RDReaderView/EPUBCore/RDEPUBParser.swift`、`Sources/RDReaderView/EPUBCore/RDEPUBModels.swift` 的 `RDEPUBParserError`）
+- Core 解析层倾向用 `throws` + 自定义 `Error`（示例：`Sources/RDEpubReaderView/EPUBCore/RDEPUBParser.swift`、`Sources/RDEpubReaderView/EPUBCore/RDEPUBModels.swift` 的 `RDEPUBParserError`）
 - UI/控制器层常见 `guard` 早返回（示例：`ReadViewDemo/ReadViewDemo/ViewController.swift`）
 - 未检测到统一日志框架（未发现专用 logging package/config）；出现时以系统 API/局部输出为主（需按具体文件核对）。
 
 ## 注释与文档
 
 - **项目规则（强约束）**：代码标识符保持英文，但**代码注释/文档/提交信息使用中文**（见 `CONTEXT.md`）。
-- 历史文件常带 Xcode 头部注释块（示例：`Sources/RDReaderView/ReaderView/RDReaderView.swift`）。
-- 公共 API 处存在少量三斜线文档注释（示例：`Sources/RDReaderView/RDReaderView.swift` 的中文说明）。
+- 历史文件常带 Xcode 头部注释块（示例：`Sources/RDEpubReaderView/ReaderView/RDEpubReaderView.swift`）。
+- 公共 API 处存在少量三斜线文档注释（示例：`Sources/RDEpubReaderView/RDEpubReaderView.swift` 的中文说明）。
 
 ## Lint / Formatter / 静态检查
 
@@ -77,9 +77,9 @@
 
 - `CONTEXT.md`
 - `Podfile`
-- `RDReaderView.podspec`
+- `RDEpubReaderView.podspec`
 - `ReadViewDemo/ReadViewDemo/ViewController.swift`
-- `Sources/RDReaderView/ReaderView/RDReaderView.swift`
-- `Sources/RDReaderView/EPUBCore/RDEPUBParser.swift`
-- `Sources/RDReaderView/EPUBCore/RDEPUBModels.swift`
-- `Sources/RDReaderView/EPUBUI/RDEPUBReaderController.swift`
+- `Sources/RDEpubReaderView/ReaderView/RDEpubReaderView.swift`
+- `Sources/RDEpubReaderView/EPUBCore/RDEPUBParser.swift`
+- `Sources/RDEpubReaderView/EPUBCore/RDEPUBModels.swift`
+- `Sources/RDEpubReaderView/EPUBUI/RDEPUBReaderController.swift`

Doc/EPUBTextRendering_CODE_REFERENCE.md

@@ -471,7 +471,7 @@ final class RDEPUBTextSearchEngine: RDEPUBSearchEngine {
 
 ## 9. 纯文本构建器
 
-**文件：** `RDPlainTextBookBuilder.swift`
+**文件：** `RDEpubPlainTextBookBuilder.swift`
 
 从纯文本（.txt）文件构建 `RDEPUBTextBook`，用于支持 TXT 格式阅读。
 

Doc/EPUBUI_CODE_REFERENCE.md

@@ -48,7 +48,7 @@ public final class RDEPUBReaderController: UIViewController {
     let epubURL: URL                                     // EPUB 文件路径
     let persistence: RDEPUBReaderPersistence?            // 持久化代理
     let dependencies: RDEPUBReaderDependencies           // 依赖注入
-    let readerView = RDReaderView()                      // 翻页容器
+    let readerView = RDEpubReaderView()                      // 翻页容器
 }
 ```
 
@@ -57,7 +57,7 @@ public final class RDEPUBReaderController: UIViewController {
 | 文件 | 职责 |
 |------|------|
 | `RDEPUBReaderController+PublicAPI.swift` | 公开 API（跳转、搜索、标注、书签） |
-| `RDEPUBReaderController+DataSource.swift` | `RDReaderPageProvider` 实现 |
+| `RDEPUBReaderController+DataSource.swift` | `RDEpubReaderPageProvider` 实现 |
 | `RDEPUBReaderController+ContentDelegates.swift` | WebView/TextContentView 代理路由 |
 | `RDEPUBReaderController+LocationResolution.swift` | 页码/位置解析、阅读状态同步 |
 | `RDEPUBReaderController+ExternalLinks.swift` | 外部链接处理（白名单、确认弹窗） |
@@ -120,7 +120,7 @@ public protocol RDEPUBReaderPersistence: AnyObject {
 ```swift
 final class RDEPUBReaderContext {
     weak var controller: RDEPUBReaderController?
-    weak var readerView: RDReaderView?
+    weak var readerView: RDEpubReaderView?
     var dependencies: RDEPUBReaderDependencies
     var runtime: RDEPUBReaderRuntime?
 
@@ -155,7 +155,7 @@ public struct RDEPUBReaderDependencies {
     public var makeParser: () -> RDEPUBParser
     public var makePaginator: () -> RDEPUBPaginator
     public var makeTextBookBuilder: (RDEPUBTextRenderer, RDEPUBTextBookCache?, RDEPUBTextLayoutConfig) -> RDEPUBTextBookBuilder
-    public var makePlainTextBookBuilder: (RDEPUBTextRenderer, RDEPUBTextLayoutConfig) -> RDPlainTextBookBuilder
+    public var makePlainTextBookBuilder: (RDEPUBTextRenderer, RDEPUBTextLayoutConfig) -> RDEpubPlainTextBookBuilder
     public var makeTextRenderer: (RDEPUBTextRenderingEngine) -> RDEPUBTextRenderer
 
     public static var live: RDEPUBReaderDependencies  // 默认实现
@@ -659,9 +659,9 @@ struct RDEPUBReaderUIState {
 
 页图协调器（按需分页与全量分页的结果合并）。
 
-### 10.6 RDURLReaderController
+### 10.6 RDEpubURLReaderController
 
-**文件：** `RDURLReaderController.swift`
+**文件：** `RDEpubURLReaderController.swift`
 
 URL 阅读器控制器（用于打开单个 URL）。
 
@@ -715,12 +715,12 @@ RDEPUBReaderRuntime.applyParsedPublication()
     │
     ├── RDEPUBBookPageMap 生成
     │
-    └── RDReaderView.transitionToPage() → 显示页面
+    └── RDEpubReaderView.transitionToPage() → 显示页面
 
 用户翻页
     │
     ▼
-RDReaderView.currentPage 变化
+RDEpubReaderView.currentPage 变化
     │
     ├── RDEPUBReaderLocationCoordinator.recordPageChangeIfNeeded()
     │   └── persistence.saveLocation()

Doc/LONG_CHAPTER_MEMORY_OPTIMIZATION_PLAN.md

@@ -14,9 +14,9 @@
 
 生成点：
 
-- `Sources/RDReaderView/EPUBUI/ReaderController/ChapterRuntime/RDEPUBChapterLoader.swift:494`（`buildPagesFromRanges`）
-- `Sources/RDReaderView/EPUBTextRendering/BuildPipeline/RDEPUBTextBookBuilder.swift:294`
-- `Sources/RDReaderView/EPUBTextRendering/RDPlainTextBookBuilder.swift:78`
+- `Sources/RDEpubReaderView/EPUBUI/ReaderController/ChapterRuntime/RDEPUBChapterLoader.swift:494`（`buildPagesFromRanges`）
+- `Sources/RDEpubReaderView/EPUBTextRendering/BuildPipeline/RDEPUBTextBookBuilder.swift:294`
+- `Sources/RDEpubReaderView/EPUBTextRendering/RDEpubPlainTextBookBuilder.swift:78`
 
 现存全部消费点（已盘点确认，仅 3 处）：
 
@@ -27,7 +27,7 @@
 **任务**：
 
 - [x] 将 `RDEPUBTextPage.content` 改为按需构造：已改为基于 `chapterContent` + `contentRange` 的计算属性（带范围钳制），公开读取 API 不变
-- [x] 三个构造点（`RDEPUBChapterLoader` / `RDEPUBTextBookBuilder` / `RDPlainTextBookBuilder`）不再生成每页子串；消费点经计算属性透明按需构造
+- [x] 三个构造点（`RDEPUBChapterLoader` / `RDEPUBTextBookBuilder` / `RDEpubPlainTextBookBuilder`）不再生成每页子串；消费点经计算属性透明按需构造
 - [x] `Equatable` 确认：`content` 为派生值，由 `contentRange` + `chapterContent` 判等覆盖，语义不变
 
 **API 兼容性注意**：
@@ -47,7 +47,7 @@
 ### P0-3 保持现有缓存限制，防止错误复用
 
 - [x] `shouldAvoidReaderPageCaching`（`RDEPUBTextContentView.swift:319`）保持现状，已补注释说明放开的前置条件是 P1-1 落地
-- [x] 本阶段未改 `RDReaderPreloadController` 行为
+- [x] 本阶段未改 `RDEpubReaderPreloadController` 行为
 
 ---
 
@@ -101,7 +101,7 @@
 
 前置：P1-1～P1-3 全部落地后，页面视图不再持有整章副本。
 
-- [ ] 调整 `shouldAvoidReaderPageCaching` 判定，允许轻量化后的文本页进入 `RDReaderPreloadController` 缓存
+- [ ] 调整 `shouldAvoidReaderPageCaching` 判定，允许轻量化后的文本页进入 `RDEpubReaderPreloadController` 缓存
 - [ ] 对比放开前后的翻页流畅度与峰值内存，数据不佳则回退此项
 
 ---

Doc/ReaderView_CODE_REFERENCE.md

@@ -6,54 +6,54 @@
 
 ## 1. 模块概述
 
-`ReaderView` 是 ReadViewSDK 的**通用翻页容器层**，位于 EPUBUI 层之下。它提供与 EPUB 内容无关的页面展示、翻页动画、手势识别、页面预加载和双页布局能力。上层通过 `RDReaderPageProvider` 协议提供页面内容视图，ReaderView 负责容器管理和翻页调度。
+`ReaderView` 是 ReadViewSDK 的**通用翻页容器层**，位于 EPUBUI 层之下。它提供与 EPUB 内容无关的页面展示、翻页动画、手势识别、页面预加载和双页布局能力。上层通过 `RDEpubReaderPageProvider` 协议提供页面内容视图，ReaderView 负责容器管理和翻页调度。
 
 **文件清单（14 个 Swift 文件）：**
 
 | 文件 | 核心类型 | 职责 |
 |------|----------|------|
-| `RDReaderView.swift` | `RDReaderView` | 主容器视图，协调所有子组件 |
-| `RDReaderViewProtocols.swift` | 协议 + 枚举 | 数据源、代理、导航协议定义 |
-| `RDReaderFlowLayout.swift` | `RDReaderFlowLayout` | UICollectionView 自定义布局 |
-| `RDReaderGestureController.swift` | `RDReaderGestureController` | 手势控制器（预留） |
-| `RDReaderContentCell.swift` | `RDReaderContentCell` | CollectionView 内容 Cell |
-| `RDReaderPageChildViewController.swift` | `RDReaderPageChildViewController` | PageCurl 模式子 VC |
-| `RDReaderView+PageCurl.swift` | Extension | UIPageViewController 数据源/代理 |
-| `RDReaderView+CollectionView.swift` | Extension | UICollectionView 数据源/布局代理 |
-| `RDReaderView+ContentAccess.swift` | Extension | 内容视图访问与复用 |
-| `RDReaderView+ToolView.swift` | Extension | 工具栏安装与动画 |
-| `Paging/RDReaderPagingController.swift` | `RDReaderPagingController` | 翻页状态机 |
-| `Paging/RDReaderPreloadController.swift` | `RDReaderPreloadController` | 页面预加载与缓存 |
-| `Paging/RDReaderSpreadResolver.swift` | `RDReaderSpreadResolver` | 双页展开计算 |
-| `Paging/RDReaderTapRegionHandler.swift` | `RDReaderTapRegionHandler` | 点击区域判定 |
+| `RDEpubReaderView.swift` | `RDEpubReaderView` | 主容器视图，协调所有子组件 |
+| `RDEpubReaderViewProtocols.swift` | 协议 + 枚举 | 数据源、代理、导航协议定义 |
+| `RDEpubReaderFlowLayout.swift` | `RDEpubReaderFlowLayout` | UICollectionView 自定义布局 |
+| `RDEpubReaderGestureController.swift` | `RDEpubReaderGestureController` | 手势控制器（预留） |
+| `RDEpubReaderContentCell.swift` | `RDEpubReaderContentCell` | CollectionView 内容 Cell |
+| `RDEpubReaderPageChildViewController.swift` | `RDEpubReaderPageChildViewController` | PageCurl 模式子 VC |
+| `RDEpubReaderView+PageCurl.swift` | Extension | UIPageViewController 数据源/代理 |
+| `RDEpubReaderView+CollectionView.swift` | Extension | UICollectionView 数据源/布局代理 |
+| `RDEpubReaderView+ContentAccess.swift` | Extension | 内容视图访问与复用 |
+| `RDEpubReaderView+ToolView.swift` | Extension | 工具栏安装与动画 |
+| `Paging/RDEpubReaderPagingController.swift` | `RDEpubReaderPagingController` | 翻页状态机 |
+| `Paging/RDEpubReaderPreloadController.swift` | `RDEpubReaderPreloadController` | 页面预加载与缓存 |
+| `Paging/RDEpubReaderSpreadResolver.swift` | `RDEpubReaderSpreadResolver` | 双页展开计算 |
+| `Paging/RDEpubReaderTapRegionHandler.swift` | `RDEpubReaderTapRegionHandler` | 点击区域判定 |
 
 ---
 
-## 2. 协议定义（RDReaderViewProtocols.swift）
+## 2. 协议定义（RDEpubReaderViewProtocols.swift）
 
-### 2.1 RDReaderDataSource（旧版数据源，已废弃）
+### 2.1 RDEpubReaderDataSource（旧版数据源，已废弃）
 
 ```swift
-@objc public protocol RDReaderDataSource: NSObjectProtocol {
-    func pageCountOfReaderView(readerView: RDReaderView) -> Int
-    func pageContentView(readerView: RDReaderView, pageNum: Int, containerView: UIView?) -> UIView
-    func pageIdentifier(readerView: RDReaderView, pageNum: Int) -> String?
-    @objc optional func topToolView(readerView: RDReaderView) -> UIView?
-    @objc optional func bottomToolView(readerView: RDReaderView) -> UIView?
+@objc public protocol RDEpubReaderDataSource: NSObjectProtocol {
+    func pageCountOfReaderView(readerView: RDEpubReaderView) -> Int
+    func pageContentView(readerView: RDEpubReaderView, pageNum: Int, containerView: UIView?) -> UIView
+    func pageIdentifier(readerView: RDEpubReaderView, pageNum: Int) -> String?
+    @objc optional func topToolView(readerView: RDEpubReaderView) -> UIView?
+    @objc optional func bottomToolView(readerView: RDEpubReaderView) -> UIView?
 }
 ```
 
-> 向后兼容保留，新代码应使用 `RDReaderPageProvider`。
+> 向后兼容保留，新代码应使用 `RDEpubReaderPageProvider`。
 
-### 2.2 RDReaderPageProvider（推荐数据源）
+### 2.2 RDEpubReaderPageProvider（推荐数据源）
 
 ```swift
-@objc public protocol RDReaderPageProvider: NSObjectProtocol {
-    func numberOfPages(in readerView: RDReaderView) -> Int
-    func readerView(_ readerView: RDReaderView, viewForPageAt index: Int, reusableView: UIView?) -> UIView
-    @objc optional func pageIdentifier(in readerView: RDReaderView, index: Int) -> String?
-    @objc optional func readerViewTopChrome(_ readerView: RDReaderView) -> UIView?
-    @objc optional func readerViewBottomChrome(_ readerView: RDReaderView) -> UIView?
+@objc public protocol RDEpubReaderPageProvider: NSObjectProtocol {
+    func numberOfPages(in readerView: RDEpubReaderView) -> Int
+    func readerView(_ readerView: RDEpubReaderView, viewForPageAt index: Int, reusableView: UIView?) -> UIView
+    @objc optional func pageIdentifier(in readerView: RDEpubReaderView, index: Int) -> String?
+    @objc optional func readerViewTopChrome(_ readerView: RDEpubReaderView) -> UIView?
+    @objc optional func readerViewBottomChrome(_ readerView: RDEpubReaderView) -> UIView?
 }
 ```
 
@@ -65,31 +65,31 @@
 | `readerViewTopChrome(_:)` | 返回顶部工具栏视图 |
 | `readerViewBottomChrome(_:)` | 返回底部工具栏视图 |
 
-### 2.3 RDReaderDelegate
+### 2.3 RDEpubReaderDelegate
 
 ```swift
-@objc public protocol RDReaderDelegate: NSObjectProtocol {
-    func pageNum(readerView: RDReaderView, pageNum: Int)
-    @objc optional func readerViewOrientationWillChange(readerView: RDReaderView, isLandscape: Bool)
+@objc public protocol RDEpubReaderDelegate: NSObjectProtocol {
+    func pageNum(readerView: RDEpubReaderView, pageNum: Int)
+    @objc optional func readerViewOrientationWillChange(readerView: RDEpubReaderView, isLandscape: Bool)
 }
 ```
 
-### 2.4 RDReaderPageNavigating
+### 2.4 RDEpubReaderPageNavigating
 
 ```swift
-public protocol RDReaderPageNavigating: AnyObject {
+public protocol RDEpubReaderPageNavigating: AnyObject {
     var currentPage: Int { get }
     func reloadPages()
     func transition(to page: Int, animated: Bool)
 }
 ```
 
-`RDReaderView` 遵循此协议，提供统一的页面导航接口。
+`RDEpubReaderView` 遵循此协议，提供统一的页面导航接口。
 
 ### 2.5 枚举类型
 
 ```swift
-extension RDReaderView {
+extension RDEpubReaderView {
     public enum DisplayType {
         case pageCurl          // 仿真翻页（UIPageViewController）
         case horizontalScroll  // 水平滑动（UICollectionView）
@@ -105,13 +105,13 @@ extension RDReaderView {
 
 ---
 
-## 3. 核心类：RDReaderView
+## 3. 核心类：RDEpubReaderView
 
-**文件：** `RDReaderView.swift`
+**文件：** `RDEpubReaderView.swift`
 
-`RDReaderView` 是一个 `UIView` 子类，作为翻页容器的主入口。内部管理两种翻页引擎：
+`RDEpubReaderView` 是一个 `UIView` 子类，作为翻页容器的主入口。内部管理两种翻页引擎：
 - **PageCurl 模式**：使用 `UIPageViewController` 实现仿真翻页
-- **Scroll 模式**：使用 `UICollectionView` + 自定义 `RDReaderFlowLayout` 实现滑动翻页
+- **Scroll 模式**：使用 `UICollectionView` + 自定义 `RDEpubReaderFlowLayout` 实现滑动翻页
 
 ### 3.1 关键属性
 
@@ -124,16 +124,16 @@ extension RDReaderView {
 | `coverPageIndex` | `Int?` | 封面页索引（独占一屏） |
 | `pagesPerScreen` | `Int` | 每屏页数（横屏双页时为 2） |
 | `preloadRadius` | `Int` | 预加载半径（默认 1） |
-| `dataSource` | `RDReaderDataSource?` | 旧版数据源 |
-| `pageProvider` | `RDReaderPageProvider?` | 推荐数据源 |
-| `delegate` | `RDReaderDelegate?` | 事件代理 |
+| `dataSource` | `RDEpubReaderDataSource?` | 旧版数据源 |
+| `pageProvider` | `RDEpubReaderPageProvider?` | 推荐数据源 |
+| `delegate` | `RDEpubReaderDelegate?` | 事件代理 |
 | `toolViewAnimationDuration` | `TimeInterval` | 工具栏动画时长（0.3s） |
 
 ### 3.2 关键方法
 
 ```swift
 /// 切换显示模式（pageCurl / horizontalScroll / verticalScroll）
-public func switchReaderDisplayType(_ displayType: RDReaderView.DisplayType)
+public func switchReaderDisplayType(_ displayType: RDEpubReaderView.DisplayType)
 
 /// 跳转到指定页
 public func transitionToPage(pageNum: Int, animated: Bool = false)
@@ -154,22 +154,22 @@ public func isFullScreenPage(_ pageNum: Int) -> Bool
 |------|------|------|
 | `pageViewController` | `UIPageViewController` | PageCurl 翻页引擎 |
 | `collectionView` | `UICollectionView` | Scroll 翻页引擎 |
-| `layout` | `RDReaderFlowLayout` | CollectionView 自定义布局 |
-| `spreadResolver` | `RDReaderSpreadResolver` | 双页配对计算 |
-| `tapRegionHandler` | `RDReaderTapRegionHandler` | 点击区域判定 |
-| `preloadController` | `RDReaderPreloadController` | 页面预加载与缓存 |
-| `pagingController` | `RDReaderPagingController` | 翻页状态管理 |
+| `layout` | `RDEpubReaderFlowLayout` | CollectionView 自定义布局 |
+| `spreadResolver` | `RDEpubReaderSpreadResolver` | 双页配对计算 |
+| `tapRegionHandler` | `RDEpubReaderTapRegionHandler` | 点击区域判定 |
+| `preloadController` | `RDEpubReaderPreloadController` | 页面预加载与缓存 |
+| `pagingController` | `RDEpubReaderPagingController` | 翻页状态管理 |
 
 ---
 
-## 4. 翻页状态机：RDReaderPagingController
+## 4. 翻页状态机：RDEpubReaderPagingController
 
-**文件：** `Paging/RDReaderPagingController.swift`
+**文件：** `Paging/RDEpubReaderPagingController.swift`
 
 管理 PageCurl 模式下的翻页请求队列，防止动画冲突。
 
 ```swift
-struct RDReaderPagingController {
+struct RDEpubReaderPagingController {
     struct PageTransitionRequest: Equatable {
         let pageNum: Int
         let animated: Bool
@@ -180,7 +180,7 @@ struct RDReaderPagingController {
     var didBuildUI: Bool                                   // UI 是否已构建
 
     /// 判断是否应排队请求（PageCurl 模式下动画中返回 true）
-    mutating func shouldQueuePageTransition(_ request: PageTransitionRequest, currentDisplayType: RDReaderView.DisplayType) -> Bool
+    mutating func shouldQueuePageTransition(_ request: PageTransitionRequest, currentDisplayType: RDEpubReaderView.DisplayType) -> Bool
 
     /// 完成翻页动画，返回待处理的请求
     mutating func finishPageCurlTransition() -> PageTransitionRequest?
@@ -192,9 +192,9 @@ struct RDReaderPagingController {
 
 ---
 
-## 5. 页面预加载：RDReaderPreloadController
+## 5. 页面预加载：RDEpubReaderPreloadController
 
-**文件：** `Paging/RDReaderPreloadController.swift`
+**文件：** `Paging/RDEpubReaderPreloadController.swift`
 
 负责在当前页周围预渲染页面视图，减少翻页时的白屏时间。
 
@@ -224,27 +224,27 @@ func invalidate(environment: Environment)
 
 ```swift
 struct Environment {
-    let displayType: RDReaderView.DisplayType
+    let displayType: RDEpubReaderView.DisplayType
     let isLandscape: Bool
     let pagesPerScreen: Int
     let boundsSize: CGSize
     let landscapeDualPageEnabled: Bool
     let coverPageIndex: Int?
     let totalPages: Int
-    let spreadResolver: RDReaderSpreadResolver
+    let spreadResolver: RDEpubReaderSpreadResolver
 }
 ```
 
 ---
 
-## 6. 双页展开计算：RDReaderSpreadResolver
+## 6. 双页展开计算：RDEpubReaderSpreadResolver
 
-**文件：** `Paging/RDReaderSpreadResolver.swift`
+**文件：** `Paging/RDEpubReaderSpreadResolver.swift`
 
 纯函数式结构体，负责双页模式下的页面配对和导航计算。
 
 ```swift
-struct RDReaderSpreadResolver {
+struct RDEpubReaderSpreadResolver {
     /// 判断是否为全屏页（封面页独占一屏）
     func isFullScreenPage(_ pageNum: Int, landscapeDualPageEnabled: Bool, isLandscape: Bool, coverPageIndex: Int?) -> Bool
 
@@ -265,15 +265,15 @@ struct RDReaderSpreadResolver {
 
 ---
 
-## 7. 点击区域判定：RDReaderTapRegionHandler
+## 7. 点击区域判定：RDEpubReaderTapRegionHandler
 
-**文件：** `Paging/RDReaderTapRegionHandler.swift`
+**文件：** `Paging/RDEpubReaderTapRegionHandler.swift`
 
 将屏幕三等分，判定点击属于左/中/右区域。
 
 ```swift
-struct RDReaderTapRegionHandler {
-    func resolveTapEvent(point: CGPoint, viewFrame: CGRect, isToolViewVisible: Bool) -> RDReaderView.TapEvent
+struct RDEpubReaderTapRegionHandler {
+    func resolveTapEvent(point: CGPoint, viewFrame: CGRect, isToolViewVisible: Bool) -> RDEpubReaderView.TapEvent
 }
 ```
 
@@ -284,9 +284,9 @@ struct RDReaderTapRegionHandler {
 
 ---
 
-## 8. 流式布局：RDReaderFlowLayout
+## 8. 流式布局：RDEpubReaderFlowLayout
 
-**文件：** `RDReaderFlowLayout.swift`
+**文件：** `RDEpubReaderFlowLayout.swift`
 
 `UICollectionViewFlowLayout` 子类，支持水平滚动和垂直滚动两种模式。
 
@@ -294,7 +294,7 @@ struct RDReaderTapRegionHandler {
 
 | 属性 | 类型 | 说明 |
 |------|------|------|
-| `displayType` | `RDReaderView.DisplayType` | 布局模式 |
+| `displayType` | `RDEpubReaderView.DisplayType` | 布局模式 |
 | `isLandscapeDualPage` | `Bool` | 是否横屏双页 |
 | `coverPageIndex` | `Int?` | 封面页索引 |
 | `pagesPerScreen` | `Int` | 每屏页数 |
@@ -302,12 +302,12 @@ struct RDReaderTapRegionHandler {
 ### 8.2 协议
 
 ```swift
-public protocol RDReaderFlowLayoutDataSoure: NSObjectProtocol {
-    func heigtOfVerticalScrollPage(flowLayout: RDReaderFlowLayout, pageIndex: Int) -> CGFloat?
+public protocol RDEpubReaderFlowLayoutDataSoure: NSObjectProtocol {
+    func heigtOfVerticalScrollPage(flowLayout: RDEpubReaderFlowLayout, pageIndex: Int) -> CGFloat?
 }
 
-@objc public protocol RDReaderFlowLayoutDelegate: NSObjectProtocol {
-    func pageNum(flowLayout: RDReaderFlowLayout, pageIndex: Int)
+@objc public protocol RDEpubReaderFlowLayoutDelegate: NSObjectProtocol {
+    func pageNum(flowLayout: RDEpubReaderFlowLayout, pageIndex: Int)
 }
 ```
 
@@ -324,28 +324,28 @@ func currentContentOffset(count: Int) -> CGPoint
 
 ---
 
-## 9. 内容 Cell：RDReaderContentCell
+## 9. 内容 Cell：RDEpubReaderContentCell
 
-**文件：** `RDReaderContentCell.swift`
+**文件：** `RDEpubReaderContentCell.swift`
 
 `UICollectionViewCell` 子类，用于 Scroll 模式下承载页面内容视图。
 
 ```swift
-class RDReaderContentCell: UICollectionViewCell {
+class RDEpubReaderContentCell: UICollectionViewCell {
     var containerView: UIView?  // 设置时自动添加到 contentView，移除旧视图
 }
 ```
 
 ---
 
-## 10. PageCurl 子控制器：RDReaderPageChildViewController
+## 10. PageCurl 子控制器：RDEpubReaderPageChildViewController
 
-**文件：** `RDReaderPageChildViewController.swift`
+**文件：** `RDEpubReaderPageChildViewController.swift`
 
 `UIViewController` 子类，作为 `UIPageViewController` 的页面 VC。
 
 ```swift
-class RDReaderPageChildViewController: UIViewController {
+class RDEpubReaderPageChildViewController: UIViewController {
     var contentView: UIView?  // 内容视图，设置时自动安装到容器
     var pageNum: Int          // 对应页码
 
@@ -357,7 +357,7 @@ class RDReaderPageChildViewController: UIViewController {
 
 ## 11. Extension 汇总
 
-### 11.1 RDReaderView+PageCurl
+### 11.1 RDEpubReaderView+PageCurl
 
 实现 `UIPageViewControllerDataSource` 和 `UIPageViewControllerDelegate`：
 
@@ -367,18 +367,18 @@ class RDReaderPageChildViewController: UIViewController {
 - `pageViewController(_:willTransitionTo:)` — 即将翻页时预加载
 
 **特殊页码：**
-- `RDReaderView.blankPageNum`（`Int.max`）— 双页模式下的空白页
-- `RDReaderView.blankEndPageNum`（`Int.max - 1`）— 末尾空白页
+- `RDEpubReaderView.blankPageNum`（`Int.max`）— 双页模式下的空白页
+- `RDEpubReaderView.blankEndPageNum`（`Int.max - 1`）— 末尾空白页
 
-### 11.2 RDReaderView+CollectionView
+### 11.2 RDEpubReaderView+CollectionView
 
-实现 `UICollectionViewDataSource`、`RDReaderFlowLayoutDelegate`、`RDReaderFlowLayoutDataSoure`：
+实现 `UICollectionViewDataSource`、`RDEpubReaderFlowLayoutDelegate`、`RDEpubReaderFlowLayoutDataSoure`：
 
 - `collectionView(_:cellForItemAt:)` — 复用预加载视图或创建新 Cell
 - `collectionView(_:numberOfItemsInSection:)` — 返回总页数
 - `pageNum(flowLayout:pageIndex:)` — 滚动时更新当前页码
 
-### 11.3 RDReaderView+ContentAccess
+### 11.3 RDEpubReaderView+ContentAccess
 
 提供内容视图的注册、复用和查询：
 
@@ -396,7 +396,7 @@ public func pageContentView(pageNum: Int) -> UIView?
 public func resolvedSinglePageSize(pageNum: Int? = nil) -> CGSize
 ```
 
-### 11.4 RDReaderView+ToolView
+### 11.4 RDEpubReaderView+ToolView
 
 管理顶部/底部工具栏的安装、显示/隐藏动画：
 
@@ -420,11 +420,11 @@ func updateToolViewHeightConstraintsIfNeeded()
 | 模式 | 应用 |
 |------|------|
 | **策略模式** | `DisplayType` 切换 PageCurl / Scroll 两种翻页策略 |
-| **适配器模式** | `RDReaderLegacyDataSourceAdapter` 将旧 `RDReaderDataSource` 适配为 `RDReaderPageProvider` |
-| **命令队列** | `RDReaderPagingController` 管理翻页请求队列 |
-| **缓存签名** | `RDReaderPreloadController.CacheSignature` 检测环境变化自动失效 |
+| **适配器模式** | `RDEpubReaderLegacyDataSourceAdapter` 将旧 `RDEpubReaderDataSource` 适配为 `RDEpubReaderPageProvider` |
+| **命令队列** | `RDEpubReaderPagingController` 管理翻页请求队列 |
+| **缓存签名** | `RDEpubReaderPreloadController.CacheSignature` 检测环境变化自动失效 |
 | **关注点分离** | Extension 将不同功能拆分到独立文件 |
-| **纯函数** | `RDReaderSpreadResolver` 和 `RDReaderTapRegionHandler` 无状态计算 |
+| **纯函数** | `RDEpubReaderSpreadResolver` 和 `RDEpubReaderTapRegionHandler` 无状态计算 |
 
 ---
 
@@ -434,7 +434,7 @@ func updateToolViewHeightConstraintsIfNeeded()
 用户点击屏幕
     │
     ▼
-RDReaderTapRegionHandler.resolveTapEvent()
+RDEpubReaderTapRegionHandler.resolveTapEvent()
     │
     ├── .left  → goPreviousPage() ──→ spreadResolver.nextPage(forward: false)
     ├── .right → goNextPage()     ──→ spreadResolver.nextPage(forward: true)

Doc/TESTING.md

@@ -116,7 +116,7 @@ xcodebuild test \
 建议同时记录以下观测项：
 
 - `prepareOnDemandChapter` 主线程 wall clock
-- `RDReaderPreloadController` 预加载命中率
+- `RDEpubReaderPreloadController` 预加载命中率
 - `bookPageMap` partial extension / full replacement 次数
 - 页面静态底图缓存命中率
 - CFI 延迟构建完成次数与耗时

Doc/TYPESetter_PIPELINE.md

@@ -16,7 +16,7 @@
 
 **输出**：`RDEPUBTypesettingOutput`（渲染请求、诊断信息、兼容性报告）
 
-**关键文件**：`Sources/RDReaderView/EPUBTextRendering/Typesetter/`
+**关键文件**：`Sources/RDEpubReaderView/EPUBTextRendering/Typesetter/`
 
 ---
 

Doc/UML_CLASS_DIAGRAMS.md

@@ -31,12 +31,12 @@ graph TB
         IndexTable[RDEPUBTextIndexTable]
     end
 
-    subgraph RDReaderView
-        ReaderView[RDReaderView]
-        FlowLayout[RDReaderFlowLayout]
-        Preload[RDReaderPreloadController]
-        Spread[RDReaderSpreadResolver]
-        TapRegion[RDReaderTapRegionHandler]
+    subgraph RDEpubReaderView
+        ReaderView[RDEpubReaderView]
+        FlowLayout[RDEpubReaderFlowLayout]
+        Preload[RDEpubReaderPreloadController]
+        Spread[RDEpubReaderSpreadResolver]
+        TapRegion[RDEpubReaderTapRegionHandler]
     end
 
     subgraph EPUBUI
@@ -297,11 +297,11 @@ classDiagram
 
 ```mermaid
 classDiagram
-    class RDReaderView {
+    class RDEpubReaderView {
         +currentPage: Int
         +currentDisplayType: DisplayType
-        +pageProvider: RDReaderPageProvider?
-        +delegate: RDReaderDelegate?
+        +pageProvider: RDEpubReaderPageProvider?
+        +delegate: RDEpubReaderDelegate?
         +landscapeDualPageEnabled: Bool
         +pageDirection: PageDirection
         +coverPageIndex: Int?
@@ -318,14 +318,14 @@ classDiagram
         verticalScroll
     }
 
-    class RDReaderPageProvider {
+    class RDEpubReaderPageProvider {
         <<protocol>>
         +numberOfPages(in:) Int
         +readerView(_:viewForPageAt:reusableView:) UIView
         +pageIdentifier(in:index:) String?
     }
 
-    class RDReaderFlowLayout {
+    class RDEpubReaderFlowLayout {
         +displayType: DisplayType
         +isLandscapeDualPage: Bool
         +coverPageIndex: Int?
@@ -333,7 +333,7 @@ classDiagram
         +currentPage: Int
     }
 
-    class RDReaderPreloadController {
+    class RDEpubReaderPreloadController {
         +radius: Int
         +pageViewForDisplay(pageNum:environment:contentViewProvider:) UIView?
         +takePreloadedView(for:) UIView?
@@ -341,13 +341,13 @@ classDiagram
         +invalidate(environment:)
     }
 
-    class RDReaderSpreadResolver {
+    class RDEpubReaderSpreadResolver {
         +isFullScreenPage(...) Bool
         +dualPagePair(for:totalPages:coverPageIndex:) (Int, Int?)
         +nextPage(from:totalPages:pagesPerScreen:coverPageIndex:forward:) Int?
     }
 
-    class RDReaderTapRegionHandler {
+    class RDEpubReaderTapRegionHandler {
         +resolveTapEvent(point:viewFrame:isToolViewVisible:) TapEvent
     }
 
@@ -359,7 +359,7 @@ classDiagram
         right
     }
 
-    class RDReaderPagingController {
+    class RDEpubReaderPagingController {
         +isTransitioning: Bool
         +didBuildUI: Bool
         +pendingTransitionRequest: PageTransitionRequest?
@@ -367,25 +367,25 @@ classDiagram
         +finishPageCurlTransition() PageTransitionRequest?
     }
 
-    class RDReaderContentCell {
+    class RDEpubReaderContentCell {
         +containerView: UIView?
     }
 
-    class RDReaderPageChildViewController {
+    class RDEpubReaderPageChildViewController {
         +contentView: UIView?
         +pageNum: Int
     }
 
-    RDReaderView --> DisplayType : uses
-    RDReaderView --> RDReaderPageProvider : delegates
-    RDReaderView --> RDReaderFlowLayout : owns
-    RDReaderView --> RDReaderPreloadController : owns
-    RDReaderView --> RDReaderSpreadResolver : owns
-    RDReaderView --> RDReaderTapRegionHandler : owns
-    RDReaderView --> RDReaderPagingController : owns
-    RDReaderView --> RDReaderContentCell : creates
-    RDReaderView --> RDReaderPageChildViewController : creates
-    RDReaderTapRegionHandler --> TapEvent : produces
+    RDEpubReaderView --> DisplayType : uses
+    RDEpubReaderView --> RDEpubReaderPageProvider : delegates
+    RDEpubReaderView --> RDEpubReaderFlowLayout : owns
+    RDEpubReaderView --> RDEpubReaderPreloadController : owns
+    RDEpubReaderView --> RDEpubReaderSpreadResolver : owns
+    RDEpubReaderView --> RDEpubReaderTapRegionHandler : owns
+    RDEpubReaderView --> RDEpubReaderPagingController : owns
+    RDEpubReaderView --> RDEpubReaderContentCell : creates
+    RDEpubReaderView --> RDEpubReaderPageChildViewController : creates
+    RDEpubReaderTapRegionHandler --> TapEvent : produces
 ```
 
 ---
@@ -403,7 +403,7 @@ classDiagram
         +highlights: [RDEPUBHighlight]
         +bookmarks: [RDEPUBBookmark]
         +tableOfContents: [EPUBTableOfContentsItem]
-        +readerView: RDReaderView
+        +readerView: RDEpubReaderView
         +readerContext: RDEPUBReaderContext
         +runtime: RDEPUBReaderRuntime?
     }

Doc/index.md

@@ -47,7 +47,7 @@
 
 ## 项目信息
 
-- **模块总数：** 4 个（EPUBCore、EPUBTextRendering、RDReaderView、EPUBUI）
+- **模块总数：** 4 个（EPUBCore、EPUBTextRendering、RDEpubReaderView、EPUBUI）
 - **Swift 文件数：** 142 个（SDK Sources）
 - **测试用例数：** 23 个测试类，约 99 个测试方法（UI 测试）
 - **最低 iOS 版本：** 15.6