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

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

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

Sources/RDReaderView/EPUBCore/RDEPUBJavaScriptBridge.swift

@@ -83,6 +83,10 @@ enum RDEPUBJavaScriptBridge {
         """
     }
 
+    /// 生成固定版式模式下的主题应用脚本
+    /// 仅应用共享主题（背景色），不涉及分页逻辑（固定版式由 HTML 自身布局决定）
+    /// - Parameter request: 固定版式渲染请求，包含背景色等信息
+    /// - Returns: 可直接通过 evaluateJavaScript 执行的脚本字符串
     static func applyFixedPresentationScript(for request: RDEPUBFixedRenderRequest) -> String {
         """
         (function() {
@@ -113,6 +117,9 @@ enum RDEPUBJavaScriptBridge {
         """
     }
 
+    /// 生成获取当前装饰数据的脚本
+    /// 从 WebView 中读取高亮和搜索高亮的 DOM 装饰信息，用于同步原生标注状态
+    /// - Returns: 可直接通过 evaluateJavaScript 执行的脚本字符串，返回包含 highlights 和 search 的对象
     static func resolveDecorationsScript() -> String {
         """
         (function() {
@@ -178,6 +185,8 @@ enum RDEPUBJavaScriptBridge {
         return string
     }
 
+    /// 将 Swift 字符串转换为 JavaScript 字符串字面量
+    /// nil 值转为 "null"，非空值序列化为 JSON 字符串后去除外层方括号
     private static func javaScriptStringLiteral(_ value: String?) -> String {
         guard let value else { return "null" }
         return jsonString(from: [value], fallback: "[null]")

Sources/RDReaderView/EPUBCore/RDEPUBPublication.swift

@@ -13,6 +13,8 @@ public final class RDEPUBPublication {
     /// 资源解析器（URL 转换和路径规范化）
     public let resourceResolver: RDEPUBResourceResolver
 
+    /// 基于解析器创建出版物门面对象
+    /// - Parameter parser: 已完成解析的 EPUB 解析器
     public init(parser: RDEPUBParser) {
         self.parser = parser
         self.resourceResolver = RDEPUBResourceResolver(parser: parser)

Sources/RDReaderView/EPUBCore/RDEPUBSearchEngine.swift

@@ -8,6 +8,9 @@ import UIKit
 
 /// 搜索引擎协议，定义全文搜索接口
 protocol RDEPUBSearchEngine {
+    /// 执行全文搜索
+    /// - Parameter keyword: 搜索关键词
+    /// - Returns: 匹配结果列表
     func search(keyword: String) -> [RDEPUBSearchMatch]
 }
 
@@ -19,6 +22,10 @@ final class RDEPUBHTMLSearchEngine: RDEPUBSearchEngine {
     /// EPUB 出版物（用于遍历 spine 和规范化 href）
     private let publication: RDEPUBPublication
 
+    /// 创建 HTML 全文搜索引擎
+    /// - Parameters:
+    ///   - parser: EPUB 解析器（用于读取 HTML 内容）
+    ///   - publication: EPUB 出版物（用于遍历 spine 和规范化 href）
     init(parser: RDEPUBParser, publication: RDEPUBPublication) {
         self.parser = parser
         self.publication = publication