fix(windows): 拆分 Capsule 平台承载并恢复完整视口

docs/2026-05-02-windows-capsule-platform-split-design.zh-CN.md

@@ -0,0 +1,74 @@
+# Windows Capsule 平台分离设计
+
+日期：2026-05-02
+
+## 目标
+
+同一个产品目标：
+
+- 录音胶囊在出现、处理中、结束时都稳定可读
+- 用户只看到胶囊本体，不看到宿主矩形
+- 状态切换不裁切、不变形、不撞边
+
+不同 OS 使用不同承载手段：
+
+- macOS / 非 Windows：保留现有通用胶囊实现
+- Windows：单独使用 Windows 原生承载思路和独立组件
+
+## 设计决策
+
+### 决策 1：`Capsule.tsx` 只做平台路由
+
+- `win -> WindowsCapsule`
+- 其他平台 -> `SharedCapsule`
+
+`Capsule.tsx` 不再负责布局、状态订阅或视觉分支。
+
+### 决策 2：状态数据共享，视觉承载分离
+
+共享层只保留：
+
+- `CapsulePayload`
+- `CapsuleState`
+- Tauri 事件订阅
+- `cancel_dictation` / `stop_dictation`
+
+平台层各自负责：
+
+- 宿主尺寸
+- 可视 pill 尺寸
+- processing / error / done 布局
+- 状态切换动画和裁切策略
+
+### 决策 3：Windows 只显示 pill，不显示宿主矩形
+
+Windows 宿主窗口继续存在，但视觉上应完全透明。
+
+Windows 组件只允许渲染：
+
+- 左右动作按钮
+- 中间 processing / error / done 内容
+- 可选 translation badge
+
+不允许继续暴露一层白色矩形宿主框。
+
+## 文件边界
+
+- `openless-all/app/src/components/Capsule.tsx`
+  - 平台路由入口
+- `openless-all/app/src/components/WindowsCapsule.tsx`
+  - Windows 独立组件
+- `openless-all/app/src/components/SharedCapsule.tsx`
+  - 非 Windows 胶囊实现
+- `openless-all/app/src/components/useCapsuleState.ts`
+  - 通用状态数据 hook
+- `openless-all/app/src/lib/capsuleLayout.ts`
+  - 平台尺寸数据
+
+## 本轮验收标准
+
+- `Capsule.tsx` 只剩平台路由
+- Windows 独立使用 `WindowsCapsule.tsx`
+- Windows `thinking / error / done` 不再复用通用外观层
+- `npm run build` 通过
+- `cargo check --manifest-path openless-all/app/src-tauri/Cargo.toml` 通过

docs/2026-05-02-windows-capsule-platform-split-plan.zh-CN.md

@@ -0,0 +1,22 @@
+# Windows Capsule 平台分离实施清单
+
+日期：2026-05-02
+
+## 步骤
+
+1. 新增通用状态 hook
+   - 抽出 capsule 事件订阅和动作命令
+2. 拆出非 Windows 组件
+   - 把现有非 Windows 渲染迁到 `SharedCapsule.tsx`
+3. 接入 Windows 独立组件
+   - `Capsule.tsx` 只做 `win -> WindowsCapsule`
+4. 验证
+   - `npm run build`
+   - `cargo check --manifest-path openless-all/app/src-tauri/Cargo.toml`
+   - Windows 启动并前置主窗口
+
+## 本轮不做
+
+- helper-window lifecycle 重构
+- QA panel 交互修复
+- 业务状态流改写

openless-all/app/scripts/windows-ui-config.test.mjs

