docs: 补充注释、修正过时文档、清理重复内容

源码注释：
- 为 ~60 个 Swift 文件补充缺失的 doc comment（file header、类型、属性、方法）
- 修正 4 处错误注释：翻页模式数量、搜索行为描述、手势识别器描述、悬空文档块

文档维护：
- 删除重复文档：WXRead/读书EPUB阅读器实现架构.md（与微信读书版完全一致）
- 合并重叠文档：阅读器规划.md → 阅读器功能开发计划.md（单一真值）
- 修正过时内容：所有文档中"四种翻页模式"→"三种"，移除 horizontalCoverScroll
- 更新架构图：补齐 EPUBUI/ReaderController、Paging/、Typesetter/ 等子目录
- 更新 index.md 索引：新增开发计划和架构对比文档引用

Sources/RDReaderView/EPUBTextRendering/BuildPipeline/RDEPUBTextBookBuilder.swift

@@ -1,4 +1,6 @@
 import UIKit
+
+/// EPUB 文本书籍构建器，负责将 EPUB publication 渲染、分页并组装为 `RDEPUBTextBook`。
 public final class RDEPUBTextBookBuilder {
     private let renderer: RDEPUBTextRenderer
     private let cache: RDEPUBTextBookCache?
@@ -19,6 +21,11 @@ public final class RDEPUBTextBookBuilder {
     /// 最后一次构建的缓存命中/未命中统计
     public private(set) var lastBuildCacheStats: (hits: Int, misses: Int) = (0, 0)
 
+    /// 创建书籍构建器。
+    /// - Parameters:
+    ///   - renderer: 文本渲染器
+    ///   - cache: 分页缓存（可选）
+    ///   - layoutConfig: 页面布局配置
     public init(
         renderer: RDEPUBTextRenderer,
         cache: RDEPUBTextBookCache? = nil,

Sources/RDReaderView/EPUBTextRendering/BuildPipeline/RDEPUBTextBookModels.swift

@@ -181,13 +181,3 @@ public struct RDEPUBTextBook {
     }
 }
 
-// MARK: - 分页书籍构建器
-
-/// 从 EPUB publication 构建分页书籍模型的核心构建器。
-///
-/// 渲染链路：遍历 spine → 渲染每章 HTML → 分页 → 合并/规范化尾页 → 构建 RDEPUBTextBook
-///
-/// 特性：
-/// - 支持分页缓存（WXRead 模式：只缓存页范围，不缓存富文本）
-/// - 性能采样（记录每章渲染/分页耗时）
-/// - 尾页规范化（丢弃纯空白尾页、合并过短尾页）

Sources/RDReaderView/EPUBTextRendering/BuildPipeline/RDEPUBTextBuildPipelineInterfaces.swift

@@ -1,5 +1,9 @@
+// RDEPUBTextBuildPipelineInterfaces.swift
+// EPUB 文本构建管线接口定义，包括全书构建、章节渲染与分页管线。
+
 import UIKit
 
+/// EPUB 全书文本构建接口，将 EPUB 出版物解析为可分页的文本书籍。
 protocol RDEPUBTextBookBuilding {
     func build(
         parser: RDEPUBParser,
@@ -9,25 +13,41 @@ protocol RDEPUBTextBookBuilding {
     ) throws -> RDEPUBTextBook
 }
 
+/// 章节渲染管线，将章节渲染请求委托给底层文本渲染器。
 struct RDEPUBChapterRenderPipeline {
     private let renderer: RDEPUBTextRenderer
 
+    /// 初始化渲染管线。
+    /// - Parameter renderer: 文本渲染器实例
     init(renderer: RDEPUBTextRenderer) {
         self.renderer = renderer
     }
 
+    /// 渲染单个章节，返回渲染后的富文本内容。
+    /// - Parameter request: 章节渲染请求
+    /// - Returns: 渲染完成的章节内容
     func render(_ request: RDEPUBTextChapterRenderRequest) throws -> RDEPUBRenderedChapterContent {
         try renderer.renderChapter(request: request)
     }
 }
 
+/// 章节分页管线，将渲染后的富文本按页面尺寸拆分为文本帧数组。
 struct RDEPUBChapterPaginationPipeline {
     private let frameFactory: RDEPUBPageFrameBuilding
 
+    /// 初始化分页管线。
+    /// - Parameter frameFactory: 页面帧工厂，默认使用 CoreText 实现
     init(frameFactory: RDEPUBPageFrameBuilding = RDEPUBCoreTextPageFrameFactory()) {
         self.frameFactory = frameFactory
     }
 
+    /// 将富文本内容分页，返回页面帧数组。
+    /// - Parameters:
+    ///   - content: 待分页的富文本
+    ///   - pageSize: 页面尺寸
+    ///   - config: 排版配置
+    ///   - fragmentOffsets: fragment 锚点偏移映射
+    /// - Returns: 页面帧数组
     func frames(
         for content: NSAttributedString,
         pageSize: CGSize,