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

96 lines
5.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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:
```powershell
& '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`。
可选的其他模块测试方式:
```powershell
# 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 关注同步断言与当前“作者聚合提醒”行为不一致的问题,后续应单独确认该测试期望是否需要更新。