feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化

- 实现EPUB阅读器搜索功能及选中注释功能
- 优化CFI模块，修复代码审查发现的11个问题
- 实现大书远距目录跳转与后台补全优化方案
- 优化设置面板与章节运行时联动
- 重构及大量改进优化

Sources/RDReaderView/EPUBCore/RDEPUBParser.swift

@@ -1,41 +1,30 @@
-// RDEPUBParser.swift
-// EPUB 解析器入口
-// 解析链路：epubURL → ZIP 解压 → container.xml → OPF → spine/TOC
-// 是 EPUBCore Publication 层的核心，解析完成后通过 makePublication() 生成 RDEPUBPublication。
-// 具体解析逻辑分散在 +Archive、+Package、+TOC、+Resources、+ReadingProfile 扩展中。
 
 import Foundation
 
-/// EPUB 解析器，执行从 epub 文件到出版物数据的完整解析流程
-/// 主链路：epubURL → extractArchiveIfNeeded → container.xml → OPF → metadata/manifest/spine/TOC
 public final class RDEPUBParser {
-    /// 出版物元数据（标题、作者、语言、布局模式等）
+
     public internal(set) var metadata = RDEPUBMetadata()
-    /// 资源清单字典（key 为 manifest item ID）
+
     public internal(set) var manifest: [String: RDEPUBManifestItem] = [:]
-    /// 阅读顺序列表（按 spine 排列的资源项）
+
     public internal(set) var spine: [RDEPUBSpineItem] = []
-    /// 目录树（从 NCX 或 Nav Document 解析得到）
+
     public internal(set) var tableOfContents: [EPUBTableOfContentsItem] = []
-    /// EPUB 解压后的根目录路径
+
     public internal(set) var extractionRootURL: URL?
-    /// OPF 文件的完整路径
+
     public internal(set) var opfURL: URL?
 
-    /// OPF 文件所在目录的 URL（用于解析相对路径）
     public var opfDirectoryURL: URL? {
         opfURL?.deletingLastPathComponent()
     }
 
     public init() {}
 
-    /// 基于当前解析结果创建 RDEPUBPublication（门面对象）
     public func makePublication() -> RDEPUBPublication {
         RDEPUBPublication(parser: self)
     }
 
-    /// 完整解析 EPUB 文件：解压 → container.xml → OPF
-    /// - Parameter epubURL: EPUB 文件的本地路径
     public func parse(epubURL: URL) throws {
         reset()
 
@@ -56,8 +45,6 @@ public final class RDEPUBParser {
         try parseOPF(at: packageURL)
     }
 
-    /// 解析 OPF 文件：metadata/manifest/spine/TOC
-    /// - Parameter opfURL: OPF 文件路径
     public func parseOPF(at opfURL: URL) throws {
         resetPublicationState()
 
@@ -81,12 +68,10 @@ public final class RDEPUBParser {
         self.tableOfContents = parseTOC(from: packageDocument, opfURL: opfURL)
     }
 
-    /// 获取已解析的目录
     public func parseTOC() -> [EPUBTableOfContentsItem] {
         tableOfContents
     }
 
-    /// 解析指定的 Navigation Document 文件
     public func parseNavDocument(_ navURL: URL, baseURL: URL? = nil) -> [EPUBTableOfContentsItem] {
         parseNavDocumentItems(at: navURL, baseURL: baseURL ?? navURL.deletingLastPathComponent())
     }