43 lines
3.9 KiB
Markdown
43 lines
3.9 KiB
Markdown
# MDHelper 架构
|
|
|
|
## 界面与启动
|
|
|
|
- `reader_widgets.py`:阅读页面、浏览器视图、固定的阅读标签容器与桥接信号。
|
|
- `video_player.py`:视频播放控件。
|
|
- `ui_theme.py` 与 `resources/ui_*.qss`:配色、样式模板及 Windows 标题栏设置。
|
|
- `main_window.py`:应用窗口、菜单事件以及功能之间的协调。
|
|
|
|
控件模块导入时不创建窗口或浏览器。欢迎页不启动 WebEngine;首次显示阅读器时使用固定的 `ReaderTabHost`,页面准备好后才切换内容。拆分模块时必须保留控件的父子关系、创建时机和显示顺序,不通过重新创建主窗口或重新挂载已显示浏览器来刷新内容。
|
|
|
|
## 文档、标签与资源
|
|
|
|
- `DocumentSession` 是编辑中文档路径、保存基准和磁盘签名的唯一来源;修改状态由当前文本与保存基准比较得出。Qt 标签属性只是界面适配数据。
|
|
- `DocumentStore` 负责读取、文件签名和历史版本保存;`DraftStore` 负责草稿持久化。
|
|
- `DocumentCloseController` 统一关闭标签、关闭项目和退出软件的保存 / 放弃 / 取消流程。`TabController` 只在确认成功后移除控件,保留阅读器复用逻辑。
|
|
- `document_resources.py` 统一解析 Markdown 与 HTML 引用,提供 URL、源码位置及安全修改片段。文档检查、导出检查、文件监听和图片迁移共用该结果;代码和注释不作为资源引用。
|
|
- 图片迁移先生成 `ImageRelocation` 计划,读取和验证全部资源,再复制文件并保存文档。保存成功后才更新文档会话。
|
|
|
|
## 导出边界
|
|
|
|
`MainWindow` 持有 `ExportController`,不再继承导出实现。控制器通过 `ExportContext` 获取明确的快照、渲染、页面读取、浏览器配置和状态通知接口;不会自行访问标签页或窗口的字体、样式等内部字段。
|
|
|
|
`ExportSnapshot` 同时保存文本与 `RenderOptions`,导出期间的标签或外观变化不改变当前任务。PDF 和 MHTML 各有独立任务对象,共用 `ExportLifecycle` 的进度窗口、截止计时和页面资源就绪检查。`mhtml_archive.py` 只处理归档数据,不创建 Qt 对象。
|
|
|
|
## 配置与迁移
|
|
|
|
`preferences.py` 定义 `ReaderPreferences` 和 `ApplicationConfiguration`。本地设置与 JSON 导入共用字段、取值检查和旧版迁移规则;`ConfigurationStore` 负责持久化。页面设置保留旧版 PDF 页边距的读取方式。窗口几何状态和草稿仍由各自的界面、文档组件管理。内置文档样式集中在 `style_presets.py`。
|
|
|
|
## 编辑器边界
|
|
|
|
`markdown_editor.py` 组装编辑界面并连接文档会话。`editor_widgets.py` 负责源码控件、行号和语法高亮;`EditorFindController` 管理查找位置及可撤销替换;`EditorPreviewController` 管理预览刷新、滚动映射、桥接信号和计时器。预览控制器接收明确的控件与渲染回调,不读取主窗口或文档存储。关闭编辑器时同时停止预览刷新与滚动计时器。
|
|
|
|
## 项目目录与文件监听
|
|
|
|
`ProjectCatalog` 管理文档列表、目录签名和搜索索引。主窗口只负责把结果放到目录树中,仍在接收后台扫描结果时检查项目与代次,避免旧结果覆盖新项目。
|
|
|
|
`FileWatchService` 管理监听路径、变更签名和合并刷新计时器,通过 `WatchContext` 请求界面刷新。它不访问标签控件。内部保存完成后更新监听签名;切换或关闭项目会清理待处理事件和计时器。编辑中的内容仍由窗口的文档会话规则保护,不被磁盘刷新覆盖。
|
|
|
|
## 验证约定
|
|
|
|
每个重构阶段独立提交。运行单元测试,并按改动范围运行 `gui_smoke.py`、`improvements_smoke.py` 和 `reliability_smoke.py`。涉及浏览器生命周期的调整必须检查欢迎页、首次打开文件、标签切换以及预览滚动;涉及保存的调整必须检查保存失败、取消、另存为和后台标签。
|