feat: 支持 EPUB 阅读并改善规则兼容与阅读稳定性

支持 EPUB 2/3 导入、目录、封面和章节插图，保留本地书管理与阅读进度。修复 JSON 模板、动态替换与请求参数兼容，以及 RSS 翻页和连续滚动定位。更新编辑器工具栏和回归测试，发布版本为 0.1.12（build 18）。
2026-10-24 21:01:22 +08:00 · 2026-10-24 00:58:11 +08:00
parent 3322fd71db
commit 67bc212ffd
58 changed files with 2331 additions and 244 deletions
@@ -23,6 +23,10 @@ final class FixtureAppDelegate: UIResponder, UIApplicationDelegate {
            try? Data("第一章 开始\n这是用于验证本地 TXT 导入的小说正文。\n第二章 后续\n正文继续。".utf8)
                .write(to: documents.appendingPathComponent(name), options: .atomic)
        }
+        if let epub = Bundle.main.url(forResource: "EPUB-Book", withExtension: "epub"),
+           let data = try? Data(contentsOf: epub) {
+            try? data.write(to: documents.appendingPathComponent("EPUB-Book.epub"), options: .atomic)
+        }
        let controller = UIViewController()
        controller.view.backgroundColor = .systemBackground
        let label = UILabel()
@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+"""Generate an original EPUB 3 fixture for Files import and reader UI tests."""
+import base64
+import sys
+import zipfile
+from pathlib import Path
+
+output = Path(sys.argv[1])
+output.parent.mkdir(parents=True, exist_ok=True)
+with zipfile.ZipFile(output, "w") as archive:
+    archive.writestr("mimetype", "application/epub+zip", compress_type=zipfile.ZIP_STORED)
+    files = {
+        "META-INF/container.xml": '<container xmlns="urn:oasis:names:tc:opendocument:xmlns:container"><rootfiles><rootfile full-path="OPS/book.opf"/></rootfiles></container>',
+        "OPS/book.opf": '''<package xmlns="http://www.idpf.org/2007/opf" version="3.0" unique-identifier="id">
+          <metadata xmlns:dc="http://purl.org/dc/elements/1.1/"><dc:identifier id="id">legado-ui-epub</dc:identifier><dc:title>EPUB 导入测试</dc:title><dc:creator>测试作者</dc:creator><dc:language>zh</dc:language><meta property="dcterms:modified">2026-10-23T00:00:00Z</meta></metadata>
+          <manifest><item id="nav" href="nav.xhtml" media-type="application/xhtml+xml" properties="nav"/><item id="body" href="chapter.xhtml" media-type="application/xhtml+xml"/><item id="image" href="cover.png" media-type="image/png" properties="cover-image"/></manifest>
+          <spine><itemref idref="body"/></spine></package>''',
+        "OPS/nav.xhtml": '''<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops"><head><title>目录</title></head><body><nav epub:type="toc"><ol><li><a href="chapter.xhtml#one">第一章 EPUB</a></li><li><a href="chapter.xhtml#two">第二章 EPUB</a></li></ol></nav></body></html>''',
+        "OPS/chapter.xhtml": '''<html xmlns="http://www.w3.org/1999/xhtml"><head><title>EPUB 正文</title></head><body><section><h1 id="one">第一章 EPUB</h1><p>这是 EPUB 导入后的第一章正文。</p><img src="cover.png" alt="测试插图"/></section><section><h1 id="two">第二章 EPUB</h1><p>这是 EPUB 的第二章正文，目录锚点跳转成功。</p></section></body></html>''',
+    }
+    for name, contents in files.items():
+        archive.writestr(name, contents.encode("utf-8"), compress_type=zipfile.ZIP_DEFLATED)
+    archive.writestr("OPS/cover.png", base64.b64decode("iVBORw0KGgoAAAANSUhEUgAAAEAAAABgCAIAAAAip+O/AAABxklEQVR4nNXCA3YjAABF0becsW12bNdIGptt7Nq2bXeMjc06/j2XI8UG6RwtMUrnWGmtdI6XmaRzotwsnZMVFumcqrRK53SVTTpnqu3SOVvjkM45g1M6540u6VyodUvnoskjnUtmr3QuW3zSuWL1S+eqLSCda/agdK47QtK54QxL56arTjq33PXSue2JSOeONyqdu76YdO7549K5H0hI50EwKZ2HoZR0isJp6Tyqy0jncX1WOk8iOek8jeal8yxWkM7zeIN0XiQapfMy2SSdV6lm6bxOt0jnTaZVOm+zbdJ5l2uXzvt8h3Q+FDql87GhSzqfGrul87mpRzpfmnulU9zSJ52S1n7plLYNSKesfVA65R1D0qnoHJZOZdeIdKq6R6VT3TMmnZrecekY+iakY+yflE7twJR0TIPT0jEPzUjHMjwrHevInHRso/PSsY8tSMcxvigd58SSdFyTy9JxT61IxzO9Kh3vzJp0fLPr0vHPbUgnML8pneDClnRCi9vSCS/tSKdueVc69St70oms7ksnunYgndj6oXTiG1+lk9j8Jp3k1nfppLZ/SCe981M6md1f0snu/ZZObv+PdPIHf6VTOPwn/T/zbe3/96qaXAAAAABJRU5ErkJggg=="))
@@ -0,0 +1,44 @@
+"""Local, synthetic RSS responses for the LegadoRSSFlowUITests scheme."""
+
+import http.server
+import json
+import urllib.parse
+
+BASE_URL = "http://127.0.0.1:18763"
+
+
+class Fixture(http.server.BaseHTTPRequestHandler):
+    def do_GET(self):
+        parsed = urllib.parse.urlsplit(self.path)
+        query = urllib.parse.parse_qs(parsed.query)
+        key = query.get("key", [""])[0]
+        page = query.get("page", ["1"])[0]
+        if parsed.path == "/source.json":
+            payload = {
+                "sourceUrl": BASE_URL,
+                "sourceName": "RSS 全流程测试",
+                "sortUrl": "全部::" + BASE_URL + "/feed?page={{page}}",
+                "searchUrl": BASE_URL + "/feed?key={{key}}&page={{page}}",
+                "ruleArticles": "$.items",
+                "ruleTitle": "$.title",
+                "ruleLink": "$.link",
+                "ruleDescription": "$.description",
+                "ruleNextPage": "PAGE",
+            }
+        else:
+            title = f"搜索结果 {key} 第{page}页" if key else "首页文章"
+            payload = {"items": [{
+                "title": title,
+                "link": BASE_URL + "/article/" + key + "/" + page,
+                "description": "<p>这是用于全流程测试的自造订阅正文。</p>",
+            }]}
+        body = json.dumps(payload, ensure_ascii=False).encode()
+        self.send_response(200)
+        self.send_header("Content-Type", "application/json; charset=utf-8")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+
+if __name__ == "__main__":
+    http.server.ThreadingHTTPServer(("127.0.0.1", 18763), Fixture).serve_forever()
@@ -40,6 +40,7 @@ xcrun --sdk iphonesimulator swiftc -parse-as-library -swift-version 6 \
    -module-cache-path "$legado_fixture_repo/DerivedData/ModuleCache.noindex" \
    "$legado_fixture_repo/scripts/fixtures/SourceImportFixture.swift" \
    -o "$legado_fixture_app/SourceImportFixtures"
+python3 "$legado_fixture_repo/scripts/fixtures/make-epub.py" "$legado_fixture_app/EPUB-Book.epub"
 xcrun simctl install "$legado_fixture_device" "$legado_fixture_app"
 xcrun simctl launch --terminate-running-process "$legado_fixture_device" com.epiboly.legado.source-import-fixtures
-printf 'JSON and TXT import fixtures are ready in Files > On My iPhone > 书源导入测试.\n'
+printf 'JSON, TXT and EPUB import fixtures are ready in Files > On My iPhone > 书源导入测试.\n'