Files
SakuraHub/tests/AO3插件测试报告.md
2026-11-16 20:45:22 +08:00

5.5 KiB
Raw Permalink Blame History

AO3 插件测试与补丁报告

日期:2026-06-14

新增测试文件

  • tests/test_ao3_plugin.py

覆盖的测试项

  • AO3 URL 识别测试:只接受 archiveofourown.org / ao3.org 的 /works/{id} 与 /works/{id}/chapters/{id} 链接,拒绝伪域名和非作品页。
  • work_id / chapter_id 提取测试。
  • 无 Cookie 情况下访问公开作品的解析逻辑测试。
  • Cookie 注入 headers 测试。
  • 元数据解析 mock 测试,覆盖标题、作者、作者 ID、章节数、状态、字数、标签、更新时间。
  • EPUB 下载入口 mock 测试。
  • EPUB 失败后的 HTML 下载兜底入口 mock 测试。
  • AO3 章节页 workskin 正文提取回归测试,确认不会把 Summary 或评论区当正文。
  • 更新检测逻辑测试。
  • 云端同步 payload 生成测试。
  • 插件注册 / 加载测试,覆盖 PluginManager.load_plugin() 和 URL 到插件匹配。
  • 错误处理测试:无效链接、登录限制、网络失败。

所有 AO3 网络请求均使用 mock,没有真实访问 AO3。

修复的问题

  • 修复 AO3 URL 识别过宽的问题,避免 evilarchiveofourown.org 这类伪域名被误识别。
  • 新增 extract_ao3_ids(),统一提取 work_id 与 chapter_id。
  • parse() 增加严格 URL 校验,非 AO3 作品链接直接抛出 PluginParseError。
  • Cookie 请求头注入路径补测试,确认不会把 Cookie 误漏到无 Cookie 请求。
  • 修复 AO3 <dt>/<dd> 元数据解析对 Archive Warnings*、Fandoms* 等带星号标签不兼容的问题。
  • EPUB 下载失败时增加 HTML 全文页面兜底下载,公开作品不依赖 Cookie 也可生成 txt。
  • 修复下载成功判断依赖中文提示文本的问题,改为检查 save_text_file() 返回值与文件是否存在。
  • 清理 AO3 插件中的乱码异常提示和注释,避免日志/异常不可读。
  • 修复 https://archiveofourown.org/works/86702241/chapters/229471946 这类章节页正文提取不完整的问题:优先读取 role="article" 正文块,并在 <!--/main-->、评论区、afterword、notes 前截断,避免退回 Summary。
  • 修复手机端接收内容与桌面端下载 txt 不一致的问题:AO3 会同时产出 .txt 和 .epub,通用云同步曾把两者都按同一个小说同步,后同步的 EPUB 会覆盖云端 Novel 的 file_id。现在小说资源只同步 .txt 正文给手机端,EPUB 仅本地归档。

测试命令

Python / AO3:

& 'C:\Users\LENOVO\AppData\Local\Python\pythoncore-3.14-64\python.exe' -m py_compile plugins\ao3\plugin.py tests\test_ao3_plugin.py
& 'C:\Users\LENOVO\AppData\Local\Python\pythoncore-3.14-64\python.exe' -m py_compile pixiv_app\gui\app.py plugins\ao3\plugin.py
& 'C:\Users\LENOVO\AppData\Local\Python\pythoncore-3.14-64\python.exe' -m unittest tests.test_ao3_plugin
& 'C:\Users\LENOVO\AppData\Local\Python\pythoncore-3.14-64\python.exe' -m unittest tests.test_ao3_plugin tests.test_plugin_manager
& 'C:\Users\LENOVO\AppData\Local\Python\pythoncore-3.14-64\python.exe' -m unittest discover tests

当前仓库未发现统一的一键全项目测试命令。本次重点运行与 AO3 插件和插件加载机制直接相关的 Python unittest,并额外尝试了 unittest discover tests。

可选的其他模块测试方式:

# Python 其他测试
& 'C:\Users\LENOVO\AppData\Local\Python\pythoncore-3.14-64\python.exe' -m unittest discover tests

# Flutter 移动端
cd sakura_mobile
flutter analyze
flutter test

# Web 前端(如存在 package.json)
npm install
npm run build

测试结果

  • py_compile plugins\ao3\plugin.py tests\test_ao3_plugin.py:通过。
  • py_compile pixiv_app\gui\app.py plugins\ao3\plugin.py:通过。
  • python -m unittest tests.test_ao3_plugin:通过,12 个测试 OK。
  • python -m unittest tests.test_ao3_plugin tests.test_plugin_manager:通过,13 个测试 OK。
  • 使用用户提供的 AO3 页面源码本地验证 _extract_html_work_text():提取 5971 个字符、57 段;开头为正文“手机的铃声在深夜响起…”,不包含 Summary: 与评论区内容。
  • python -m unittest discover tests:未全量通过,44 个测试中 1 个既有测试失败。

全量 discover 失败项:

  • tests.test_origin_follow_sync.OriginFollowSyncLocalTest.test_gallery_sync_creates_cloud_alert_for_new_pixiv_work
  • 失败原因:测试期望 target_url 包含作品 ID 67890,当前实现返回作者页 https://www.pixiv.net/users/12345。这与 Pixiv 更新提醒已改为“按作者聚合 alert”的行为一致,和 AO3 插件补丁无直接关系。

测试期间出现环境依赖警告:

  • RequestsDependencyWarning: urllib3/chardet/charset_normalizer doesn't match a supported version

该警告来自当前 Python 环境的 requests 依赖组合,不是 AO3 测试失败。

仍然存在的风险

  • AO3 页面结构如果后续大改,纯 HTML 正则解析可能需要更新。
  • EPUB 内容提取目前是轻量实现,复杂 EPUB spine 顺序或特殊 XHTML 结构可能需要更完整的 EPUB 解析。
  • 更新检测当前返回 has_update=True,实际“是否比本地更新”的判定仍由调用方结合本地记录完成。
  • 未在本轮运行 Flutter、Web 前端、云端服务集成测试;本次补丁范围限定在 AO3 插件框架与插件加载测试。
  • Python 全量 discover 存在 1 个既有 Pixiv 关注同步断言与当前“作者聚合提醒”行为不一致的问题,后续应单独确认该测试期望是否需要更新。