startlive 1.2.1__py3-none-any.whl

StartLive.py

@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+
+import sys
+from argparse import ArgumentParser, SUPPRESS
+from pathlib import Path
+from platform import system
+
+_velopack_first_run = False
+
+
+def _on_velopack_first_run(_version) -> None:
+    global _velopack_first_run
+    _velopack_first_run = True
+
+
+def _run_velopack_hooks() -> None:
+    """Run installer hooks on platforms managed by Velopack."""
+    if system() == "Linux":
+        return
+
+    from velopack import App
+
+    App().on_first_run(_on_velopack_first_run).run()
+
+
+def main() -> int:
+    from src.core.constant import VERSION
+
+    parser = ArgumentParser(prog="startlive")
+    parser.add_argument("--version", action="version",
+                        version=f"StartLive {VERSION}")
+
+    parser.add_argument(
+        "--web.host",
+        dest="web_host",
+        default=None,
+        help="Host address for the web server",
+    )
+    parser.add_argument(
+        "--web.port",
+        dest="web_port",
+        type=int,
+        default=None,
+        help="Port for the web server",
+    )
+
+    # 兼容旧 Squirrel 启动参数。
+    parser.add_argument(
+        "--squirrel-firstrun",
+        dest="squirrel_first_run",
+        action="store_true",
+        help=SUPPRESS,
+    )
+
+    parser.add_argument(
+        "--noupdate",
+        dest="no_update",
+        action="store_true",
+    )
+
+    args, qt_args = parser.parse_known_args()
+
+    # 将较重的应用模块放在 Velopack 启动处理之后导入，
+    # 可以避免安装/更新钩子执行时初始化完整 UI。
+    from PySide6.QtGui import QFont, QIcon
+    from PySide6.QtWidgets import QApplication
+    from qdarktheme import enable_hi_dpi
+
+    from src.PySide.classes import ErrorCenter, install_exception_handlers
+    from src.PySide.window import MainWindow
+    from src.core import app_state
+
+    if MainWindow.is_another_instance_running():
+        return 0
+
+    if system() == "Windows":
+        font_size = 9
+        icon_file = "icon_left.ico"
+    else:
+        font_size = 12
+        icon_file = "icon_left_macOS.ico"
+
+    first_run = _velopack_first_run or args.squirrel_first_run
+
+    enable_hi_dpi()
+    app = QApplication([sys.argv[0], *qt_args])
+    # %LocalAppData%/StartLive in velopack and squirrel.windows
+    base_path = Path(__file__).resolve().parent
+    app.setWindowIcon(
+        QIcon(str(base_path / "resources" / icon_file))
+    )
+
+    if (
+            (font := app_state.app_settings["custom_font"])
+            and (custom_font := QFont()).fromString(font)
+    ):
+        app.setFont(custom_font)
+    else:
+        app.setFont(
+            QFont(
+                "Open Sans,.AppleSystemUIFont,Helvetica,"
+                "Arial,MS Shell Dlg,sans-serif",
+                font_size,
+            )
+        )
+
+    window = MainWindow(
+        args.web_host,
+        args.web_port,
+        first_run,
+        args.no_update,
+        base_path=base_path,
+    )
+    error_center = ErrorCenter()
+    install_exception_handlers(error_center)
+
+    window.apply_color_scheme(
+        app.styleHints().colorScheme()
+    )
+    app.styleHints().colorSchemeChanged.connect(
+        window.apply_color_scheme
+    )
+
+    window.show()
+    return app.exec()
+
+
+def cli() -> int:
+    """Entry point for installations managed by pip or uv tool."""
+    from src.core import cache, runtime
+
+    runtime.package_managed = True
+    cache._cache_dir.clear()
+    return main()
+
+
+if __name__ == "__main__":
+    # 必须在单实例检查、Qt 初始化和其他正常启动逻辑之前运行。
+    # 安装、更新或卸载期间，Velopack 可能在这里直接终止进程。
+    _run_velopack_hooks()
+
+    sys.exit(main())

