fix(live): 预热双跑语义收敛——StrictMode 免疫 + 加载期取消即时释放

Author: Aparencia

app/src-tauri/src/live_session_prepare.rs

@@ -123,6 +123,22 @@ pub fn run_prepared(rx: mpsc::Receiver<PrepareMsg>, env: PrepareEnv, status: Arc
             return;
         }
     };
+    // 加载期间可能已收到 Cancel/断开（release 先于加载完成——引擎加载不可中断，
+    // 请求排队的语义收口）：先消费再宣告 Ready，避免"已完成→随即取消"的自相
+    // 矛盾日志（dev StrictMode 双挂载下可稳定复现的误读观感）。
+    // Start 理论上不会出现在加载期（start 仅在 status=Ready 时发交接；Loading
+    // 期 start 走内联回退并先取消预备），但不可吞消息——交接到手就就地转会话
+    match rx.try_recv() {
+        Ok(PrepareMsg::Cancel) | Err(mpsc::TryRecvError::Disconnected) => {
+            eprintln!("[LiveSession] 加载期间已请求取消，释放引擎");
+            return;
+        }
+        Ok(PrepareMsg::Start(handoff)) => {
+            run_with_handoff(engine, *handoff);
+            return;
+        }
+        Err(mpsc::TryRecvError::Empty) => {}
+    }
     *status.lock().expect("prepare status lock poisoned") = PrepareStatus::Ready;
     eprintln!("[LiveSession] 引擎预热完成（等待开始/取消）");
 
@@ -131,26 +147,7 @@ pub fn run_prepared(rx: mpsc::Receiver<PrepareMsg>, env: PrepareEnv, status: Arc
     loop {
         match rx.recv_timeout(Duration::from_millis(PREPARE_POLL_MS)) {
             Ok(PrepareMsg::Start(handoff)) => {
-                let StartHandoff {
-                    params,
-                    session_id,
-                    stop,
-                    latest_frame,
-                    pause,
-                    session_info,
-                } = *handoff;
-                // 会话纪元在交接后创建（模型已加载——无 A1 秒级偏移）
-                let epoch = Instant::now();
-                crate::live_session::run_session_after_engine(
-                    engine,
-                    stop,
-                    params,
-                    session_id,
-                    latest_frame,
-                    pause,
-                    epoch,
-                    session_info,
-                );
+                run_with_handoff(engine, *handoff);
                 return;
             }
             Ok(PrepareMsg::Cancel) | Err(RecvTimeoutError::Disconnected) => {
@@ -166,3 +163,20 @@ pub fn run_prepared(rx: mpsc::Receiver<PrepareMsg>, env: PrepareEnv, status: Arc
         }
     }
 }
+
+/// Start 交接执行（run_prepared 的就绪前/就绪后两处共用——防语义漂移）。
+fn run_with_handoff(engine: StreamingAsrEngine, handoff: StartHandoff) {
+    let StartHandoff {
+        params,
+        session_id,
+        stop,
+        latest_frame,
+        pause,
+        session_info,
+    } = handoff;
+    // 会话纪元在交接后创建（模型已加载——无 A1 秒级偏移）
+    let epoch = Instant::now();
+    crate::live_session::run_session_after_engine(
+        engine, stop, params, session_id, latest_frame, pause, epoch, session_info,
+    );
+}

app/src/pages/ClassroomPage.tsx

@@ -9,7 +9,7 @@
  * @ai-context: 2026-08 审查硬拆（>600 硬上限）：右栏内容区拆至 ClassroomRightPane，
  *              文件素材输入与提取拆至 MaterialInputPanel——本文件回归装配层职责。
  */
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
 import { listen } from "@tauri-apps/api/event";
 import { WindowSelectCard } from "../components/WindowSelectCard";
@@ -104,16 +104,20 @@ export default function ClassroomPage({ onOpenSessions }: { onOpenSessions?: (se
       .catch(() => setPrepareState("idle"));
   }, []);
 
+  const warmedRef = useRef(false);
   useEffect(() => {
+    // dev StrictMode 会双跑 effect（挂载→cleanup→挂载）：预热是秒级重资源
+    // 加载，第二次直接跳过——否则首次预热会被 replay 的 cleanup 取消（1s
+    // join 超时 detach）后再开第二个加载线程，白跑一次引擎加载
+    if (warmedRef.current) return;
+    warmedRef.current = true;
     warmUp();
-    // 离开页面释放预热引擎（内存 ~数百 MB；后端另有 15min TTL 兜底）
-    return () => {
-      // Low 清扫：不吞异常——释放失败记录上下文（TTL 兜底仍会回收）
-      void invoke("release_live_prepare").catch((e) => {
-        console.warn("[ClassroomPage] 释放预热引擎失败（TTL 兜底仍生效）:", e);
-      });
-    };
-  }, [warmUp]);
+    // TD-004：课堂助手页常驻挂载（display:none 切换不卸载）——本 cleanup 只
+    // 在应用卸载/StrictMode replay 时触发，**不在此释放**：release 会取消正在
+    // 加载的预热线程造成 dev 双加载与"已完成→随即取消"误读；真实回收由后端
+    // 15min TTL 与显式 release_live_prepare 命令承担（浮窗/退出路径保留）
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
 
   // 实时会话事件监听（v0.2.0；字幕/语音实时内容由右侧 LiveActivityPanel 自监听展示）
   useEffect(() => {