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

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

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

Sources/RDReaderView/EPUBUI/RDEPUBReaderController+ContentDelegates.swift

@@ -1,8 +1,19 @@
+// RDEPUBReaderController+ContentDelegates.swift
+// EPUB 阅读器内容视图代理实现
+// 处理 Web 渲染路径（RDEPUBWebContentViewDelegate）和 Native Text 渲染路径
+// （RDEPUBTextContentViewDelegate）的位置更新、选区变化、链接跳转、错误日志等事件回调。
+
 import UIKit
 
+/// RDEPUBReaderController 内容代理扩展
+///
+/// 本文件实现 EPUB 阅读器的内容视图代理，处理 Web 渲染路径和 Native Text 渲染路径的
+/// 位置更新、选区变化、链接跳转、错误日志等事件回调。
+
 // MARK: - Web 内容视图代理（EPUB 固定布局/Web 渲染路径）
 
 extension RDEPUBReaderController: RDEPUBWebContentViewDelegate {
+    /// Web 内容视图位置更新回调，同步阅读上下文与持久化位置
     func epubWebContentView(_ contentView: RDEPUBWebContentView, didUpdateLocation location: RDEPUBLocation, spineIndex: Int) {
         guard readerView.currentPage >= 0,
               activePages.indices.contains(readerView.currentPage) else {
@@ -24,6 +35,7 @@ extension RDEPUBReaderController: RDEPUBWebContentViewDelegate {
         )
     }
 
+    /// Web 内容视图选区变化回调，转换为统一选区模型
     func epubWebContentView(_ contentView: RDEPUBWebContentView, didChangeSelection selection: RDEPUBSelection?, spineIndex: Int) {
         if let selection {
             updateCurrentSelection(scopedSelection(selection, relativeToSpineIndex: spineIndex))
@@ -32,10 +44,12 @@ extension RDEPUBReaderController: RDEPUBWebContentViewDelegate {
         }
     }
 
+    /// Web 内容视图选区菜单操作回调
     func epubWebContentView(_ contentView: RDEPUBWebContentView, didRequestSelectionAction action: RDEPUBAnnotationMenuAction) {
         handleSelectionMenuAction(action, selection: currentSelection)
     }
 
+    /// Web 内容视图内部链接点击回调，执行页内跳转
     func epubWebContentView(_ contentView: RDEPUBWebContentView, didActivateInternalLink location: RDEPUBLocation, fromSpineIndex: Int) {
         guard let readingSession,
               let pageNumber = readingSession.queueNavigation(
@@ -48,11 +62,13 @@ extension RDEPUBReaderController: RDEPUBWebContentViewDelegate {
         readerView.transitionToPage(pageNum: max(pageNumber - 1, 0), animated: true)
     }
 
+    /// Web 内容视图外部链接点击回调，使用系统浏览器打开
     func epubWebContentView(_ contentView: RDEPUBWebContentView, didActivateExternalLink url: URL) {
         delegate?.epubReader(self, didActivateExternalLink: url)
         UIApplication.shared.open(url, options: [:], completionHandler: nil)
     }
 
+    /// Web 内容视图 JavaScript 错误日志回调
     func epubWebContentView(_ contentView: RDEPUBWebContentView, didLogJavaScriptError message: String) {
         print("EPUB JS Error: \(message)")
     }
@@ -61,6 +77,7 @@ extension RDEPUBReaderController: RDEPUBWebContentViewDelegate {
 // MARK: - 文本内容视图代理（Native Text 渲染路径）
 
 extension RDEPUBReaderController: RDEPUBTextContentViewDelegate {
+    /// 文本内容视图选区变化回调，标准化后更新当前选区
     func textContentView(_ contentView: RDEPUBTextContentView, didChangeSelection selection: RDEPUBSelection?) {
         guard let selection else {
             updateCurrentSelection(nil)
@@ -69,6 +86,7 @@ extension RDEPUBReaderController: RDEPUBTextContentViewDelegate {
         updateCurrentSelection(normalizedTextSelection(selection))
     }
 
+    /// 文本内容视图选区菜单操作回调
     func textContentView(
         _ contentView: RDEPUBTextContentView,
         didRequestSelectionAction action: RDEPUBAnnotationMenuAction,
@@ -79,6 +97,7 @@ extension RDEPUBReaderController: RDEPUBTextContentViewDelegate {
         contentView.clearSelection()
     }
 
+    /// 标准化文本选区的偏移范围，确保在有效内容长度内
     private func normalizedTextSelection(_ selection: RDEPUBSelection) -> RDEPUBSelection? {
         guard let textBook,
               let chapterData = textBook.chapterData(for: selection.location.href) else {
@@ -103,6 +122,7 @@ extension RDEPUBReaderController: RDEPUBTextContentViewDelegate {
         )
     }
 
+    /// 根据 EPUB 位置计算对应的页码
     func pageNumber(for location: RDEPUBLocation) -> Int? {
         if let textBook, let publication {
             if let anchor = location.rangeAnchor?.start {
@@ -130,6 +150,7 @@ extension RDEPUBReaderController: RDEPUBTextContentViewDelegate {
         )
     }
 
+    /// 根据页码解析对应的文本位置
     func resolvedTextLocation(forPageNumber pageNumber: Int) -> RDEPUBLocation? {
         guard let textBook,
               let publication,
@@ -148,6 +169,7 @@ extension RDEPUBReaderController: RDEPUBTextContentViewDelegate {
         ) ?? location
     }
 
+    /// 同步文本阅读状态到阅读会话（页码、位置、spine、章节等）
     func synchronizeTextReadingState(pageNumber: Int, location: RDEPUBLocation) {
         guard let textBook,
               let page = textBook.page(at: pageNumber) else {
@@ -164,6 +186,7 @@ extension RDEPUBReaderController: RDEPUBTextContentViewDelegate {
         )
     }
 
+    /// 从文本书籍生成原生文本快照（页面列表 + 章节信息）
     func nativeTextSnapshot(from textBook: RDEPUBTextBook) -> RDEPUBNativeTextSnapshot {
         let chapters = textBook.chapterInfos
         let pages = textBook.pages.map {