refactor: unify document sessions close policy and resource parsing
This commit is contained in:
@@ -9,6 +9,14 @@
|
||||
|
||||
控件模块导入时不创建窗口或浏览器。欢迎页不启动 WebEngine;首次显示阅读器时使用固定的 `ReaderTabHost`,页面准备好后才切换内容。拆分模块时必须保留控件的父子关系、创建时机和显示顺序,不通过重新创建主窗口或重新挂载已显示浏览器来刷新内容。
|
||||
|
||||
## 文档、标签与资源
|
||||
|
||||
- `DocumentSession` 是编辑中文档路径、保存基准和磁盘签名的唯一来源;修改状态由当前文本与保存基准比较得出。Qt 标签属性只是界面适配数据。
|
||||
- `DocumentStore` 负责读取、文件签名和历史版本保存;`DraftStore` 负责草稿持久化。
|
||||
- `DocumentCloseController` 统一关闭标签、关闭项目和退出软件的保存 / 放弃 / 取消流程。`TabController` 只在确认成功后移除控件,保留阅读器复用逻辑。
|
||||
- `document_resources.py` 统一解析 Markdown 与 HTML 引用,提供 URL、源码位置及安全修改片段。文档检查、导出检查、文件监听和图片迁移共用该结果;代码和注释不作为资源引用。
|
||||
- 图片迁移先生成 `ImageRelocation` 计划,读取和验证全部资源,再复制文件并保存文档。保存成功后才更新文档会话。
|
||||
|
||||
## 验证约定
|
||||
|
||||
每个重构阶段独立提交。运行单元测试,并按改动范围运行 `gui_smoke.py`、`improvements_smoke.py` 和 `reliability_smoke.py`。涉及浏览器生命周期的调整必须检查欢迎页、首次打开文件、标签切换以及预览滚动;涉及保存的调整必须检查保存失败、取消、另存为和后台标签。
|
||||
|
||||
Reference in New Issue
Block a user