feat: restore project workspace with lazy background tabs

This commit is contained in:
2026-10-29 21:07:12 +08:00
parent 18c97cd445
commit 2441279e8d
4 changed files with 252 additions and 0 deletions
+122
View File
@@ -59,6 +59,7 @@ from .preferences import ReaderPreferences, ApplicationConfiguration, Configurat
from .document_session import DocumentStore, DraftStore, DocumentCloseController, CloseChoice
from .document_resources import analyze_document
from .tab_controller import TabController, document_path
from .workspace_state import WorkspaceStore, TabState
from .reader_widgets import ReaderPage, ReaderBridge, ReaderView, ReaderTabHost, CompactTreeDelegate
from .video_player import VideoPlayerWidget
from .ui_theme import navigation_theme, apply_title_bar_style
@@ -140,6 +141,9 @@ class MainWindow(QMainWindow):
self._startup_initial_path = initial_path
self._startup_prompt = prompt_for_project
self.settings = QSettings("MDHelper", "MDHelper")
self.workspaces = WorkspaceStore(self.settings)
self._workspace_restored = False
self._restoring_workspace = False
self.configurations = ConfigurationStore(self.settings)
self.documents = DocumentStore()
self.drafts = DraftStore(self.settings, self.documents)
@@ -389,6 +393,12 @@ class MainWindow(QMainWindow):
file_menu.addSeparator()
file_menu.addAction(self.clear_recent_action)
self.restore_workspace_action = QAction("启动时恢复工作现场", self)
self.restore_workspace_action.setCheckable(True)
self.restore_workspace_action.setChecked(self.settings.value("workspace/restore", True, type=bool))
self.restore_workspace_action.toggled.connect(lambda enabled: self.settings.setValue("workspace/restore", enabled))
file_menu.addAction(self.restore_workspace_action)
self.exit_action = QAction("退出", self)
self.exit_action.setShortcut("Ctrl+Q")
self.exit_action.triggered.connect(self.close)
@@ -813,6 +823,21 @@ class MainWindow(QMainWindow):
LOGGER.debug("Reader prewarm requested")
def prepare_reader_before_show(self, timeout_ms: int = 8000) -> None:
self._prepare_reader_before_show(timeout_ms)
if not self.isVisible() and not self._workspace_restored and self._startup_initial_path is None:
self._restore_workspace()
editor = self.tabs.currentWidget()
if isinstance(editor, RichMarkdownEditorDialog) and editor.preview.page().isLoading():
loop, deadline = QEventLoop(self), QTimer(self)
deadline.setSingleShot(True)
deadline.timeout.connect(loop.quit)
editor.preview.loadFinished.connect(loop.quit)
deadline.start(timeout_ms)
loop.exec()
deadline.stop()
editor.preview.loadFinished.disconnect(loop.quit)
def _prepare_reader_before_show(self, timeout_ms: int = 8000) -> None:
if self.isVisible():
return
self._prewarm_reader_view()
@@ -1239,9 +1264,14 @@ class MainWindow(QMainWindow):
app.setWindowIcon(icon)
def _on_tab_changed(self, index: int) -> None:
if self._restoring_workspace:
return
widget = self.tabs.widget(index)
if widget is None:
return
if getattr(widget, "workspace_state", None) is not None:
self._load_workspace_tab(widget)
return
if bool(widget.property("is_welcome")):
self.current_file = None
self.current_fragment = ""
@@ -1840,9 +1870,13 @@ class MainWindow(QMainWindow):
return True
def close_project_folder(self) -> None:
snapshot = self._workspace_snapshot()
if not self._close_all_tabs(show_welcome=False):
return
if self.has_project:
self.workspaces.save(self.project_root, *snapshot)
self._startup_generation += 1
self._startup_scan_pending = False
self.has_project = False
@@ -1893,8 +1927,11 @@ class MainWindow(QMainWindow):
def set_project_root(self, project_root: Path, save: bool = True) -> bool:
project_root = project_root.resolve()
root_changed = self.has_project and project_root != self.project_root.resolve()
snapshot = self._workspace_snapshot() if root_changed else None
if root_changed and not self._close_all_tabs(show_welcome=False):
return False
if snapshot is not None:
self.workspaces.save(self.project_root, *snapshot)
self._startup_generation += 1
self._startup_scan_pending = False
@@ -4162,6 +4199,8 @@ class MainWindow(QMainWindow):
if not self._confirm_window_close():
event.ignore()
return
if self.has_project and not self._restoring_workspace:
self.workspaces.save(self.project_root, *self._workspace_snapshot())
self.exports.cancel_all()
self.watch.reset()
self.directory_poll_timer.stop()
@@ -4180,6 +4219,89 @@ class MainWindow(QMainWindow):
self._save_preferences()
super().closeEvent(event)
def _workspace_snapshot(self):
states, active = [], 0
if not hasattr(self, "tabs"):
return states, active
for index in range(self.tabs.count()):
widget = self.tabs.widget(index)
path = document_path(widget)
if path is None or not path.is_file():
continue
state = getattr(widget, "workspace_state", None)
if state is None:
state = TabState(str(path), isinstance(widget, RichMarkdownEditorDialog))
state.scroll = int(self.scroll_positions.get(str(path), 0))
if state.editing:
state.view = widget.view_mode_box.currentData()
state.sync = widget.sync_scroll_checkbox.isChecked()
state.cursor = widget.editor.textCursor().position()
state.source_scroll = widget.editor.verticalScrollBar().value()
state.sizes = widget.splitter.sizes()
if index == self.tabs.currentIndex():
active = len(states)
states.append(state)
return states, active
def _restore_workspace(self) -> bool:
self._workspace_restored = True
if not self.has_project or not self.settings.value("workspace/restore", True, type=bool):
return False
states, active = self.workspaces.load(self.project_root)
if not states or self._has_open_content_tabs():
return False
seed = self.tabs.currentWidget()
if not isinstance(seed, ReaderTabHost):
return False
self._restoring_workspace = True
try:
with QSignalBlocker(self.tabs):
for index, state in enumerate(states):
host = seed if index == active else ReaderTabHost()
if host is not seed:
self.tabs.insertTab(index, host, Path(state.path).name)
host.workspace_state = state
host.setProperty("current_file", state.path)
host.setProperty("is_welcome", False)
host.welcome_view.setPlainText("选择此标签时加载文档。")
self.tabs.setTabText(self.tabs.indexOf(host), Path(state.path).name)
self.scroll_positions[state.path] = state.scroll
self.tabs.setCurrentIndex(active)
finally:
self._restoring_workspace = False
self._load_workspace_tab(self.tabs.currentWidget())
return True
def _load_workspace_tab(self, host) -> None:
state = host.workspace_state
path = Path(state.path)
if not path.is_file():
host.welcome_view.setPlainText(f"文件已不存在:\n{path}")
return
host.workspace_state = None
if host.reader_view is None:
host.set_reader_view(self._create_reader_view())
self._standby_reader_view = None
host.reader_view.setProperty("is_reader_standby", False)
self.current_file = path
if path.suffix.lower() in {".md", ".markdown"} or is_code_document(path):
self.open_document(path, add_history=False, scroll_y=state.scroll)
elif path.suffix.lower() in {".html", ".htm", ".xhtml"}:
self._open_webpage_file_now(path)
else:
self._open_preview_file_now(path)
if state.editing:
self.edit_current_markdown()
editor = self.tabs.currentWidget()
if isinstance(editor, RichMarkdownEditorDialog):
editor.sync_scroll_checkbox.setChecked(state.sync)
editor.view_mode_box.setCurrentIndex(editor.view_mode_box.findData(state.view))
editor.splitter.setSizes(state.sizes)
cursor = editor.editor.textCursor()
cursor.setPosition(min(state.cursor, editor.editor.document().characterCount() - 1))
editor.editor.setTextCursor(cursor)
QTimer.singleShot(0, editor, lambda: editor.editor.verticalScrollBar().setValue(state.source_scroll))
@property
def editor_drafts(self) -> dict:
return self.drafts.entries
+67
View File
@@ -0,0 +1,67 @@
"""Validated per-project tab snapshots; background tabs contain no browsers."""
from __future__ import annotations
import hashlib
import json
from dataclasses import asdict, dataclass, field
from pathlib import Path
@dataclass
class TabState:
path: str
editing: bool = False
view: str = "split"
sync: bool = True
cursor: int = 0
source_scroll: int = 0
scroll: int = 0
sizes: list[int] = field(default_factory=lambda: [560, 560])
@classmethod
def read(cls, data, root):
if not isinstance(data, dict) or not isinstance(data.get("path"), str):
return None
try:
path = Path(data["path"]).resolve()
if not path.is_file() or not path.is_relative_to(root.resolve()):
return None
state = cls(str(path), data.get("editing") is True and path.suffix.lower() in {".md", ".markdown"})
state.view = data.get("view") if data.get("view") in ("source", "preview", "split") else "split"
state.sync = data.get("sync", True) is not False
for key in ("cursor", "source_scroll", "scroll"):
setattr(state, key, max(0, int(data.get(key, 0))))
sizes = data.get("sizes")
if isinstance(sizes, list) and len(sizes) == 2 and all(isinstance(v, int) and 0 <= v <= 100000 for v in sizes):
state.sizes = sizes
return state
except (OSError, ValueError, TypeError, OverflowError):
return None
class WorkspaceStore:
def __init__(self, settings):
self.settings = settings
@staticmethod
def key(root: Path) -> str:
return "workspace/" + hashlib.sha256(str(root.resolve()).casefold().encode()).hexdigest()
def save(self, root: Path, tabs: list[TabState], current: int) -> None:
self.settings.setValue(self.key(root), json.dumps({"tabs": [asdict(tab) for tab in tabs], "current": current}, ensure_ascii=False))
def load(self, root: Path):
try:
payload = json.loads(str(self.settings.value(self.key(root), "{}")))
if not isinstance(payload, dict) or not isinstance(payload.get("tabs", []), list):
return [], 0
tabs, active = [], 0
selected = int(payload.get("current", 0))
for index, item in enumerate(payload.get("tabs", [])[:100]):
state = TabState.read(item, root)
if state:
if index == selected:
active = len(tabs)
tabs.append(state)
return tabs, active
except (ValueError, TypeError, AttributeError, OverflowError):
return [], 0