refactor: clarify CSS cascade conversion and archive resource processing

This commit is contained in:
2026-10-29 20:00:31 +08:00
parent 0a1f356150
commit 18c97cd445
7 changed files with 229 additions and 175 deletions
+8
View File
@@ -37,6 +37,14 @@
`FileWatchService` 管理监听路径、变更签名和合并刷新计时器,通过 `WatchContext` 请求界面刷新。它不访问标签控件。内部保存完成后更新监听签名;切换或关闭项目会清理待处理事件和计时器。编辑中的内容仍由窗口的文档会话规则保护,不被磁盘刷新覆盖。
## CSS 与离线归档
CSS 同步按三个步骤处理:`_collect_cascade` 决定生效的声明,`_CoreRuleReader` 转换可表达的字体和段落属性,`analyze_css` 汇总结果。无法映射的 CSS 继续保留原文,不改写级联规则或 Word 的支持范围。
MHTML 的浏览器加载与归档转换分开。`mhtml_archive.py` 分别处理资源标识、CSS 依赖、HTML 引用和 MIME 编码;入口 `portable_archive` 只组织这些步骤,保留原有本地字体嵌入与缺失资源检查。
## 验证约定
每个重构阶段独立提交。运行单元测试,并按改动范围运行 `gui_smoke.py`、`improvements_smoke.py` 和 `reliability_smoke.py`。涉及浏览器生命周期的调整必须检查欢迎页、首次打开文件、标签切换以及预览滚动;涉及保存的调整必须检查保存失败、取消、另存为和后台标签。
`startup_smoke.py` 验证从启动到首次打开文件只有一次主窗口显示、没有隐藏或窗口句柄变化,阅读器保持固定父容器。设置 `MDHELPER_SMOKE_NATIVE=1` 可在真实 Windows 窗口后端执行。`pdf_export_smoke.py` 检查实际 PDF 输出。