resources/dark-home.svg

@@ -0,0 +1,9 @@
+<?xml version="1.0"?>
+<svg width="24" height="24" xmlns="http://www.w3.org/2000/svg"
+>
+    <g class="layer">
+        <title>Layer 1</title>
+        <path d="m12,5.69l5,4.5l0,7.81l-2,0l0,-6l-6,0l0,6l-2,0l0,-7.81l5,-4.5m0,-2.69l-10,9l3,0l0,8l6,0l0,-6l2,0l0,6l6,0l0,-8l3,0"
+              fill="#ffffff" id="svg_1"/>
+    </g>
+</svg>

resources/dark-log.svg

@@ -0,0 +1,9 @@
+<?xml version="1.0"?>
+<svg width="24" height="24" xmlns="http://www.w3.org/2000/svg"
+>
+    <g class="layer">
+        <title>Layer 1</title>
+        <path d="m9,3c-3.31,0 -5.86,2.69 -6,6l0,12l9,0l0,-7.54c1.1,0.99 2.5,1.54 4,1.54c3.31,0 6,-2.69 6,-6c0,-3.31 -2.69,-6 -6,-6l-7,0m0,2l2.54,0c-0.99,1.1 -1.54,2.5 -1.54,4l0,3l-1,0l0,1l1,0l0,6l-5,0l0,-6l1,0l0,-1l-1,0l0,-3c0,-2.21 1.79,-4 4,-4m7,0c2.21,0 4,1.79 4,4c0,2.21 -1.79,4 -4,4c-2.21,0 -4,-1.79 -4,-4c0,-2.21 1.79,-4 4,-4m0,2.25c-0.97,0 -1.75,0.78 -1.75,1.75c0,0.97 0.78,1.75 1.75,1.75c0.97,0 1.75,-0.78 1.75,-1.75c0,-0.97 -0.78,-1.75 -1.75,-1.75m-9,4.75l0,1l1,0l0,-1l-1,0z"
+              fill="#ffffff" id="svg_1"/>
+    </g>
+</svg>

resources/dark-menu.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0"?>
+<svg width="24" height="24" xmlns="http://www.w3.org/2000/svg">
+    <g class="layer">
+        <title>Layer 1</title>
+        <path d="m3,6l18,0l0,2l-18,0l0,-2m0,5l18,0l0,2l-18,0l0,-2m0,5l18,0l0,2l-18,0l0,-2z" fill="#ffffff" id="svg_1"/>
+    </g>
+</svg>

resources/dark-settings.svg

@@ -0,0 +1,9 @@
+<?xml version="1.0"?>
+<svg width="24" height="24" xmlns="http://www.w3.org/2000/svg"
+>
+    <g class="layer">
+        <title>Layer 1</title>
+        <path d="m12,8a4,4 0 0 1 4,4a4,4 0 0 1 -4,4a4,4 0 0 1 -4,-4a4,4 0 0 1 4,-4m0,2a2,2 0 0 0 -2,2a2,2 0 0 0 2,2a2,2 0 0 0 2,-2a2,2 0 0 0 -2,-2m-2,12c-0.25,0 -0.46,-0.18 -0.5,-0.42l-0.37,-2.65c-0.63,-0.25 -1.17,-0.59 -1.69,-0.99l-2.49,1.01c-0.22,0.08 -0.49,0 -0.61,-0.22l-2,-3.46c-0.13,-0.22 -0.07,-0.49 0.12,-0.64l2.11,-1.66l-0.07,-0.97l0.07,-1l-2.11,-1.63c-0.19,-0.15 -0.25,-0.42 -0.12,-0.64l2,-3.46c0.12,-0.22 0.39,-0.31 0.61,-0.22l2.49,1c0.52,-0.39 1.06,-0.73 1.69,-0.98l0.37,-2.65c0.04,-0.24 0.25,-0.42 0.5,-0.42l4,0c0.25,0 0.46,0.18 0.5,0.42l0.37,2.65c0.63,0.25 1.17,0.59 1.69,0.98l2.49,-1c0.22,-0.09 0.49,0 0.61,0.22l2,3.46c0.13,0.22 0.07,0.49 -0.12,0.64l-2.11,1.63l0.07,1l-0.07,1l2.11,1.63c0.19,0.15 0.25,0.42 0.12,0.64l-2,3.46c-0.12,0.22 -0.39,0.31 -0.61,0.22l-2.49,-1c-0.52,0.39 -1.06,0.73 -1.69,0.98l-0.37,2.65c-0.04,0.24 -0.25,0.42 -0.5,0.42l-4,0m1.25,-18l-0.37,2.61c-1.2,0.25 -2.26,0.89 -3.03,1.78l-2.41,-1.04l-0.75,1.3l2.11,1.55c-0.4,1.17 -0.4,2.44 0,3.6l-2.12,1.56l0.75,1.3l2.43,-1.04c0.77,0.88 1.82,1.52 3.01,1.76l0.37,2.62l1.52,0l0.37,-2.61c1.19,-0.25 2.24,-0.89 3.01,-1.77l2.43,1.04l0.75,-1.3l-2.12,-1.55c0.4,-1.17 0.4,-2.44 0,-3.61l2.11,-1.55l-0.75,-1.3l-2.41,1.04c-0.77,-0.89 -1.83,-1.53 -3.03,-1.77l-0.37,-2.62l-1.5,0z"
+              fill="#ffffff" id="svg_1"/>
+    </g>
+</svg>

