# 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 `
/
` 元数据解析对 `Archive Warnings*`、`Fandoms*` 等带星号标签不兼容的问题。 - EPUB 下载失败时增加 HTML 全文页面兜底下载,公开作品不依赖 Cookie 也可生成 txt。 - 修复下载成功判断依赖中文提示文本的问题,改为检查 `save_text_file()` 返回值与文件是否存在。 - 清理 AO3 插件中的乱码异常提示和注释,避免日志/异常不可读。 - 修复 `https://archiveofourown.org/works/86702241/chapters/229471946` 这类章节页正文提取不完整的问题:优先读取 `role="article"` 正文块,并在 ``、评论区、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 关注同步断言与当前“作者聚合提醒”行为不一致的问题,后续应单独确认该测试期望是否需要更新。