fix(live): 浮窗审查三处即修——ACL 权限/开态语义/监听清理

新增代码七维审查（v0.12.3 二轮）发现并修复：
1. HIGH：float.json 仅 core:default——core:window:default 只含只读查询，
   startDragging/setPosition/setSize 走 plugin:window|* 且无条件 ACL 校验，
   浮窗全部新交互（拖拽/位置记忆/双形态）将被静默拒绝；补
   allow-set-size/allow-set-position/allow-start-dragging 最小集。关联修复：
   主窗 App.tsx 关闭确认的 getCurrentWindow().close() 同为此缺口
   （pre-existing），default.json 补 allow-close。
2. HIGH：FloatUiView.open 以 get_webview_window 存在性判定——常驻预创建后
   窗口对象恒存在，open 恒 true，主窗按钮永远"收起"且无法重新打开；
   改为 FloatUi.open 显式状态（open/close 命令置位）+ 单测锚定。
3. MED：useFloatWindow 的 float:state 监听未在组件卸载时释放（listen 异步
   resolve 时序缺陷）——HMR/StrictMode 泄漏；改为 ref 持有 + 卸载释放。
另：loadFloatPrefs 惰性一次（原 useRef 参数每渲染求值）、ClassroomPage
浮窗状态类型统一共享 FloatSnapshot。验证：cargo check 通过 + clippy 本批
零新增告警 + tsc 零错误 + vitest 83 通过。

Author: Aparencia

app/src-tauri/capabilities/default.json

@@ -1,10 +1,11 @@
 {
   "$schema": "../gen/schemas/desktop-schema.json",
   "identifier": "default",
-  "description": "Capability for the main window",
+  "description": "Capability for the main window (allow-close: App.tsx 关闭确认流程 getCurrentWindow().close()——审查发现 core:window:default 仅只读、该调用此前被 ACL 静默拒绝)",
   "windows": ["main"],
   "permissions": [
     "core:default",
-    "dialog:default"
+    "dialog:default",
+    "core:window:allow-close"
   ]
 }

app/src-tauri/capabilities/float.json

@@ -1,9 +1,12 @@
 {
   "$schema": "../gen/schemas/desktop-schema.json",
   "identifier": "capture-float",
-  "description": "Capability for the capture float window (v0.12.3: 最小权限——无 dialog，浮窗仅消费 live:* 事件与窗口自身操作)",
+  "description": "Capability for the capture float window (v0.12.3: 最小权限——无 dialog；core:window:default 仅含只读查询，浮窗交互所需的 3 个变更权限显式列出：拖拽/位置恢复吸附/双形态 resize)",
   "windows": ["capture-float"],
   "permissions": [
-    "core:default"
+    "core:default",
+    "core:window:allow-set-size",
+    "core:window:allow-set-position",
+    "core:window:allow-start-dragging"
   ]
 }

app/src-tauri/src/commands_window.rs

@@ -31,13 +31,17 @@ pub const FLOAT_STATE_EVENT: &str = "float:state";
 /// 浮窗 UI 状态（Rust 侧单一来源；set_ignore_cursor_events 无 getter 必须自存）。
 #[derive(Debug, Clone, Copy, Default)]
 pub struct FloatUi {
+    /// 是否**显示**（open 语义）。预创建常驻后窗口对象恒存在，
+    /// 不能用 get_webview_window 存在性判定 open——否则按钮语义恒为
+    /// "收起"且永远无法重新打开（审查 P0，v0.12.3 审查即修）。
+    pub open: bool,
     /// 点击穿透（锁定后浮窗不可点，主窗按钮/快捷键解锁）
     pub locked: bool,
     /// 是否置顶
     pub topmost: bool,
 }
 
-/// 对外状态视图（camelCase 契约——前端按钮语义数据源）。
+/// 对外状态视图（camelCase 契约——前端按钮语义数据源；纯函数构造可单测）。
 #[derive(Debug, Clone, Copy, serde::Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct FloatUiView {
@@ -46,16 +50,16 @@ pub struct FloatUiView {
     pub topmost: bool,
 }
 
