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

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

Sources/RDReaderView/EPUBUI/RDEPUBReaderSettings.swift

@@ -1,11 +1,20 @@
 import UIKit
 
+// MARK: - 翻页显示模式
+
+/// 阅读器翻页显示模式枚举
+/// 用于持久化存储用户的翻页偏好设置，与 RDReaderView.DisplayType 相互转换
 public enum RDEPUBReaderDisplayMode: String, Codable, Equatable {
+    /// 仿真翻页模式（纸张翻转效果）
     case pageCurl
+    /// 水平滚动模式
     case horizontalScroll
+    /// 垂直滚动模式
     case verticalScroll
+    /// 水平覆盖式滚动模式（类似电子杂志翻页效果）
     case horizontalCoverScroll
 
+    /// 从底层 DisplayType 转换为 UI 层的 DisplayMode
     init(displayType: RDReaderView.DisplayType) {
         switch displayType {
         case .pageCurl:
@@ -17,6 +26,8 @@ public enum RDEPUBReaderDisplayMode: String, Codable, Equatable {
         }
     }
 
+    /// 转换为底层 RDReaderView 所需的 DisplayType
+    /// 注意：horizontalCoverScroll 会被映射为 horizontalScroll
     var displayType: RDReaderView.DisplayType {
         switch self {
         case .pageCurl:
@@ -29,14 +40,25 @@ public enum RDEPUBReaderDisplayMode: String, Codable, Equatable {
     }
 }
 
+// MARK: - 主题预设
+
+/// 阅读器主题预设枚举
+/// 将 RDEPUBReaderTheme 映射为可序列化的枚举值，用于持久化存储和设置面板展示
 public enum RDEPUBReaderThemePreset: String, Codable, CaseIterable, Equatable {
+    /// 浅色主题
     case light
+    /// 黄色护眼主题
     case yellow
+    /// 绿色护眼主题
     case green
+    /// 粉色主题
     case pink
+    /// 蓝色主题
     case blue
+    /// 深色/夜间主题
     case dark
 
+    /// 将预设枚举转换为主题配置实例
     public var theme: RDEPUBReaderTheme {
         switch self {
         case .light:
@@ -54,6 +76,8 @@ public enum RDEPUBReaderThemePreset: String, Codable, CaseIterable, Equatable {
         }
     }
 
+    /// 从主题配置实例反向查找对应的预设枚举
+    /// 自定义主题（非内置预设）会返回 nil
     public init?(theme: RDEPUBReaderTheme) {
         switch theme {
         case .light:
@@ -74,13 +98,26 @@ public enum RDEPUBReaderThemePreset: String, Codable, CaseIterable, Equatable {
     }
 }
 
+// MARK: - 阅读器用户设置
+
+/// 阅读器的可持久化用户设置
+/// 用于保存用户在设置面板中调整的阅读偏好（字号、行距、翻页模式、主题等）
+/// 所有属性均为可选类型，只覆盖用户实际修改过的配置项
 public struct RDEPUBReaderSettings: Codable, Equatable {
+    // MARK: 可调参数
+
+    /// 屏幕亮度（0.0 ~ 1.0），nil 表示使用系统亮度
     public var brightness: CGFloat?
+    /// 用户选择的正文字号（pt），nil 表示使用默认值
     public var fontSize: CGFloat?
+    /// 用户选择的行距倍数，nil 表示使用默认值
     public var lineHeightMultiple: CGFloat?
+    /// 用户选择的翻页模式，nil 表示使用默认值
     public var displayMode: RDEPUBReaderDisplayMode?
+    /// 用户选择的主题预设，nil 表示使用默认值
     public var themePreset: RDEPUBReaderThemePreset?
 
+    /// 初始化用户设置，所有参数默认为 nil
     public init(
         brightness: CGFloat? = nil,
         fontSize: CGFloat? = nil,
@@ -95,6 +132,10 @@ public struct RDEPUBReaderSettings: Codable, Equatable {
         self.themePreset = themePreset
     }
 
+    /// 将用户设置覆盖到基础配置上，得到最终生效的阅读器配置
+    /// nil 属性不会覆盖基础配置的对应值
+    /// - Parameter configuration: 基础配置（通常来自 RDEPUBReaderConfiguration.default）
+    /// - Returns: 合并后的完整配置
     public func applying(to configuration: RDEPUBReaderConfiguration) -> RDEPUBReaderConfiguration {
         var resolvedConfiguration = configuration
 
@@ -114,6 +155,12 @@ public struct RDEPUBReaderSettings: Codable, Equatable {
         return resolvedConfiguration
     }
 
+    /// 从当前配置和亮度值捕获一份完整的用户设置快照
+    /// 亮度值会被限制在 0.0 ~ 1.0 范围内
+    /// - Parameters:
+    ///   - configuration: 当前生效的阅读器配置
+    ///   - brightness: 当前屏幕亮度
+    /// - Returns: 完整的用户设置实例
     public static func capture(
         configuration: RDEPUBReaderConfiguration,
         brightness: CGFloat