feat: 全局快捷键修复，防止一直占用系统

Author: 阿岳

.trae/documents/全局快捷键重构方案.md

@@ -0,0 +1,37 @@
+## 计划概述
+
+为 RecentFilesWindow 页面添加独立的隐私模式开关，当开启时对文件夹名和文件名进行凯撒移位加密显示。
+
+## 实施步骤
+
+1. **添加本地隐私模式状态**
+   - 在组件中添加 `isLocalPrivacyMode` 状态
+
+   - 添加切换按钮到工具栏
+
+2. **创建凯撒移位加密函数**
+   - 复用现有的 `replaceTextWhenProtect` 函数，但强制使用凯撒模式
+
+   - 或者创建专用的文件名加密函数
+
+3. **修改显示逻辑**
+   - 在平铺视图中对文件名应用加密
+
+   - 在嵌套视图的文件夹名和文件名上应用加密
+
+   - 只影响显示，不改变实际数据
+
+4. **UI优化**
+   - 添加隐私模式切换按钮，图标使用遮罩或眼睛图标
+
+   - 按钮状态反映当前是否开启隐私模式
+
+## 技术要点
+
+- 使用凯撒移位加密（字符后移一位）
+
+- 复用现有的加密逻辑
+
+- 只在前端渲染层面做改变，不影响数据存储
+
+- 支持中英文字符的合理加密处理

app/src-tauri/capabilities/default.json

@@ -38,6 +38,7 @@
     "global-shortcut:allow-is-registered",
     "global-shortcut:allow-register",
     "global-shortcut:allow-unregister",
+    "global-shortcut:allow-unregister-all",
     "system-info:allow-all",
     {
       "identifier": "http:default",

app/src/App.tsx

@@ -9,6 +9,7 @@ import { GlobalMenu } from "@/core/service/GlobalMenu";
 import { Settings } from "@/core/service/Settings";
 import { Telemetry } from "@/core/service/Telemetry";
 import { Themes } from "@/core/service/Themes";
+import { globalShortcutManager } from "@/core/service/controlService/shortcutKeysEngine/GlobalShortcutManager";
 import {
   activeProjectAtom,
   isClassroomModeAtom,
@@ -29,7 +30,6 @@ import { cpuInfo } from "tauri-plugin-system-info-api";
 import { DragFileIntoStageEngine } from "./core/service/dataManageService/dragFileIntoStageEngine/dragFileIntoStageEngine";
 import { cn } from "./utils/cn";
 import { isMac, isWindows } from "./utils/platform";
-import { register } from "@tauri-apps/plugin-global-shortcut";
 import { KeyBindsUI } from "./core/service/controlService/shortcutKeysEngine/KeyBindsUI";
 import { ProjectTabs } from "./ProjectTabs";
 import { DropWindowCover } from "./DropWindowCover";
@@ -41,8 +41,6 @@ export default function App() {
 
   const [projects, setProjects] = useAtom(projectsAtom);
   const [activeProject, setActiveProject] = useAtom(activeProjectAtom);
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  const [___, setIsWindowAlwaysOnTop] = useAtom(isWindowAlwaysOnTopAtom);
   const canvasWrapperRef = useRef<HTMLDivElement>(null);
   // const [isWide, setIsWide] = useState(false);
   const [telemetryEventSent, setTelemetryEventSent] = useState(false);
@@ -51,8 +49,6 @@ export default function App() {
   );
   const [ignoreMouseEvents, setIgnoreMouseEvents] = useState(false);
   const [isClassroomMode, setIsClassroomMode] = useAtom(isClassroomModeAtom);
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  const [__, setIsClickThroughEnabled] = useAtom(isClickThroughEnabledAtom);
 
   const contextMenuTriggerRef = useRef<HTMLDivElement>(null);
 
@@ -137,49 +133,14 @@ export default function App() {
       }
     });
 
-    // TODO: 以后整一个全局快捷键系统
-    register("Alt+2", async (event) => {
-      if (event.state === "Pressed") {
-        setIsClickThroughEnabled((prev) => {
-          if (!Settings.allowGlobalHotKeys) {
-            toast.warning("已禁用全局快捷键");
-            return prev;
-          }
-          if (!prev) {
-            // 开启了穿透点击
-            Settings.windowBackgroundAlpha = Settings.windowBackgroundOpacityAfterOpenClickThrough;
-            setIsWindowAlwaysOnTop(true);
-            getCurrentWindow().setAlwaysOnTop(true);
-          } else {
-            // 关闭了穿透点击
-            Settings.windowBackgroundAlpha = Settings.windowBackgroundOpacityAfterCloseClickThrough;
-            setIsWindowAlwaysOnTop(false);
-            getCurrentWindow().setAlwaysOnTop(false);
-          }
-          getCurrentWindow().setIgnoreCursorEvents(!prev);
-          return !prev;
-        });
-      }
-    });
-
-    register("Alt+1", async (event) => {
-      if (event.state === "Pressed") {
-        if (!Settings.allowGlobalHotKeys) {
-          toast.warning("已禁用全局快捷键");
-          return;
-        }
-        console.log("开始呼出窗口");
-        // 呼出软件窗口
-        const window = getCurrentWindow();
-        await window.show();
-        await window.setSkipTaskbar(false);
-        await window.setFocus();
-      }
-    });
+    // 初始化全局快捷键管理
+    globalShortcutManager.init();
 
     return () => {
       unlisten1?.then((f) => f());
       KeyBindsUI.uiStopListen();
+      // 清理全局快捷键资源
+      globalShortcutManager.dispose();
     };
   }, []);
 