resources/dark-theme.svg

@@ -0,0 +1,9 @@
+<?xml version="1.0"?>
+<svg width="24" height="24" xmlns="http://www.w3.org/2000/svg"
+>
+    <g class="layer">
+        <title>Layer 1</title>
+        <path d="m7.5,2c-1.79,1.15 -3,3.18 -3,5.5c0,2.32 1.21,4.35 3.03,5.5c-3.07,0 -5.53,-2.46 -5.53,-5.5a5.5,5.5 0 0 1 5.5,-5.5m11.57,1.5l1.43,1.43l-15.57,15.57l-1.43,-1.43l15.57,-15.57m-6.18,2.43l-1.48,-0.93l-1.44,1l0.42,-1.7l-1.39,-1.06l1.75,-0.12l0.58,-1.65l0.67,1.63l1.73,0.03l-1.35,1.13l0.51,1.67m-3.3,3.61l-1.16,-0.73l-1.12,0.78l0.34,-1.32l-1.09,-0.83l1.36,-0.09l0.45,-1.29l0.51,1.27l1.36,0.03l-1.05,0.87l0.4,1.31m9.41,3.96a5.5,5.5 0 0 1 -5.5,5.5c-1.22,0 -2.35,-0.4 -3.26,-1.07l7.69,-7.69c0.67,0.91 1.07,2.04 1.07,3.26m-4.4,6.58l2.77,-1.15l-0.24,3.35l-2.53,-2.2m4.33,-2.7l1.15,-2.77l2.2,2.54l-3.35,0.23m1.15,-4.96l-1.14,-2.78l3.34,0.24l-2.2,2.54m-10.45,6.51l2.77,1.15l-2.53,2.19l-0.24,-3.34z"
+              fill="#ffffff" id="svg_1"/>
+    </g>
+</svg>

resources/light-home.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+    <path d="M12 5.69L17 10.19V18H15V12H9V18H7V10.19L12 5.69M12 3L2 12H5V20H11V14H13V20H19V12H22"/>
+</svg>

resources/light-log.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+    <path d="M9 3C5.69 3 3.14 5.69 3 9V21H12V13.46C13.1 14.45 14.5 15 16 15C19.31 15 22 12.31 22 9C22 5.69 19.31 3 16 3H9M9 5H11.54C10.55 6.1 10 7.5 10 9V12H9V13H10V19H5V13H6V12H5V9C5 6.79 6.79 5 9 5M16 5C18.21 5 20 6.79 20 9C20 11.21 18.21 13 16 13C13.79 13 12 11.21 12 9C12 6.79 13.79 5 16 5M16 7.25C15.03 7.25 14.25 8.03 14.25 9C14.25 9.97 15.03 10.75 16 10.75C16.97 10.75 17.75 9.97 17.75 9C17.75 8.03 16.97 7.25 16 7.25M7 12V13H8V12H7Z"/>
+</svg>