@@ -33,9 +33,13 @@ assertEqual(capsuleWindow.width, 220, 'windows capsule config keeps translation-
 assertEqual(capsuleWindow.height, 110, 'windows capsule config keeps translation-capable height baseline');
 assertEqual(capsuleWindow.transparent, true, 'capsule window should keep transparent visuals');
 assertEqual(capsuleWindow.alwaysOnTop, true, 'capsule window should stay above the focused app while recording');
-assertEqual(mainWindow.decorations, false, 'windows main window should use only custom titlebar');
+assertEqual(mainWindow.decorations, true, 'shared main window config should preserve platform-native titlebars by default');
 assertEqual(mainWindow.visible, false, 'windows main window should stay hidden until the intended first show point');
 
+if (!/fn configure_main_window_for_platform<R: Runtime>\(window: &tauri::WebviewWindow<R>\)[\s\S]*?#\[cfg\(target_os = "windows"\)\][\s\S]*?window\.set_decorations\(false\)/.test(libRs)) {
+  throw new Error('windows runtime should own the frameless shell switch instead of the shared config layer');
+}
+
 if (!/function WindowsResizeHandles\(\)/.test(windowChromeTsx)) {
   throw new Error('windows frameless shell should expose explicit resize handles');
 }

openless-all/app/src-tauri/src/lib.rs

@@ -23,9 +23,9 @@ mod recorder;
 mod selection;
 mod types;
 
+use std::sync::atomic::{AtomicBool, Ordering};
 #[cfg(target_os = "macos")]
 use std::sync::mpsc;
-use std::sync::atomic::{AtomicBool, Ordering};
 use std::sync::Arc;
 #[cfg(target_os = "macos")]
 use std::time::Duration;
@@ -61,6 +61,8 @@ pub fn run() {
             // Capsule 启动时定位到屏幕底部居中并隐藏；coordinator 按需显示。
             // 与 Swift `CapsuleWindowController.repositionToBottomCenter` 同语义。
             if let Some(capsule) = app.get_webview_window("capsule") {
+                #[cfg(target_os = "windows")]
+                configure_capsule_window_for_platform(&capsule, false);
                 if let Err(e) = position_capsule_bottom_center(&capsule, false) {
                     log::warn!("[capsule] position failed: {e}");
                 }
@@ -88,33 +90,8 @@ pub fn run() {
             // decorations 留给运行时分平台决定：macOS 默认 true 用系统红黄绿；
             // Windows 这里关掉 native chrome 让 React 端 WinTitleBar 接管。
             if let Some(main) = app.get_webview_window("main") {
-                #[cfg(target_os = "macos")]
-                {
-                    use window_vibrancy::{
-                        apply_vibrancy, NSVisualEffectMaterial, NSVisualEffectState,
-                    };
-                    if let Err(e) = apply_vibrancy(
-                        &main,
-                        NSVisualEffectMaterial::HudWindow,
-                        Some(NSVisualEffectState::Active),
-                        Some(20.0),
-                    ) {
-                        log::warn!("[main] vibrancy failed: {e}");
-                    }
-                }
+                configure_main_window_for_platform(&main);
                 #[cfg(target_os = "windows")]
-                {
-                    use window_vibrancy::apply_mica;
-                    // The window starts hidden so Windows native chrome can be disabled before
-                    // the first show; doing this after the native frame is visible is unreliable.
-                    if let Err(e) = main.set_decorations(false) {
-                        log::warn!("[main] disable native decorations failed: {e}");
-                    }
-                    if let Err(e) = apply_mica(&main, None) {
-                        log::warn!("[main] mica failed: {e}");
-                    }
-                    apply_windows_rounded_frame(&main);
-                }
                 if let Err(e) = main.show() {
                     log::warn!("[main] initial show failed: {e}");
                 }
@@ -167,9 +144,6 @@ pub fn run() {
             coordinator.start_hotkey_listener();
             // 同步启动 QA hotkey listener。和 dictation hotkey 平行，互不抢状态。
             coordinator.start_qa_hotkey_listener();
-            if std::env::var("OPENLESS_SHOW_MAIN_ON_START").ok().as_deref() == Some("1") {
-                show_main_window(app.handle());
-            }
 
             Ok(())
         })
@@ -225,7 +199,11 @@ pub fn run() {
                         hide_main_window(app);
                     }
                     #[cfg(target_os = "windows")]
-                    if matches!(event, tauri::WindowEvent::Resized(_) | tauri::WindowEvent::ScaleFactorChanged { .. }) {
+                    if matches!(
+                        event,
+                        tauri::WindowEvent::Resized(_)
+                            | tauri::WindowEvent::ScaleFactorChanged { .. }
+                    ) {
                         if let Some(main) = app.get_webview_window("main") {
                             apply_windows_rounded_frame(&main);
                         }
@@ -439,6 +417,109 @@ fn hide_main_window<R: Runtime>(app: &AppHandle<R>) {
     activate_menu_bar_mode(app);
 }
 
+fn configure_main_window_for_platform<R: Runtime>(window: &tauri::WebviewWindow<R>) {
+    #[cfg(target_os = "macos")]
+    {
+        use window_vibrancy::{apply_vibrancy, NSVisualEffectMaterial, NSVisualEffectState};
+        if let Err(e) = apply_vibrancy(
+            window,
+            NSVisualEffectMaterial::HudWindow,
+            Some(NSVisualEffectState::Active),
+            Some(20.0),
+        ) {
+            log::warn!("[main] vibrancy failed: {e}");
+        }
+    }
+
+    #[cfg(target_os = "windows")]
+    {
+        use window_vibrancy::apply_mica;
+        if let Err(e) = window.set_decorations(false) {
+            log::warn!("[main] disable native decorations failed: {e}");
+        }
+        if let Err(e) = apply_mica(window, None) {
+            log::warn!("[main] mica failed: {e}");
+        }
+        apply_windows_rounded_frame(window);
+    }
+}
+
+#[cfg(target_os = "windows")]
+fn configure_capsule_window_for_platform<R: Runtime>(
+    window: &tauri::WebviewWindow<R>,
+    _translation_active: bool,
+) {
+    use raw_window_handle::{HasWindowHandle, RawWindowHandle};
+    use windows::Win32::Graphics::Dwm::{DwmSetWindowAttribute, DWMWA_BORDER_COLOR};
+    use windows::Win32::UI::WindowsAndMessaging::WS_EX_TOOLWINDOW;
+    use windows::Win32::{
+        Foundation::HWND,
+        UI::WindowsAndMessaging::{
+            GetWindowLongW, SetWindowLongW, SetWindowPos, GWL_EXSTYLE, GWL_STYLE, SWP_FRAMECHANGED,
+            SWP_NOMOVE, SWP_NOSIZE, SWP_NOZORDER, WS_BORDER, WS_CAPTION, WS_DLGFRAME, WS_POPUP,
+            WS_THICKFRAME,
+        },
+    };
+
+    let handle = match window.window_handle().map(|h| h.as_raw()) {
+        Ok(RawWindowHandle::Win32(handle)) => handle,
+        Ok(other) => {
+            log::warn!("[capsule] unexpected raw window handle: {other:?}");
+            return;
+        }
+        Err(e) => {
+            log::warn!("[capsule] read raw window handle failed: {e}");
+            return;
+        }
+    };
+    let hwnd = HWND(handle.hwnd.get() as *mut core::ffi::c_void);
+
+    if let Err(e) = window.set_decorations(false) {
+        log::warn!("[capsule] disable native decorations failed: {e}");
+    }
+
+    unsafe {
+        let style = GetWindowLongW(hwnd, GWL_STYLE);
+        let desired_style = (style
+            & !(WS_CAPTION.0 as i32
+                | WS_THICKFRAME.0 as i32
+                | WS_BORDER.0 as i32
+                | WS_DLGFRAME.0 as i32))
+            | WS_POPUP.0 as i32;
+        if style != desired_style {
+            SetWindowLongW(hwnd, GWL_STYLE, desired_style);
+            if let Err(e) = SetWindowPos(
+                hwnd,
+                HWND::default(),
+                0,
+                0,
+                0,
+                0,
+                SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED,
+            ) {
+                log::warn!("[capsule] refresh native frame after style update failed: {e}");
+            }
+        }
+
+        let ex_style = GetWindowLongW(hwnd, GWL_EXSTYLE);
+        let desired_ex_style = ex_style | WS_EX_TOOLWINDOW.0 as i32;
+        if ex_style != desired_ex_style {
+            SetWindowLongW(hwnd, GWL_EXSTYLE, desired_ex_style);
+        }
+
+        // Remove the default DWM light border so only the pill's own stroke remains.
+        let border_color_none: u32 = 0xFFFFFFFE;
+        if let Err(e) = DwmSetWindowAttribute(
+            hwnd,
+            DWMWA_BORDER_COLOR,
+            &border_color_none as *const _ as *const core::ffi::c_void,
+            std::mem::size_of_val(&border_color_none) as u32,
+        ) {
+            log::warn!("[capsule] remove DWM border color failed: {e}");
+        }
+    }
+}
+
 #[cfg(target_os = "macos")]
 fn activate_window_mode<R: Runtime>(app: &AppHandle<R>) {
     let _ = app.set_activation_policy(tauri::ActivationPolicy::Regular);
@@ -572,9 +653,7 @@ fn position_qa_window<R: tauri::Runtime>(window: &tauri::WebviewWindow<R>) -> ta
 /// fallback 仍能从原 app 拿到选区）。
 pub(crate) fn show_qa_window<R: tauri::Runtime>(app: &AppHandle<R>, content_kind: &str) {
     let Some(window) = app.get_webview_window("qa") else {
-        log::info!(
-            "[qa] show 跳过：qa 窗口不存在 (content_kind={content_kind})"
-        );
+        log::info!("[qa] show 跳过：qa 窗口不存在 (content_kind={content_kind})");
         return;
     };
     // 仅首次 show 时居中；之后保留用户拖动后的位置。
@@ -719,6 +798,8 @@ pub(crate) fn position_capsule_bottom_center<R: tauri::Runtime>(
     };
     let bounds = capsule_window_bounds(translation_active);
     window.set_size(LogicalSize::new(bounds.width, bounds.height))?;
+    #[cfg(target_os = "windows")]
+    configure_capsule_window_for_platform(window, translation_active);
 
     let scale = monitor.scale_factor();
     let size = monitor.size();
@@ -742,9 +823,9 @@ fn capsule_window_bounds(translation_active: bool) -> CapsuleWindowBounds {
     #[cfg(target_os = "windows")]
     {
         CapsuleWindowBounds {
-            width: 220.0,
-            height: if translation_active { 118.0 } else { 84.0 },
-            bottom_inset: 12.0,
+            width: 234.0,
+            height: if translation_active { 102.0 } else { 62.0 },
+            bottom_inset: 0.0,
         }
     }
 
@@ -782,20 +863,32 @@ mod tests {
     fn capsule_window_bounds_leave_room_for_windows_shadow() {
         let bounds = capsule_window_bounds(false);
         #[cfg(target_os = "windows")]
-        assert_eq!((bounds.width, bounds.height, bounds.bottom_inset), (220.0, 84.0, 12.0));
+        assert_eq!(
+            (bounds.width, bounds.height, bounds.bottom_inset),
+            (234.0, 62.0, 0.0)
+        );
 
         #[cfg(not(target_os = "windows"))]
-        assert_eq!((bounds.width, bounds.height, bounds.bottom_inset), (176.0, 42.0, 0.0));
+        assert_eq!(
+            (bounds.width, bounds.height, bounds.bottom_inset),
+            (176.0, 42.0, 0.0)
+        );
     }
 
     #[test]
     fn capsule_window_bounds_expand_for_translation_badge() {
         let bounds = capsule_window_bounds(true);
         #[cfg(target_os = "windows")]
-        assert_eq!((bounds.width, bounds.height, bounds.bottom_inset), (220.0, 118.0, 12.0));
+        assert_eq!(
+            (bounds.width, bounds.height, bounds.bottom_inset),
+            (234.0, 102.0, 0.0)
+        );
 
         #[cfg(not(target_os = "windows"))]
-        assert_eq!((bounds.width, bounds.height, bounds.bottom_inset), (176.0, 110.0, 0.0));
+        assert_eq!(
+            (bounds.width, bounds.height, bounds.bottom_inset),
+            (176.0, 110.0, 0.0)
+        );
     }
 
     #[test]

openless-all/app/src-tauri/tauri.conf.json

@@ -21,7 +21,7 @@
         "minWidth": 980,
         "minHeight": 640,
         "resizable": true,
-        "decorations": false,
+        "decorations": true,
         "transparent": true,
         "shadow": true,
         "hiddenTitle": true,