docs: 同步 Doc 文档与当前代码状态

- 更新模块文件数（EPUBCore 31+2, EPUBTextRendering 13, ReaderView 5, EPUBUI 19）
- 更新 Swift 版本（5.10）、iOS 版本（15.0）、行数等基本信息
- 补充新增文件文档（TextAnchor, RenderRequest, WebViewDebug, AssetRepository,
  TextIndexTable, TextPerformanceSampler, ChapterData, PageInteractionController 等）
- 更新 RDEPUBLocation 模型（新增 rangeAnchor 字段）
- 更新 RDEPUBReaderConfiguration（13 项配置）、Delegate 签名、Persistence（8 方法）
- 修正 RDURLReaderController 归属（ReaderView → EPUBUI）
- 移除过时的 LegacyRDReaderController 引用
- 标记 SS→RD 命名迁移为已完成

Doc/EPUB_MAINTENANCE.md

@@ -15,20 +15,27 @@
 
 | 文件 | 职责 |
 |------|------|
-| `RDEPUBParser.swift` + 扩展 | EPUB 解压、container.xml、OPF、manifest、spine、TOC/NCX 解析 |
+| `RDEPUBParser.swift` + 5 扩展 | EPUB 解压、container.xml、OPF、manifest、spine、TOC/NCX 解析、阅读配置文件判断 |
 | `RDEPUBPublication.swift` | 解析结果的唯一聚合入口，外部不直接访问 parser 字段 |
 | `RDEPUBModels.swift` | metadata / manifest / spine / TOC 基础模型 |
-| `RDEPUBReadingModels.swift` | RDEPUBLocation、RDEPUBViewport、RDEPUBHighlight、选区模型 |
+| `RDEPUBReadingModels.swift` | RDEPUBLocation、RDEPUBViewport、RDEPUBHighlight、RDEPUBBookmark、选区模型 |
 | `RDEPUBResourceResolver.swift` | href → fileURL / schemeURL 的统一入口，`normalizedHref` 标准化路径 |
 | `RDEPUBPaginator.swift` | 离屏 WKWebView 分页，计算每个 spine 资源被视口切成多少页 |
 | `RDEPUBReadingSession.swift` | 状态机 + 会话协调，管理 staged/active/pending 页模型 |
 | `RDEPUBNavigatorState.swift` | 状态枚举（initializing/loading/idle/jumping/moving/repaginating） |
-| `RDEPUBWebView.swift` + 扩展 | 承载 spine 资源的 WKWebView，分页 CSS 注入、JS bridge、fixed wrapper |
+| `RDEPUBWebView.swift` + 5 扩展 | 承载 spine 资源的 WKWebView，分页 CSS 注入、JS bridge、fixed wrapper、搜索装饰 |
 | `RDEPUBResourceURLSchemeHandler.swift` | `ss-reader://` 协议，从本地解压目录提供所有 EPUB 资源 |
 | `RDEPUBStyleSheetBuilder.swift` | 生成注入 WebView 的 CSS |
 | `RDEPUBJavaScriptBridge.swift` | JS ↔ Swift 消息定义和编解码 |
 | `RDEPUBSearchEngine.swift` | 搜索协议定义 + WebView 全文搜索引擎 |
 | `RDEPUBSearchModels.swift` | 搜索模型（SearchMatch/Result/State/Presentation） |
+| `RDEPUBTextAnchor.swift` | 文本锚点和范围锚点（精确定位字符位置） |
+| `RDEPUBRenderRequest.swift` | 渲染请求模型、展示样式、固定版式适配/Spread 枚举 |
+| `RDEPUBWebViewDebug.swift` | WebView 调试日志工具（导航/JS/消息/Scheme） |
+| `RDEPUBAssetRepository.swift` | 静态资源加载器（JS 脚本、HTML 模板、模板变量替换） |
+| `RDEPUBPreferences.swift` | 用户阅读偏好聚合 |
+| `RDEPUBNavigatorLayoutContext.swift` | 容器布局上下文 |
+| `RDEPUBFixedLayoutTemplate.swift` | 固定版式 HTML 模板生成 |
 
 ### 2.2 EPUBTextRendering 层
 
@@ -39,17 +46,38 @@
 | `RDEPUBTextRendererSupport.swift` | fragment 标记注入、fragment offset 提取、属性标准化 |
 | `RDEPUBTextPaginationSupport.swift` | NSAttributedString 切页算法 |
 | `RDEPUBTextBookBuilder.swift` | 驱动逐章节渲染和分页，生成 RDEPUBTextBook |
