Files

95 lines
5.5 KiB
Markdown
Raw Permalink Normal View History

2026-11-16 20:45:22 +08:00
# 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 关注同步断言与当前“作者聚合提醒”行为不一致的问题,后续应单独确认该测试期望是否需要更新。