resources/light-menu.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+    <path d="M3,6H21V8H3V6M3,11H21V13H3V11M3,16H21V18H3V16Z"/>
+</svg>

resources/light-settings.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+    <path d="M12,8A4,4 0 0,1 16,12A4,4 0 0,1 12,16A4,4 0 0,1 8,12A4,4 0 0,1 12,8M12,10A2,2 0 0,0 10,12A2,2 0 0,0 12,14A2,2 0 0,0 14,12A2,2 0 0,0 12,10M10,22C9.75,22 9.54,21.82 9.5,21.58L9.13,18.93C8.5,18.68 7.96,18.34 7.44,17.94L4.95,18.95C4.73,19.03 4.46,18.95 4.34,18.73L2.34,15.27C2.21,15.05 2.27,14.78 2.46,14.63L4.57,12.97L4.5,12L4.57,11L2.46,9.37C2.27,9.22 2.21,8.95 2.34,8.73L4.34,5.27C4.46,5.05 4.73,4.96 4.95,5.05L7.44,6.05C7.96,5.66 8.5,5.32 9.13,5.07L9.5,2.42C9.54,2.18 9.75,2 10,2H14C14.25,2 14.46,2.18 14.5,2.42L14.87,5.07C15.5,5.32 16.04,5.66 16.56,6.05L19.05,5.05C19.27,4.96 19.54,5.05 19.66,5.27L21.66,8.73C21.79,8.95 21.73,9.22 21.54,9.37L19.43,11L19.5,12L19.43,13L21.54,14.63C21.73,14.78 21.79,15.05 21.66,15.27L19.66,18.73C19.54,18.95 19.27,19.04 19.05,18.95L16.56,17.95C16.04,18.34 15.5,18.68 14.87,18.93L14.5,21.58C14.46,21.82 14.25,22 14,22H10M11.25,4L10.88,6.61C9.68,6.86 8.62,7.5 7.85,8.39L5.44,7.35L4.69,8.65L6.8,10.2C6.4,11.37 6.4,12.64 6.8,13.8L4.68,15.36L5.43,16.66L7.86,15.62C8.63,16.5 9.68,17.14 10.87,17.38L11.24,20H12.76L13.13,17.39C14.32,17.14 15.37,16.5 16.14,15.62L18.57,16.66L19.32,15.36L17.2,13.81C17.6,12.64 17.6,11.37 17.2,10.2L19.31,8.65L18.56,7.35L16.15,8.39C15.38,7.5 14.32,6.86 13.12,6.62L12.75,4H11.25Z"/>
+</svg>

resources/light-theme.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+    <path d="M7.5,2C5.71,3.15 4.5,5.18 4.5,7.5C4.5,9.82 5.71,11.85 7.53,13C4.46,13 2,10.54 2,7.5A5.5,5.5 0 0,1 7.5,2M19.07,3.5L20.5,4.93L4.93,20.5L3.5,19.07L19.07,3.5M12.89,5.93L11.41,5L9.97,6L10.39,4.3L9,3.24L10.75,3.12L11.33,1.47L12,3.1L13.73,3.13L12.38,4.26L12.89,5.93M9.59,9.54L8.43,8.81L7.31,9.59L7.65,8.27L6.56,7.44L7.92,7.35L8.37,6.06L8.88,7.33L10.24,7.36L9.19,8.23L9.59,9.54M19,13.5A5.5,5.5 0 0,1 13.5,19C12.28,19 11.15,18.6 10.24,17.93L17.93,10.24C18.6,11.15 19,12.28 19,13.5M14.6,20.08L17.37,18.93L17.13,22.28L14.6,20.08M18.93,17.38L20.08,14.61L22.28,17.15L18.93,17.38M20.08,12.42L18.94,9.64L22.28,9.88L20.08,12.42M9.63,18.93L12.4,20.08L9.87,22.27L9.63,18.93Z"/>
+</svg>

