refactor: separate reader widgets and shared UI themes

This commit is contained in:
2026-10-29 19:09:32 +08:00
parent 8dae91c2ca
commit de362536f5
8 changed files with 947 additions and 985 deletions
+14
View File
@@ -0,0 +1,14 @@
# MDHelper 架构
## 界面与启动
- `reader_widgets.py`:阅读页面、浏览器视图、固定的阅读标签容器与桥接信号。
- `video_player.py`:视频播放控件。
- `ui_theme.py` 与 `resources/ui_*.qss`:配色、样式模板及 Windows 标题栏设置。
- `main_window.py`:应用窗口、菜单事件以及功能之间的协调。
控件模块导入时不创建窗口或浏览器。欢迎页不启动 WebEngine;首次显示阅读器时使用固定的 `ReaderTabHost`,页面准备好后才切换内容。拆分模块时必须保留控件的父子关系、创建时机和显示顺序,不通过重新创建主窗口或重新挂载已显示浏览器来刷新内容。
## 验证约定
每个重构阶段独立提交。运行单元测试,并按改动范围运行 `gui_smoke.py`、`improvements_smoke.py` 和 `reliability_smoke.py`。涉及浏览器生命周期的调整必须检查欢迎页、首次打开文件、标签切换以及预览滚动;涉及保存的调整必须检查保存失败、取消、另存为和后台标签。