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

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

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

Sources/RDReaderView/EPUBUI/RDEPUBReaderController+TableOfContents.swift

@@ -1,6 +1,17 @@
+// RDEPUBReaderController+TableOfContents.swift
+// EPUB 阅读器目录功能
+// 提供目录（Table of Contents）相关功能，包括解析当前页面对应的目录项
+// 以及将嵌套目录树结构扁平化为线性列表。
+
 import Foundation
 
+/// RDEPUBReaderController 目录扩展
+///
+/// 本文件提供目录（Table of Contents）相关功能，包括解析当前页面对应的目录项
+/// 以及将嵌套目录树结构扁平化为线性列表。
+
 extension RDEPUBReaderController {
+    /// 解析当前阅读位置对应的目录项，按页码或 href 匹配
     func resolvedCurrentTableOfContentsItem() -> RDEPUBReaderTableOfContentsItem? {
         let items = flattenedTableOfContents
         guard !items.isEmpty else { return nil }
@@ -46,6 +57,7 @@ extension RDEPUBReaderController {
         }
     }
 
+    /// 将嵌套目录树递归扁平化为线性列表，并计算每项目标页码
     func flattenedTableOfContentsItems(
         from items: [EPUBTableOfContentsItem],
         depth: Int = 0