resources/version.json

@@ -0,0 +1,28 @@
+{
+  "ak": "aae92bc66f3edfab",
+  "as": "af125a0d5279fd576c1b4418a3e8276d",
+  "b": "11081",
+  "v": "8.7.0.11081",
+  "hw": {
+    "Accept": "*/*",
+    "Accept-Encoding": "gzip, deflate",
+    "Accept-Language": "zh-CN,zh;q=0.9",
+    "Connection": "keep-alive",
+    "Origin": "https://live.bilibili.com",
+    "Referer": "https://live.bilibili.com/",
+    "sec-ch-ua": "\"Chromium\";v=\"105\"",
+    "sec-ch-ua-mobile": "?0",
+    "sec-ch-ua-platform": "\"Windows\"",
+    "Sec-Fetch-Site": "same-site",
+    "Sec-Fetch-Mode": "cors",
+    "Sec-Fetch-Dest": "empty",
+    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36 pc_app/livehime build/11081"
+  },
+  "ha": {
+    "Accept-Encoding": "gzip,deflate",
+    "Connection": "keep-alive",
+    "User-Agent": "LiveHime/8.7.0.11081 os/Windows pc_app/livehime build/11081 osVer/10.0_x86_64"
+  },
+  "start_ac": true,
+  "stop_ac": false
+}

src/PySide/classes/__init__.py

@@ -0,0 +1,6 @@
+from .clickable_label import ClickableLabel
+from .completion_combo import CompletionComboBox
+from .error_center import ErrorCenter, install_exception_handlers
+from .focus_aware_password_edit import FocusAwareLineEdit
+from .focus_placeholder_line_edit import FocusPlaceholderLineEdit
+from .single_instance_window import SingleInstanceWindow

src/PySide/classes/clickable_label.py

@@ -0,0 +1,12 @@
+from PySide6.QtCore import Signal
+from PySide6.QtWidgets import QLabel
+
+
+class ClickableLabel(QLabel):
+    clicked = Signal()
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+
+    def mousePressEvent(self, event):
+        self.clicked.emit()

src/PySide/classes/completion_combo.py

@@ -0,0 +1,32 @@
+from collections.abc import Sequence
+
+from PySide6.QtCore import QStringListModel
+from PySide6.QtWidgets import QComboBox, QCompleter
+
+
+class CompletionComboBox(QComboBox):
+    def __init__(self, items: list[str], parent=None):
+        super().__init__(parent)
+        self.setEditable(True)
+        self.items = items.copy()
+        self.model = QStringListModel(items)
+        self.setModel(self.model)
+        self.completer = QCompleter(items, self)
+        self.setCompleter(self.completer)
+        self.lineEdit().textEdited.connect(self.update_completer)
+        super().addItems(items)
+
+    def addItems(self, texts: Sequence[str], /) -> None:
+        super().addItems(self.items)
+        self.items.extend(texts)
+        self.model.setStringList(self.items)
+
+    def clear(self):
+        self.items.clear()
+        self.model.setStringList([])
+        super().clear()
+
+    def update_completer(self, text):
+        filtered_items = [item for item in self.items
+                          if text.lower() in item.lower()]
+        self.completer.model().setStringList(filtered_items)

src/PySide/classes/error_center.py

