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

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

Sources/RDReaderView/EPUBCore/RDEPUBParser+Archive.swift

@@ -1,7 +1,15 @@
+// RDEPUBParser+Archive.swift
+// EPUB 归档解压与 container.xml 解析
+// 负责将 EPUB ZIP 文件解压到缓存目录（~/Library/Caches/ssreaderview-epub/），
+// 并解析 META-INF/container.xml 获取 OPF 文件路径。
+
 import Foundation
 import ZIPFoundation
 
 extension RDEPUBParser {
+    /// 解析 container.xml，提取 OPF（Package Document）的相对路径
+    /// - Parameter containerURL: container.xml 的文件路径
+    /// - Returns: OPF 文件的相对路径（如 "OEBPS/content.opf"）
     func parseContainerRootFile(at containerURL: URL) throws -> String {
         guard let parser = XMLParser(contentsOf: containerURL) else {
             throw RDEPUBParserError.invalidXML(containerURL)
@@ -22,6 +30,10 @@ extension RDEPUBParser {
         return rootFilePath
     }
 
+    /// 解压 EPUB ZIP 文件到缓存目录（幂等：已存在则跳过）
+    /// 目录名由 slug + 文件大小 + 修改时间戳组成，避免冲突
+    /// - Parameter epubURL: EPUB 文件路径
+    /// - Returns: 解压目标目录 URL
     func extractArchiveIfNeeded(epubURL: URL) throws -> URL {
         let fileManager = FileManager.default
         let extractionURL = temporaryExtractionDirectory(for: epubURL)
@@ -52,6 +64,8 @@ extension RDEPUBParser {
         return extractionURL
     }
 
+    /// 计算 EPUB 的临时解压目录路径
+    /// 路径格式：~/Library/Caches/ssreaderview-epub/{slug}-{fileSize}-{modifiedTimestamp}/
     func temporaryExtractionDirectory(for epubURL: URL) -> URL {
         let baseURL = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask).first?
             .appendingPathComponent("ssreaderview-epub", isDirectory: true)
@@ -65,12 +79,14 @@ extension RDEPUBParser {
         return baseURL.appendingPathComponent("\(slug)-\(fileSize)-\(signature)", isDirectory: true)
     }
 
+    /// 重置解析器状态（清除解压路径和出版物数据）
     func reset() {
         extractionRootURL = nil
         opfURL = nil
         resetPublicationState()
     }
 
+    /// 重置出版物相关状态（metadata、manifest、spine、目录）
     func resetPublicationState() {
         metadata = RDEPUBMetadata()
         manifest = [:]
@@ -79,7 +95,9 @@ extension RDEPUBParser {
     }
 }
 
+/// container.xml 的 SAX 解析代理，提取 <rootfile> 元素的 full-path 属性
 private final class ContainerXMLParserDelegate: NSObject, XMLParserDelegate {
+    /// 解析得到的 OPF 文件相对路径
     private(set) var rootFilePath: String?
 
     func parser(