feat(ui): 全局禁用 WebView2 浏览器原生右键菜单 + 文本输入应用内右键小菜单（REQ-244，App 挂载随 AI 批）

Author: Aparencia

app/src-tauri/Cargo.lock

@@ -140,4 +140,7 @@ windows = { version = "0.61", features = [
     "Graphics_DirectX",
     "Graphics_DirectX_Direct3D11",
 ] }
+# v0.16.1：浏览器痕迹去除——with_webview 取 ICoreWebView2Settings 禁用原生右键菜单；
+# 版本与 tauri 依赖树对齐（lock 内已有 0.38.2，零新增下载）
+webview2-com = "0.38"
 

app/src-tauri/Cargo.toml

@@ -0,0 +1,42 @@
+//! browser_chrome — WebView2 浏览器痕迹去除（v0.16.1 用户决定①）。
+//!
+//! @ai-context: 桌面应用右键默认弹出 WebView2 原生菜单（复制/粘贴/检查元素），
+//!              用户观感是"这是浏览器"且暴露调试入口——v0.16.1 起全局禁用：
+//!              经 wry Windows 扩展 with_webview → ICoreWebView2Controller →
+//!              CoreWebView2() → Settings() 的 AreDefaultContextMenusEnabled(false)
+//!              （W3C 标准的 contextmenu preventDefault 在 WebView2 下不保证抑制
+//!              原生菜单，host 侧设置才是可靠通道；前端另有 preventDefault 兜底）。
+//!              文本输入（textarea/input）的右键粘贴/复制由前端自绘小菜单补齐
+//!              （BrowserChrome 组件），本模块只管"原生菜单消失"。
+//!              失败策略：仅日志、不阻断（降级=回到原生菜单，前端叠加自绘菜单）。
+
+/// 禁用单个窗口内 WebView2 的原生右键菜单（失败仅日志——降级不阻断启动）。
+///
+/// 调用点：主窗（lib.rs setup）与浮窗/框选窗（建窗后）。关闭窗口前后幂等。
+#[cfg(target_os = "windows")]
+pub fn disable_default_context_menu(win: &tauri::WebviewWindow) -> tauri::Result<()> {
+    win.with_webview(|wv| {
+        let controller = wv.controller();
+        // SAFETY: controller 由 wry 持有、与当前 webview 生命周期一致——仅在闭包内使用。
+        unsafe {
+            // Settings 在 ICoreWebView2 上（controller.CoreWebView2() 取 webview）
+            if let Ok(webview) = controller.CoreWebView2() {
+                if let Ok(settings) = webview.Settings() {
+                    if let Err(e) = settings.SetAreDefaultContextMenusEnabled(false) {
+                        eprintln!("[browser-chrome] SetAreDefaultContextMenusEnabled(false) 失败: {e}");
+                    }
+                } else {
+                    eprintln!("[browser-chrome] 获取 WebView2 settings 失败");
+                }
+            } else {
+                eprintln!("[browser-chrome] 获取 ICoreWebView2 失败");
+            }
+        }
+    })
+}
+
+/// 非 Windows 平台无 WebView2 原生菜单概念——空实现（保调用点代码统一）。
+#[cfg(not(target_os = "windows"))]
+pub fn disable_default_context_menu(_win: &tauri::WebviewWindow) -> tauri::Result<()> {
+    Ok(())
+}

app/src-tauri/src/browser_chrome.rs