@@ -0,0 +1,102 @@
+import sys
+import threading
+import traceback
+
+from PySide6.QtCore import QObject, Signal, Slot
+from PySide6.QtWidgets import QMessageBox
+
+from src.PySide.log import get_logger
+
+
+class ErrorCenter(QObject):
+    error_occurred = Signal(str)
+
+    def __init__(self):
+        super().__init__()
+        self._showing_dialog = False
+        self.error_occurred.connect(self.show_error_dialog)
+        self._logger = get_logger(self.__class__.__name__)
+
+    def report_exception(
+            self,
+            exc_type,
+            exc_value,
+            exc_traceback
+    ):
+        detail = "".join(
+            traceback.format_exception(
+                exc_type,
+                exc_value,
+                exc_traceback,
+            )
+        )
+
+        # 无论弹窗是否成功，都先写入日志
+        self._logger.critical(detail)
+
+        # Signal 可以将后台线程中的异常安全地送回 GUI 线程
+        self.error_occurred.emit(detail)
+
+    @Slot(str)
+    def show_error_dialog(self, detail):
+        if self._showing_dialog:
+            return
+
+        self._showing_dialog = True
+
+        try:
+            box = QMessageBox()
+            box.setIcon(QMessageBox.Icon.Critical)
+            box.setWindowTitle("喜报")
+            box.setText("StartLive开播器 出现未知错误")
+            box.setInformativeText(
+                "您可以点击下方按钮，了解错误发生的具体原因\n"
+                "或前往「安装目录 / logs / StartLive.log」查看日志\n"
+                "如果向他人寻求帮助，其你个发送生成的错误报告文件，而不是发送此窗口的截图，录屏"
+                "视频，屏幕照片，拍摄的视频，手绘图片或誊抄的画面内容。"
+            )
+            box.setDetailedText(detail)
+            box.setStandardButtons(QMessageBox.StandardButton.Ok)
+            box.exec()
+        except Exception:
+            self._logger.exception("显示错误对话框时再次发生异常")
+        finally:
+            self._showing_dialog = False
+
+
+def install_exception_handlers(error_center: ErrorCenter):
+    original_hook = sys.excepthook
+
+    # GUI 主线程以及普通未捕获异常
+    def global_exception_hook(exc_type, exc_value, exc_traceback):
+        if issubclass(exc_type, KeyboardInterrupt):
+            original_hook(exc_type, exc_value, exc_traceback)
+            return
+
+        error_center.report_exception(
+            exc_type,
+            exc_value,
+            exc_traceback,
+        )
+
+    sys.excepthook = global_exception_hook
+
+    # threading.Thread 中的异常
+    def thread_exception_hook(args):
+        error_center.report_exception(
+            args.exc_type,
+            args.exc_value,
+            args.exc_traceback
+        )
+
+    threading.excepthook = thread_exception_hook
+
+    # __del__ 等无法正常抛出的异常
+    def unraisable_exception_hook(args):
+        error_center.report_exception(
+            type(args.exc_value),
+            args.exc_value,
+            args.exc_traceback
+        )
+
+    sys.unraisablehook = unraisable_exception_hook

src/PySide/classes/focus_aware_password_edit.py

@@ -0,0 +1,17 @@
+from PySide6.QtWidgets import QLineEdit
+
+
+class FocusAwareLineEdit(QLineEdit):
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self.setEchoMode(
+            QLineEdit.EchoMode.Password)  # Start with password mode
+
+    def focusInEvent(self, event):
+        super().focusInEvent(event)
+        self.setEchoMode(QLineEdit.EchoMode.Normal)  # Reveal text when focused
+
+    def focusOutEvent(self, event):
+        super().focusOutEvent(event)
+        self.setEchoMode(
+            QLineEdit.EchoMode.Password)  # Hide text when focus is lost

src/PySide/classes/focus_placeholder_line_edit.py

@@ -0,0 +1,20 @@
+from PySide6.QtWidgets import QLineEdit
+
+
+class FocusPlaceholderLineEdit(QLineEdit):
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self._ph = ""
+
+    def focusInEvent(self, event):
+        super().focusInEvent(event)
+        self._ph = self.placeholderText()
+        self.setPlaceholderText("")
+
+    def focusOutEvent(self, event):
+        super().focusOutEvent(event)
+        self.setPlaceholderText(self._ph)
+
+    def update_placeholder(self, text):
+        self._ph = text
+        self.setPlaceholderText(text)

src/PySide/classes/single_instance_window.py