-fn view(app: &tauri::AppHandle, ui: &FloatUi) -> FloatUiView {
+fn view(ui: &FloatUi) -> FloatUiView {
     FloatUiView {
-        open: app.get_webview_window(CAPTURE_FLOAT_LABEL).is_some(),
+        open: ui.open,
         locked: ui.locked,
         topmost: ui.topmost,
     }
 }
 
 fn emit_float_state(app: &tauri::AppHandle, ui: &FloatUi) {
-    let _ = app.emit(FLOAT_STATE_EVENT, view(app, ui));
+    let _ = app.emit(FLOAT_STATE_EVENT, view(ui));
 }
 
 /// setup 预创建隐藏浮窗（P2-10：常驻秒开；失败回落为打开时懒创建——不阻断启动）。
@@ -100,20 +104,28 @@ pub async fn open_capture_float(
     app: tauri::AppHandle,
     state: State<'_, AppState>,
 ) -> Result<(), String> {
-    let ui = *state
+    let topmost = state
         .float_ui
         .lock()
-        .map_err(|e| format!("浮窗状态锁中毒: {}", e))?;
+        .map_err(|e| format!("浮窗状态锁中毒: {}", e))?
+        .topmost;
     let window = match app.get_webview_window(CAPTURE_FLOAT_LABEL) {
         Some(w) => w,
         None => build_float_window(&app, false)?,
     };
     window.show().map_err(|e| format!("显示采集浮窗失败: {}", e))?;
     window
-        .set_always_on_top(ui.topmost)
+        .set_always_on_top(topmost)
         .map_err(|e| format!("设置浮窗置顶失败: {}", e))?;
     let _ = window.set_focus();
-    emit_float_state(&app, &ui);
+    {
+        let mut ui = state
+            .float_ui
+            .lock()
+            .map_err(|e| format!("浮窗状态锁中毒: {}", e))?;
+        ui.open = true;
+        emit_float_state(&app, &ui);
+    }
     Ok(())
 }
 
@@ -131,10 +143,11 @@ pub async fn close_capture_float(
     if let Some(window) = app.get_webview_window(CAPTURE_FLOAT_LABEL) {
         window.hide().map_err(|e| format!("隐藏采集浮窗失败: {}", e))?;
     }
-    let ui = *state
+    let mut ui = state
         .float_ui
         .lock()
         .map_err(|e| format!("浮窗状态锁中毒: {}", e))?;
+    ui.open = false;
     emit_float_state(&app, &ui);
     Ok(())
 }
@@ -163,7 +176,7 @@ pub async fn float_set_locked(
         .lock()
         .map_err(|e| format!("浮窗状态锁中毒: {}", e))?;
     ui.locked = locked;
-    let v = view(&app, &ui);
+    let v = view(&ui);
     emit_float_state(&app, &ui);
     Ok(v)
 }
@@ -185,19 +198,39 @@ pub async fn float_set_topmost(
         .lock()
         .map_err(|e| format!("浮窗状态锁中毒: {}", e))?;
     ui.topmost = topmost;
-    let v = view(&app, &ui);
+    let v = view(&ui);
     emit_float_state(&app, &ui);
     Ok(v)
 }
 
 /// 浮窗当前状态（主窗挂载/快捷键语义同步；轻量读，无需 async）。
 #[tauri::command]
-pub fn float_state(app: tauri::AppHandle, state: State<'_, AppState>) -> Result<FloatUiView, String> {
+pub fn float_state(state: State<'_, AppState>) -> Result<FloatUiView, String> {
     let ui = *state
         .float_ui
         .lock()
         .map_err(|e| format!("浮窗状态锁中毒: {}", e))?;
-    Ok(view(&app, &ui))
+    Ok(view(&ui))
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    /// 审查即修（v0.12.3）：open 必须是显式状态——常驻预创建后窗口对象恒存在，
+    /// 不能用 get_webview_window 存在性判定（否则 open 恒 true，主窗按钮
+    /// 永远显示"收起"且无法再次打开）。
+    #[test]
+    fn float_ui_view_open_is_explicit_state() {
+        let ui = FloatUi { open: false, locked: true, topmost: false };
+        let v = view(&ui);
+        let json = serde_json::to_value(v).expect("序列化失败");
+        assert_eq!(json["open"], false, "open 必须为显式状态（预创建存在≠显示）");
+        assert_eq!(json["locked"], true);
+        assert_eq!(json["topmost"], false);
+        // camelCase 契约锚定（前端直接消费该 JSON 键）
+        assert!(json.get("open").is_some() && json.get("locked").is_some() && json.get("topmost").is_some());
+    }
 }
 
 /// 回主窗：显示 + 还原 + 聚焦主窗口（浮窗保留——回主窗不损失悬浮态）。

app/src/hooks/useFloatWindow.ts

@@ -33,7 +33,10 @@ export interface FloatSnapshot {
 const MOVE_FINALIZE_DEBOUNCE_MS = 250;
 
 export function useFloatWindow() {
-  const prefsRef = useRef(loadFloatPrefs());
+  // 惰性一次读取（审查 MED-1：useRef(loadFloatPrefs()) 每渲染求值——
+  // 浮窗 1s tick 重渲染时等价于每秒 localStorage 读 + JSON.parse）
+  const [initialPrefs] = useState(loadFloatPrefs);
+  const prefsRef = useRef(initialPrefs);
   const [snapshot, setSnapshot] = useState<FloatSnapshot>({
     open: true,
     locked: false,
@@ -46,6 +49,7 @@ export function useFloatWindow() {
   // 挂载兜底：拉取一次状态 + 订阅 float:state 事件（Rust 单一来源）
   useEffect(() => {
     let disposed = false;
+    let unlisten: (() => void) | undefined;
     void invoke<FloatSnapshot>("float_state")
       .then((s) => {
         if (disposed) return;
@@ -56,11 +60,15 @@ export function useFloatWindow() {
     void listen<FloatSnapshot>("float:state", (e) => {
       setSnapshot(e.payload);
       prefsRef.current = { ...prefsRef.current, topmost: e.payload.topmost };
-    }).then((un) => {
-      if (disposed) void un();
+    }).then((fn) => {
+      // 审查修复：listen 异步 resolve——若卸载已发生立即释放，
+      // 否则存入 ref 供卸载时调用（原实现仅 disposed 分支释放，热重载/StrictMode 会泄漏）
+      if (disposed) void fn();
+      else unlisten = fn;
     });
     return () => {
       disposed = true;
+      unlisten?.();
     };
   }, []);
 

app/src/pages/ClassroomPage.tsx

@@ -26,6 +26,9 @@ import MaterialInputPanel from "../components/MaterialInputPanel";
 // v0.11.7：图文采集（第三动线：截屏导入图文内容 → 图文会话）
 import PhotoCapturePanel from "../components/PhotoCapturePanel";
 import type { Note, WindowInfo, StreamingModelStatus, LiveSessionStatus, DownloadProgress, DownloadStatus, ProfileKind } from "../types";
+// v0.12.3：浮窗状态快照类型（与 Rust FloatUiView camelCase 契约同源；
+// 审查 LOW-3：统一共享类型替代内联重复声明）
+import type { FloatSnapshot } from "../hooks/useFloatWindow";
 // Low 清扫：标题截断长度单一定义源（与 MaterialInputPanel 共享）
 import { NOTE_TITLE_MAX_LEN } from "../utils/constants";
 
@@ -64,7 +67,7 @@ export default function ClassroomPage({ onOpenSessions }: { onOpenSessions?: (se
   // P3：引擎预热状态（选窗口阶段后台加载；与 Rust PrepareStatus 契约一致）
   const [prepareState, setPrepareState] = useState<PrepareState>("idle");
   // v0.12.3：浮窗状态（按钮语义：浮窗化 ⇄ 收起 ⇄ 解锁穿透；Rust 单一来源）
-  const [floatSnap, setFloatSnap] = useState<{ open: boolean; locked: boolean }>({ open: false, locked: false });
+  const [floatSnap, setFloatSnap] = useState<FloatSnapshot>({ open: false, locked: false, topmost: true });
 
   // ── 素材与结果（文件流水线，v0.1.0）──
   // 素材路径/处理中状态已下沉 MaterialInputPanel（审查硬拆）；父级仅保留产物与提示
@@ -219,13 +222,13 @@ export default function ClassroomPage({ onOpenSessions }: { onOpenSessions?: (se
   useEffect(() => {
     let disposed = false;
     const unlisteners: Promise<() => void>[] = [];
-    void invoke<{ open: boolean; locked: boolean }>("float_state")
+    void invoke<FloatSnapshot>("float_state")
       .then((s) => {
         if (!disposed) setFloatSnap(s);
       })
       .catch(() => undefined);
     unlisteners.push(
-      listen<{ open: boolean; locked: boolean }>("float:state", (e) => {
+      listen<FloatSnapshot>("float:state", (e) => {
         if (!disposed) setFloatSnap(e.payload);
       }),
     );