更新

app/packaging/doctor_workstation.spec

@@ -4,6 +4,10 @@
 PyInstaller's official PySide6 QtWebEngine hooks are activated by the explicit
 hidden imports below.  Those hooks retain QtWebEngineProcess, Chromium .pak/
 ICU resources, locales, Qt plugins, and the macOS framework/helper layout.
+The explicit QtMultimedia imports likewise activate PyInstaller's official Qt
+dependency scan, which collects the QtMultimedia/QtMultimediaWidgets extension
+modules, Qt6Multimedia shared libraries/frameworks, multimedia plugins, and
+their platform media backends.
 """
 
 import os
@@ -18,11 +22,14 @@ VIDEO_DIST = PROJECT_ROOT / "video_companion" / "dist"
 RESOURCES = PROJECT_ROOT / "resources"
 ENTITLEMENTS = PROJECT_ROOT / "packaging" / "macos" / "entitlements.plist"
 VERSION_FILE = PROJECT_ROOT / "packaging" / "windows" / "version_info.txt"
+MEDIA_SMOKE_HOOK = PROJECT_ROOT / "packaging" / "runtime_media_smoke.py"
 
 if not ENTRY_POINT.is_file():
     raise SystemExit(f"Application entry point is missing: {ENTRY_POINT}")
 if not (VIDEO_DIST / "index.html").is_file():
     raise SystemExit("Build video_companion before running PyInstaller")
+if not MEDIA_SMOKE_HOOK.is_file():
+    raise SystemExit(f"Frozen multimedia smoke hook is missing: {MEDIA_SMOKE_HOOK}")
 
 # Some Windows developer tools add an unrelated OpenSSL installation to PATH.
 # PyInstaller's dependency scanner would then pair Python's ``_ssl.pyd`` with
@@ -48,6 +55,15 @@ qt_webengine_hiddenimports = [
     "PySide6.QtPrintSupport",
 ]
 
+qt_multimedia_hiddenimports = [
+    # These are intentionally explicit instead of relying on imports hidden by
+    # the application's optional media fallback.  PyInstaller's official
+    # hooks collect Qt6Multimedia*.dll/.dylib/framework, plugins/multimedia,
+    # and the platform FFmpeg/native backend dependencies.
+    "PySide6.QtMultimedia",
+    "PySide6.QtMultimediaWidgets",
+]
+
 analysis = Analysis(
     [str(ENTRY_POINT)],
     pathex=[str(SOURCE_ROOT)],
@@ -56,10 +72,10 @@ analysis = Analysis(
         (str(VIDEO_DIST), "video_companion_dist"),
         (str(RESOURCES), "resources"),
     ],
-    hiddenimports=qt_webengine_hiddenimports,
+    hiddenimports=qt_webengine_hiddenimports + qt_multimedia_hiddenimports,
     hookspath=[],
     hooksconfig={},
-    runtime_hooks=[],
+    runtime_hooks=[str(MEDIA_SMOKE_HOOK)],
     excludes=[],
     noarchive=False,
     optimize=0,