@@ -0,0 +1,48 @@
+from PySide6.QtNetwork import QLocalServer, QLocalSocket
+from PySide6.QtWidgets import QMainWindow, QMessageBox
+
+from src.core.constant import LOCAL_SERVER_NAME
+
+
+class SingleInstanceWindow(QMainWindow):
+    def __init__(self):
+        super().__init__()
+        self._server = QLocalServer(self)
+        # 清除可能残留的 socket 文件
+        QLocalServer.removeServer(LOCAL_SERVER_NAME)
+
+        if not self._server.listen(LOCAL_SERVER_NAME):
+            QMessageBox.critical(self, "应用初始化", "启动本地服务失败！")
+        else:
+            self._server.newConnection.connect(self._handle_new_connection)
+
+    def _handle_new_connection(self):
+        socket = self._server.nextPendingConnection()
+        socket.readyRead.connect(lambda: self._read_and_activate(socket))
+
+    def _read_and_activate(self, socket):
+        data = socket.readAll().data().decode()
+        if data == "ACTIVATE":
+            self._bring_to_front()
+        socket.close()
+
+    def _bring_to_front(self):
+        """唤醒窗口"""
+        self.show()
+        if self.isMinimized():
+            self.showNormal()
+        self.raise_()
+        self.activateWindow()
+
+    @staticmethod
+    def is_another_instance_running():
+        """尝试连接到现有实例"""
+        socket = QLocalSocket()
+        socket.connectToServer(LOCAL_SERVER_NAME)
+        if socket.waitForConnected(50):
+            socket.write(b"ACTIVATE")
+            socket.flush()
+            socket.waitForBytesWritten(50)
+            socket.close()
+            return True
+        return False

src/PySide/interface_adapters/__init__.py

@@ -0,0 +1 @@
+from .gui_dispatcher import GUIDispatcher

src/PySide/interface_adapters/announce/__init__.py

@@ -0,0 +1,2 @@
+from .announce_update_presenter import AnnounceUpdatePresenter
+from .fetch_announce_presenter import FetchAnnouncePresenter

src/PySide/interface_adapters/announce/announce_update_presenter.py

@@ -0,0 +1,14 @@
+from src.core.workers.base import Presenter
+
+
+class AnnounceUpdatePresenter(Presenter):
+    def __init__(self, view: "StreamConfigPanel") -> None:
+        super().__init__()
+        self._view = view
+
+    def prepare_fail_view(self, exception: Exception):
+        self._view.save_announce_btn.setEnabled(True)
+
+    def prepare_success_view(self, *args, **kwargs): ...
+
+    def prepare_progress_view(self, *args, **kwargs): ...

src/PySide/interface_adapters/announce/fetch_announce_presenter.py

@@ -0,0 +1,20 @@
+from src.core import app_state
+from src.core.workers.base import Presenter
+
+
+class FetchAnnouncePresenter(Presenter):
+    def __init__(self, view: "StreamConfigPanel") -> None:
+        super().__init__()
+        self._view = view
+
+    def prepare_success_view(self):
+        self._view.announce_input.setText(app_state.room_info["announcement"])
+        self._view.announce_input.textEdited.connect(
+            lambda: self._view.save_announce_btn.setEnabled(True))
+
+    def prepare_progress_view(self, *args, **kwargs):
+        self._view.announce_input.setText(app_state.room_info["announcement"])
+        self._view.announce_input.textEdited.connect(
+            lambda: self._view.save_announce_btn.setEnabled(True))
+
+    def prepare_fail_view(self, exception: Exception): ...

src/PySide/interface_adapters/area/__init__.py

@@ -0,0 +1,3 @@
+from .area_update_presenter import AreaUpdatePresenter
+from .fetch_area_presenter import FetchAreaPresenter
+from .fetch_recent_area_presenter import FetchRecentAreaPresenter

src/PySide/interface_adapters/area/area_update_presenter.py