+| `RDEPUBTextLayouter.swift` | CoreText 分页引擎（~810 行，含 4 级语义边界调整） |
+| `RDEPUBTextLayoutFrame.swift` | 单帧分页结果模型（contentRange、breakReason、语义提示） |
+| `RDEPUBTextBookCache.swift` | 分页结果磁盘缓存 |
+| `RDEPUBChapterData.swift` | 章节数据聚合模型（高亮、搜索结果、页面查询） |
+| `RDEPUBTextSearchEngine.swift` | 纯文本全文搜索引擎 |
+| `RDPlainTextBookBuilder.swift` | 纯文本（.txt）书籍构建器 |
+| `RDEPUBTextIndexTable.swift` | 全书文本索引表（章节偏移、行列映射、锚点转换） |
+| `RDEPUBTextPerformanceSampler.swift` | 性能采样器（渲染/分页耗时、缓存命中率） |
 
 ### 2.3 EPUBUI 层
 
 | 文件 | 职责 |
 |------|------|
-| `RDEPUBReaderController.swift` | 开箱即用读者控制器，整合 session / readerView / UI |
-| `RDEPUBReaderConfiguration.swift` | 外部配置项（字号、主题、翻页模式等） |
-| `RDEPUBReaderPersistence.swift` | 阅读位置和高亮的本地持久化 |
-| `RDEPUBReaderSettings.swift` | 运行时设置状态 |
+| `RDEPUBReaderController.swift` | 开箱即用读者控制器（~1995 行），整合 session / readerView / UI |
+| `RDEPUBReaderConfiguration.swift` | 外部配置项（13 个：字号、主题、翻页模式等） |
+| `RDEPUBReaderPersistence.swift` | 阅读位置、高亮、书签的本地持久化（8 个方法） |
+| `RDEPUBReaderSettings.swift` | 可持久化用户设置模型 + DisplayMode/ThemePreset 枚举 |
+| `RDEPUBReaderTheme.swift` | 6 个内置主题预设 + 颜色属性 |
+| `RDEPUBReaderDelegate.swift` | 12 个可选委托方法 |
+| `RDEPUBReaderToolView.swift` | 工具栏基类（分隔线 + 主题适配） |
+| `RDEPUBReaderTopToolView.swift` | 顶部导航栏（返回 + 书签 + 标题） |
+| `RDEPUBReaderBottomToolView.swift` | 底部工具栏（目录/书签/标注/设置） |
+| `RDEPUBReaderChapterListController.swift` | 目录列表面板 |
+| `RDEPUBReaderHighlightsViewController.swift` | 标注管理面板（过滤、编辑、删除、跳转） |
+| `RDEPUBReaderSettingsViewController.swift` | 设置面板（亮度、字号、行高、模式、主题） |
+| `RDEPUBReaderTableOfContentsItem.swift` | 展平目录条目模型 |
 | `RDEPUBWebContentView.swift` | WKWebView 内容视图，供 RDReaderView 渲染 WebView 类 spine |
-| `RDEPUBTextContentView.swift` | 文本内容视图，供 RDReaderView 渲染文本类 spine |
+| `RDEPUBTextContentView.swift` | 文本内容视图（~728 行），供 RDReaderView 渲染文本类 spine |
+| `RDEPUBPageInteractionController.swift` | CoreText 页面级交互控制器 |
+| `RDEPUBSelectionOverlayView.swift` | 选区覆盖视图 |
+| `RDEPUBPageLayoutSnapshot.swift` | 页面几何模型 |
+| `RDURLReaderController.swift` | 最简 URL 入口（.epub/.txt 自动识别） |
 
 ---
 
@@ -289,7 +317,7 @@ webView.loadHTMLString(htmlString, baseURL: nil)
 
 ## 7. 后续扩展建议
 
-1. **拆分 demo 层 RDReaderController**：约 1900+ 行，EPUB 加载、UI、数据源职责仍混在一起，建议继续向 library 层迁移
+1. **拆分 RDEPUBReaderController**：约 1995 行，EPUB 加载、UI、数据源职责仍混在一起，建议继续向 library 层迁移
 2. **基线验证**：用四本样书跑一轮分页耗时、目录命中率、末页事件、设置恢复稳定性数据
 3. **横竖屏支持回归矩阵**：控制器级 `viewWillTransition()` 与 viewport 去重已接入，下一步重点是补齐 pageCurl / scroll、三条正文路径和 iPad 视口变化场景的固定回归
 4. **Pod 分层**：评估是否将 EPUBCore / EPUBTextRendering / EPUBUI 拆为独立 subspec