refactor: compose export controller with explicit snapshots and task lifecycle

This commit is contained in:
2026-10-29 19:26:11 +08:00
parent f27482857a
commit a7a5e29cba
11 changed files with 527 additions and 365 deletions
+6
View File
@@ -17,6 +17,12 @@
- `document_resources.py` 统一解析 Markdown 与 HTML 引用,提供 URL、源码位置及安全修改片段。文档检查、导出检查、文件监听和图片迁移共用该结果;代码和注释不作为资源引用。
- 图片迁移先生成 `ImageRelocation` 计划,读取和验证全部资源,再复制文件并保存文档。保存成功后才更新文档会话。
## 导出边界
`MainWindow` 持有 `ExportController`,不再继承导出实现。控制器通过 `ExportContext` 获取明确的快照、渲染、页面读取、浏览器配置和状态通知接口;不会自行访问标签页或窗口的字体、样式等内部字段。
`ExportSnapshot` 同时保存文本与 `RenderOptions`,导出期间的标签或外观变化不改变当前任务。PDF 和 MHTML 各有独立任务对象,共用 `ExportLifecycle` 的进度窗口、截止计时和页面资源就绪检查。`mhtml_archive.py` 只处理归档数据,不创建 Qt 对象。
## 验证约定
每个重构阶段独立提交。运行单元测试,并按改动范围运行 `gui_smoke.py`、`improvements_smoke.py` 和 `reliability_smoke.py`。涉及浏览器生命周期的调整必须检查欢迎页、首次打开文件、标签切换以及预览滚动;涉及保存的调整必须检查保存失败、取消、另存为和后台标签。