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

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

Sources/RDReaderView/EPUBTextRendering/RDPlainTextBookBuilder.swift

@@ -1,6 +1,16 @@
 import UIKit
 
-/// 将纯文本文件构建为 RDEPUBTextBook，复用 EPUB 文本渲染和分页管线
+/// 纯文本书籍构建器：将 TXT 文件构建为 RDEPUBTextBook，复用 EPUB 文本渲染和分页管线。
+///
+/// 本类将纯文本文件（.txt）转换为与 EPUB 相同的分页书籍模型，
+/// 使得纯文本阅读器可以复用 EPUBReader 的分页、导航、搜索等全部功能。
+///
+/// 处理流程：
+/// 1. 解码文本文件（UTF-8 → GB18030 → GBK 兼容编码）
+/// 2. 按中文章节正则拆分为多个章节
+/// 3. 将纯文本包装为 HTML 段落
+/// 4. 通过渲染器（DTCoreText）渲染为富文本
+/// 5. CoreText 分页 → RDEPUBTextBook
 public final class RDPlainTextBookBuilder {
     private let renderer: RDEPUBTextRenderer
 
@@ -8,6 +18,13 @@ public final class RDPlainTextBookBuilder {
         self.renderer = renderer
     }
 
+    /// 从纯文本文件构建分页书籍。
+    ///
+    /// - Parameters:
+    ///   - textFileURL: 纯文本文件的本地 URL
+    ///   - pageSize: 页面尺寸
+    ///   - style: 渲染样式（字体、行距、颜色）
+    /// - Returns: 分页后的书籍模型
     public func build(
         textFileURL: URL,
         pageSize: CGSize,
@@ -86,12 +103,14 @@ public final class RDPlainTextBookBuilder {
 
     // MARK: - 章节拆分
 
+    /// 章节规格：标题 + 内容
     private struct ChapterSpec {
         let title: String?
         let content: String
     }
 
-    /// 按中文章节正则拆分文本。无匹配时整体作为一章。
+    /// 按中文章节正则拆分文本。匹配 "第X章/节/回/卷" 格式，
+    /// 无匹配时将整篇文本作为一章处理。
     private func splitChapters(from text: String) -> [ChapterSpec] {
         let pattern = #"^(第[零一二三四五六七八九十百千万\d]+[章节回卷].*)$"#
         guard let regex = try? NSRegularExpression(pattern: pattern, options: [.anchorsMatchLines]) else {
@@ -126,7 +145,7 @@ public final class RDPlainTextBookBuilder {
 
     // MARK: - HTML 包装
 
-    /// 将纯文本包装为 HTML 段落
+    /// 将纯文本包装为 HTML 段落：每行一个 `<p>` 标签
     private func wrapTextAsHTML(_ text: String) -> String {
         let paragraphs = text.components(separatedBy: "\n").filter { !$0.isEmpty }
         let body = paragraphs.map { "<p>\($0)</p>" }.joined(separator: "\n")
@@ -135,6 +154,7 @@ public final class RDPlainTextBookBuilder {
 
     // MARK: - 文本解码
 
+    /// 解码文本文件，按优先级尝试 UTF-8 → GB18030 → GBK 编码
     private func rd_decodeTextFile(url: URL) -> String {
         if let content = try? NSString(contentsOf: url, encoding: String.Encoding.utf8.rawValue) as String {
             return content