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

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

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

Sources/RDReaderView/EPUBUI/TextPage/RDEPUBSelectableTextView.swift

@@ -1,10 +1,12 @@
 import UIKit
 
-/// 自定义 UITextView，替换系统默认的 UIMenuItem 为自定义操作（拷贝、高亮、批注）
+/// 可选文本视图，继承自 UITextView。
+/// 替换系统默认的 UIMenuItem 为自定义操作（拷贝、高亮、批注），通过 `onSelectionAction` 回调通知外部。
 final class RDEPUBSelectableTextView: UITextView {
-    /// 选择菜单操作回调
+    /// 选择菜单操作回调，当用户选择拷贝、高亮或批注时触发
     var onSelectionAction: ((RDEPUBAnnotationMenuAction) -> Void)?
 
+    /// 判断指定菜单项是否可执行，仅允许自定义的拷贝、高亮、批注操作
     override func canPerformAction(_ action: Selector, withSender sender: Any?) -> Bool {
         switch action {
         case #selector(rd_copy(_:)),

Sources/RDReaderView/EPUBUI/TextPage/RDEPUBTextAnnotationOverlay.swift

@@ -1,7 +1,13 @@
 import UIKit
 
-/// 前景覆盖层，负责绘制高亮、搜索命中和当前选区。
+/// 原生文本渲染路径的批注覆盖层，负责绘制用户高亮、搜索命中高亮和当前选区装饰。
 final class RDEPUBTextAnnotationOverlay: RDEPUBSelectionOverlayView {
+    /// 将用户高亮批注以富文本属性形式应用到页面内容上
+    /// - Parameters:
+    ///   - highlights: 高亮批注数组
+    ///   - content: 待修改的富文本
+    ///   - page: 目标文本页
+    ///   - contentBaseOffset: 内容在全局偏移中的起始位置
     func applyHighlights(
         _ highlights: [RDEPUBHighlight],
         to content: NSMutableAttributedString,
@@ -38,6 +44,12 @@ final class RDEPUBTextAnnotationOverlay: RDEPUBSelectionOverlayView {
         }
     }
 
+    /// 将搜索命中高亮以富文本背景色形式应用到页面内容上
+    /// - Parameters:
+    ///   - content: 待修改的富文本
+    ///   - page: 目标文本页
+    ///   - searchState: 当前搜索状态
+    ///   - contentBaseOffset: 内容在全局偏移中的起始位置
     func applySearchHighlights(
         to content: NSMutableAttributedString,
         page: RDEPUBTextPage,
@@ -65,6 +77,13 @@ final class RDEPUBTextAnnotationOverlay: RDEPUBSelectionOverlayView {
         }
     }
 
+    /// 构建页面的背景和前景装饰数组（搜索高亮为背景，下划线批注为前景）
+    /// - Parameters:
+    ///   - page: 目标文本页
+    ///   - highlights: 高亮批注数组
+    ///   - searchState: 当前搜索状态
+    ///   - interactionController: 用于计算选区矩形的交互控制器
+    /// - Returns: 分离的背景和前景装饰数组
     func buildDecorations(
         page: RDEPUBTextPage,
         highlights: [RDEPUBHighlight],

Sources/RDReaderView/EPUBUI/TextPage/RDEPUBTextPageDecorationView.swift

@@ -1,4 +1,5 @@
 import UIKit
 
-/// 背景覆盖层，负责绘制页内装饰和位于正文下方的提示层。
+/// 原生文本渲染路径的页级背景覆盖层。
+/// 继承自 RDEPUBSelectionOverlayView，负责绘制位于正文下方的页内装饰（如搜索高亮背景、批注背景等）。
 final class RDEPUBTextPageDecorationView: RDEPUBSelectionOverlayView {}