@@ -65,7 +65,7 @@ pub async fn open_capture_overlay(state: State<'_, AppState>, app: tauri::AppHan
         .map_err(|e| format!("覆盖层截图路径锁中毒: {}", e))? = Some(path);
     // 3) 创建覆盖层窗口（已存在则复用——幂等）
     if app.get_webview_window(CAPTURE_OVERLAY_LABEL).is_none() {
-        WebviewWindowBuilder::new(&app, CAPTURE_OVERLAY_LABEL, WebviewUrl::App("index.html?overlay=1".into()))
+        let overlay = WebviewWindowBuilder::new(&app, CAPTURE_OVERLAY_LABEL, WebviewUrl::App("index.html?overlay=1".into()))
             .title("熵减截图")
             .decorations(false)
             .transparent(true)
@@ -74,6 +74,10 @@ pub async fn open_capture_overlay(state: State<'_, AppState>, app: tauri::AppHan
             .always_on_top(true)
             .build()
             .map_err(|e| format!("创建覆盖层窗口失败: {}", e))?;
+        // v0.16.1：框选窗同样禁用 WebView2 原生右键菜单（浏览器痕迹去除——失败仅日志）
+        if let Err(e) = crate::browser_chrome::disable_default_context_menu(&overlay) {
+            eprintln!("[browser-chrome] 框选窗禁用默认右键菜单失败: {e}");
+        }
     }
     Ok(())
 }

app/src-tauri/src/commands_overlay.rs

@@ -107,7 +107,7 @@ pub fn precreate_float(app: &tauri::AppHandle) {
 
 /// 构建浮窗窗口（precreated=true → 隐藏未聚焦——预创建路径；false → 可见带焦点——懒创建打开路径）。
 fn build_float_window(app: &tauri::AppHandle, precreated: bool) -> Result<WebviewWindow, String> {
-    WebviewWindowBuilder::new(app, CAPTURE_FLOAT_LABEL, WebviewUrl::App("index.html?float=1".into()))
+    let win = WebviewWindowBuilder::new(app, CAPTURE_FLOAT_LABEL, WebviewUrl::App("index.html?float=1".into()))
         .title("采集浮窗")
         .inner_size(360.0, 240.0)
         .decorations(false)
@@ -118,7 +118,12 @@ fn build_float_window(app: &tauri::AppHandle, precreated: bool) -> Result<Webvie
         .visible(!precreated)
         .focused(!precreated)
         .build()
-        .map_err(|e| format!("创建采集浮窗失败: {}", e))
+        .map_err(|e| format!("创建采集浮窗失败: {}", e))?;
+    // v0.16.1：浮窗同样禁用 WebView2 原生右键菜单（浏览器痕迹去除——失败仅日志不阻断）
+    if let Err(e) = crate::browser_chrome::disable_default_context_menu(&win) {
+        eprintln!("[browser-chrome] 浮窗禁用默认右键菜单失败: {e}");
+    }
+    Ok(win)
 }
 
 /// 显示 + 还原 + 聚焦主窗（回主窗/收起浮窗后的兜底——绝不把用户留在无可见窗口）。

app/src-tauri/src/commands_window.rs

@@ -9,6 +9,8 @@ mod ai_judge;
 mod ai_mock;
 mod ai_protocol;
 mod ai_text_filter;
+// v0.16.1：WebView2 浏览器痕迹去除（原生右键菜单全局禁用——Windows host 侧设置）
+mod browser_chrome;
 // v0.8.0 M1（REQ-138/139/140）：AI 使能层——全局设置（授权红线默认关）/
 // 密钥凭据存储（DPAPI）/余额查询/共享 AI client（ai_text_filter 与 M2/M3
 // ai_note_refine/ai_enrich 共用）
@@ -420,7 +422,15 @@ pub fn run() {
         .setup(|app| {
             // AppState 装配（数据目录/DB/引擎池/可校准配置——拆至 app_setup.rs，
             // line-limit-exemptions 登记计划：lib.rs >600 硬拆落地）
-            crate::app_setup::setup_app_state(app).map_err(Into::into)
+            crate::app_setup::setup_app_state(app).map_err(|e| Box::<dyn std::error::Error>::from(e))?;
+            // v0.16.1：浏览器原生右键菜单全局禁用——失败仅日志（降级=原生菜单，
+            // 前端 contextmenu preventDefault 兜底；文本输入右键粘贴由前端自绘小菜单补齐）
+            if let Some(main) = app.get_webview_window(crate::commands_window::MAIN_WINDOW_LABEL) {
+                if let Err(e) = crate::browser_chrome::disable_default_context_menu(&main) {
+                    eprintln!("[browser-chrome] 主窗禁用默认右键菜单失败: {e}");
+                }
+            }
+            Ok(())
         })
         // ADR-007：采集进行时拦截窗口关闭——prevent_close + 通知前端弹确认框；
         // 用户确认后前端先 stop_live_session 再 close（届时无活动会话，放行）

app/src-tauri/src/lib.rs

@@ -0,0 +1,101 @@
+// @vitest-environment jsdom
+/**
+ * BrowserChrome.test.tsx — 浏览器痕迹去除前端层（v0.16.1）。AAA 模式。
+ *
+ * @ai-context: 覆盖三契约——① 任意位置右键都 preventDefault（原生菜单不出现在
+ *              应用内）；② 文本控件右键弹应用内小菜单（剪切/复制/粘贴/全选）；
+ *              ③ 粘贴 = 剪贴板文本插入光标处（异步 readText）。原生事件监听器
+ *              触发的 setState 需 act 包裹（非 React 事件路径）。
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { act, cleanup, fireEvent, render, screen } from "@testing-library/react";
+import BrowserChrome from "./BrowserChrome";
+
+const readTextMock = vi.fn();
+
+/** 追加到 body 的原生元素（脱离 React 树——单独清理避免跨测试残留） */
+function append<T extends HTMLElement>(el: T): T {
+  document.body.appendChild(el);
+  return el;
+}
+
+beforeEach(() => {
+  readTextMock.mockReset();
+  readTextMock.mockResolvedValue("剪贴板文本");
+  Object.defineProperty(globalThis.navigator, "clipboard", {
+    value: { readText: readTextMock },
+    configurable: true,
+  });
+  // jsdom 无 execCommand——模拟浏览器环境提供（复制/剪切走它）
+  document.execCommand = vi.fn(() => true) as unknown as typeof document.execCommand;
+});
+afterEach(() => {
+  cleanup();
+  document.body.innerHTML = "";
+});
+
+describe("BrowserChrome 浏览器痕迹去除", () => {
+  it("非文本区域右键：不弹菜单（原生菜单已被 preventDefault 抑制）", () => {
+    render(<BrowserChrome />);
+    const box = append(document.createElement("div"));
+    const ev = new MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: 10, clientY: 10 });
+    box.dispatchEvent(ev);
+    expect(ev.defaultPrevented).toBe(true);
+    expect(screen.queryByTestId("browser-chrome-menu")).toBeNull();
+  });
+
+  it("textarea 右键：弹出应用内菜单（剪切/复制/粘贴/全选）", () => {
+    render(<BrowserChrome />);
+    const ta = append(document.createElement("textarea"));
+    act(() => {
+      ta.dispatchEvent(new MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: 20, clientY: 20 }));
+    });
+    expect(screen.getByTestId("browser-chrome-menu")).toBeTruthy();
+    for (const label of ["剪切", "复制", "粘贴", "全选"]) {
+      expect(screen.getByTestId(`browser-chrome-${label}`)).toBeTruthy();
+    }
+  });
+
+  it("粘贴：读取剪贴板并插入光标处（setRangeText + input 事件）", async () => {
+    render(<BrowserChrome />);
+    const ta = append(document.createElement("textarea"));
+    ta.value = "ab";
+    ta.setSelectionRange(1, 1); // 光标在 a|b
+    act(() => {
+      ta.dispatchEvent(new MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: 20, clientY: 20 }));
+    });
+    fireEvent.click(screen.getByTestId("browser-chrome-粘贴"));
+    await vi.waitFor(() => {
+      expect(ta.value).toBe("a剪贴板文本b");
+    });
+    expect(readTextMock).toHaveBeenCalled();
+    // 菜单已收起
+    expect(screen.queryByTestId("browser-chrome-menu")).toBeNull();
+  });
+
+  it("无选区：剪切/复制禁用；全选可点", () => {
+    render(<BrowserChrome />);
+    const inp = append(document.createElement("input"));
+    inp.value = "hello";
+    inp.setSelectionRange(0, 0);
+    act(() => {
+      inp.dispatchEvent(new MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: 20, clientY: 20 }));
+    });
+    expect((screen.getByTestId("browser-chrome-剪切") as HTMLButtonElement).disabled).toBe(true);
+    expect((screen.getByTestId("browser-chrome-复制") as HTMLButtonElement).disabled).toBe(true);
+    fireEvent.click(screen.getByTestId("browser-chrome-全选"));
+    expect(inp.selectionStart).toBe(0);
+    expect(inp.selectionEnd).toBe(5);
+  });
+
+  it("ESC 关闭菜单", () => {
+    render(<BrowserChrome />);
+    const inp = append(document.createElement("input"));
+    act(() => {
+      inp.dispatchEvent(new MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: 20, clientY: 20 }));
+    });
+    expect(screen.getByTestId("browser-chrome-menu")).toBeTruthy();
+    fireEvent.keyDown(window, { key: "Escape" });
+    expect(screen.queryByTestId("browser-chrome-menu")).toBeNull();
+  });
+});