app/src/core/service/controlService/shortcutKeysEngine/GlobalShortcutManager.tsx

@@ -0,0 +1,137 @@
+import { register, unregisterAll, isRegistered, unregister } from "@tauri-apps/plugin-global-shortcut";
+import { getCurrentWindow } from "@tauri-apps/api/window";
+import { Settings } from "../../Settings";
+import { toast } from "sonner";
+
+// 定义全局快捷键类型
+interface GlobalShortcut {
+  key: string;
+  id: string;
+  description: string;
+  onPress: () => Promise<void>;
+}
+
+export class GlobalShortcutManager {
+  private shortcuts: GlobalShortcut[] = [];
+  private isInitialized = false;
+  private isClickThroughEnabled = false;
+  private settingsUnsubscribe: (() => void) | null = null;
+
+  constructor() {
+    this.initializeShortcuts();
+  }
+
+  // 初始化快捷键定义
+  private initializeShortcuts() {
+    this.shortcuts = [
+      {
+        key: "Alt+2",
+        id: "toggle-click-through",
+        description: "开启/关闭窗口穿透点击",
+        onPress: this.handleToggleClickThrough.bind(this),
+      },
+      {
+        key: "Alt+1",
+        id: "show-window",
+        description: "呼出软件窗口",
+        onPress: this.handleShowWindow.bind(this),
+      },
+    ];
+  }
+
+  // 初始化服务
+  public async init() {
+    if (this.isInitialized) {
+      return;
+    }
+
+    this.isInitialized = true;
+    Settings.watch("allowGlobalHotKeys", (v) => {
+      // v 是变化后的值
+      if (v) {
+        this.updateShortcuts();
+      } else {
+        unregisterAll();
+      }
+    });
+  }
+
+  // 更新快捷键注册状态
+  public async updateShortcuts() {
+    // 先注销所有快捷键
+    await unregisterAll();
+    for (const shortcut of this.shortcuts) {
+      await this.registerShortcut(shortcut);
+    }
+  }
+
+  // 注册单个快捷键
+  private async registerShortcut(shortcut: GlobalShortcut) {
+    try {
+      // 检查是否已注册
+      const alreadyRegistered = await isRegistered(shortcut.key);
+      if (alreadyRegistered) {
+        await unregister(shortcut.key);
+      }
+
+      // 注册快捷键
+      await register(shortcut.key, async (event) => {
+        if (event.state === "Pressed") {
+          await shortcut.onPress();
+        }
+      });
+    } catch (error) {
+      toast.error(`注册全局快捷键 ${shortcut.key} 失败: ${error}`);
+    }
+  }
+
+  // 处理穿透点击切换
+  private async handleToggleClickThrough() {
+    const window = getCurrentWindow();
+
+    if (!this.isClickThroughEnabled) {
+      // 开启了穿透点击
+      Settings.windowBackgroundAlpha = Settings.windowBackgroundOpacityAfterOpenClickThrough;
+      await window.setAlwaysOnTop(true);
+    } else {
+      // 关闭了穿透点击
+      Settings.windowBackgroundAlpha = Settings.windowBackgroundOpacityAfterCloseClickThrough;
+      await window.setAlwaysOnTop(false);
+    }
+
+    this.isClickThroughEnabled = !this.isClickThroughEnabled;
+    await window.setIgnoreCursorEvents(this.isClickThroughEnabled);
+  }
+
+  // 处理显示窗口
+  private async handleShowWindow() {
+    console.log("开始呼出窗口");
+    const window = getCurrentWindow();
+    await window.show();
+    await window.setSkipTaskbar(false);
+    await window.setFocus();
+  }
+
+  // 清理资源
+  public async dispose() {
+    // 注销所有快捷键
+    await unregisterAll();
+
+    // 移除设置监听器
+    if (this.settingsUnsubscribe) {
+      this.settingsUnsubscribe();
+      this.settingsUnsubscribe = null;
+    }
+
+    this.isInitialized = false;
+    console.log("全局快捷键管理器已清理");
+  }
+
+  // 获取所有快捷键信息
+  public getShortcuts() {
+    return this.shortcuts;
+  }
+}
+
+// 创建单例实例
+export const globalShortcutManager = new GlobalShortcutManager();