@@ -0,0 +1,28 @@
+from src.core import app_state
+from src.core.workers.base import Presenter
+
+
+class AreaUpdatePresenter(Presenter):
+    def __init__(self, view: "StreamConfigPanel") -> None:
+        super().__init__()
+        self._view = view
+
+    def prepare_success_view(self, area: str):
+        app_state.room_info[
+            "parent_area"] = app_state.area_reverse[area]
+        app_state.room_info[
+            "area"] = area
+        app_state.room_info["area_code"] = app_state.area_codes[area]
+        self._view.parent_combo.setCurrentText(
+            app_state.room_info["parent_area"])
+        self._view.child_combo.setCurrentText(app_state.room_info["area"])
+
+    def prepare_fail_view(self, exception: Exception):
+        enabled = self._view.enable_child_combo_autosave(False)
+        self._view.parent_combo.setCurrentText(
+            app_state.room_info["parent_area"])
+        self._view.child_combo.setCurrentText(app_state.room_info["area"])
+        self._view.enable_child_combo_autosave(enabled)
+        self._view.modify_area_btn.setEnabled(True)
+
+    def prepare_progress_view(self, *args, **kwargs): ...

src/PySide/interface_adapters/area/fetch_area_presenter.py

@@ -0,0 +1,16 @@
+from src.core.workers.base import Presenter
+from ...states import LoginState
+
+
+class FetchAreaPresenter(Presenter):
+    def __init__(self, state: LoginState):
+        super().__init__()
+        self.state = state
+
+    def prepare_success_view(self):
+        self.state.areaUpdated.emit()
+
+    def prepare_fail_view(self, exception: Exception):
+        self.state.areaUpdated.emit()
+
+    def prepare_progress_view(self, *args, **kwargs): ...

src/PySide/interface_adapters/area/fetch_recent_area_presenter.py

@@ -0,0 +1,16 @@
+from src.core import app_state
+from src.core.workers.base import Presenter
+
+
+class FetchRecentAreaPresenter(Presenter):
+    def __init__(self, view: "AreaPickerPanel"):
+        super().__init__()
+        self._view = view
+
+    def prepare_success_view(self):
+        self._view.historyUpdated.emit(app_state.room_info["recent_areas"])
+
+    def prepare_fail_view(self, exception: Exception):
+        self._view.historyUpdated.emit([])
+
+    def prepare_progress_view(self, *args, **kwargs): ...

src/PySide/interface_adapters/const/__init__.py

@@ -0,0 +1,2 @@
+from .const_update_presenter import ConstantUpdatePresenter
+from .version_checker_presenter import VersionCheckerPresenter

src/PySide/interface_adapters/const/const_update_presenter.py

@@ -0,0 +1,19 @@
+from src.PySide.states import LoginState
+from src.core import app_state
+from src.core.workers.base import Presenter
+
+
+class ConstantUpdatePresenter(Presenter):
+    def __init__(self, state: LoginState):
+        super().__init__()
+        self._state = state
+
+    def prepare_success_view(self):
+        app_state.scan_status["const_updated"] = True
+        self._state.constUpdated.emit()
+
+    def prepare_fail_view(self, exception: Exception):
+        app_state.scan_status["const_updated"] = True
+        self._state.constUpdated.emit()
+
+    def prepare_progress_view(self, progress: int): ...

src/PySide/interface_adapters/const/version_checker_presenter.py

@@ -0,0 +1,16 @@
+from src.PySide.states import LoginState
+from src.core.workers.base import Presenter
+
+
+class VersionCheckerPresenter(Presenter):
+    def __init__(self, state: LoginState):
+        super().__init__()
+        self._state = state
+
+    def prepare_success_view(self, version: str | None = None):
+        if version is not None:
+            self._state.versionChecked.emit(version)
+
+    def prepare_fail_view(self, exception: Exception): ...
+
+    def prepare_progress_view(self, *args, **kwargs): ...

src/PySide/interface_adapters/cover/__init__.py

@@ -0,0 +1,3 @@
+from .cover_state_presenter import CoverStateUpdatePresenter
+from .cover_upload_presenter import CoverUploadPresenter
+from .fetch_cover_presenter import FetchCoverPresenter