refactor: 添加中文注释 + 优化模块结构

- 给全部 78 个 Swift 源文件添加详细的中文注释（文件级、类级、方法级）
- 删除 LegacyRDReaderController/ 死代码目录（16 文件 4592 行）
- 根目录翻页容器文件移入 ReaderView/ 目录
- Resources/ 移入 EPUBCore/Resources/（与使用者归属一致）
- RDEPUBTextIndexTable.swift 移入 EPUBTextRendering/（消除反向依赖）
- RDURLReaderController.swift 移入 EPUBUI/（入口控制器归入 UI 层）
- 更新 podspec 资源路径

Sources/RDReaderView/EPUBCore/RDEPUBPublication.swift

@@ -1,7 +1,16 @@
+// RDEPUBPublication.swift
+// EPUB 出版物门面（Facade）
+// 对 RDEPUBParser 的高层封装，提供 metadata、spine、TOC 等只读访问，
+// 以及固定版式双页展开判断和 spread 生成等业务逻辑。
+// 是 EPUBCore Publication 层对外暴露的主要接口。
+
 import Foundation
 
+/// EPUB 出版物门面对象，封装解析结果并提供高层访问接口
 public final class RDEPUBPublication {
+    /// 底层解析器（持有解析数据）
     public let parser: RDEPUBParser
+    /// 资源解析器（URL 转换和路径规范化）
     public let resourceResolver: RDEPUBResourceResolver
 
     public init(parser: RDEPUBParser) {
@@ -9,38 +18,48 @@ public final class RDEPUBPublication {
         self.resourceResolver = RDEPUBResourceResolver(parser: parser)
     }
 
+    /// 元数据代理
     public var metadata: RDEPUBMetadata {
         parser.metadata
     }
 
+    /// 资源清单代理
     public var manifest: [String: RDEPUBManifestItem] {
         parser.manifest
     }
 
+    /// 阅读顺序代理
     public var spine: [RDEPUBSpineItem] {
         parser.spine
     }
 
+    /// 目录代理
     public var tableOfContents: [EPUBTableOfContentsItem] {
         parser.tableOfContents
     }
 
+    /// 布局模式（fixed/reflowable）
     public var layout: RDEPUBLayout {
         metadata.layout
     }
 
+    /// 阅读配置文件（webFixedLayout/webInteractive/textReflowable）
     public var readingProfile: RDEPUBReadingProfile {
         parser.readingProfile()
     }
 
+    /// 阅读方向（ltr/rtl/auto）
     public var readingProgression: RDEPUBReadingProgression {
         metadata.readingProgression
     }
 
+    /// 书籍唯一标识符
     public var bookIdentifier: String? {
         metadata.identifier
     }
 
+    /// 判断固定版式是否启用双页展开模式
+    /// 综合考虑 metadata.spread、偏好设置和视口方向
     public func fixedLayoutSpreadEnabled(for preferences: RDEPUBPreferences, viewportSize: CGSize) -> Bool {
         guard layout == .fixed else {
             return false
@@ -59,6 +78,7 @@ public final class RDEPUBPublication {
         }
     }
 
+    /// 根据偏好和视口生成固定版式的 spread 数组
     public func makeFixedSpreads(preferences: RDEPUBPreferences, viewportSize: CGSize) -> [EPUBFixedSpread] {
         EPUBFixedSpread.makeSpreads(
             spine: spine,