feat: add patch explorer frame DLL toggle and localization

- Added a toggle for "ExplorerFrame Patch" in the Context Menu configuration.
- Updated English and Chinese localization files to include the new toggle label.
- Modified the config menu to include the new toggle option for the ExplorerFrame Patch.

Author: std-microblock

resources/schema.json

@@ -372,17 +372,23 @@
           "type": "boolean",
           "default": false
         },
-        "hotkeys": {
-          "title": "Enable Hotkeys",
-          "description": "Enable hotkey support for the context menu",
-          "type": "boolean",
-          "default": true
-        },
-        "search_large_dwItemData_range": {
-          "title": "Search Larger Range of DWItemData",
-          "description": "Search for a larger range of DWItemData",
-          "type": "boolean",
-          "default": false,
+        "hotkeys": {
+          "title": "Enable Hotkeys",
+          "description": "Enable hotkey support for the context menu",
+          "type": "boolean",
+          "default": true
+        },
+        "patch_explorerframe_dll": {
+          "title": "Patch ExplorerFrame.dll",
+          "description": "Controls whether Breeze patches ExplorerFrame.dll so the Explorer left pane can use the Breeze context menu",
+          "type": "boolean",
+          "default": true
+        },
+        "search_large_dwItemData_range": {
+          "title": "Search Larger Range of DWItemData",
+          "description": "Search for a larger range of DWItemData",
+          "type": "boolean",
+          "default": false,
           "deprecationMessage": "This option is for debugging purposes only and is not recommended to be enabled"
         },
         "position": {

src/shell/config.h

@@ -99,12 +99,13 @@ struct config {
         bool vsync = true;
         bool ignore_owner_draw = true;
         bool reverse_if_open_to_up = true;
-        bool experimental_ownerdraw_support = false;
-        bool hotkeys = true;
-        bool show_settings_button = true;
-
-        // debug purpose only
-        bool search_large_dwItemData_range = false;
+        bool experimental_ownerdraw_support = false;
+        bool hotkeys = true;
+        bool show_settings_button = true;
+        bool patch_explorerframe_dll = true;
+
+        // debug purpose only
+        bool search_large_dwItemData_range = false;
 
         struct position {
             int padding_vertical = 20;

src/shell/fix_win11_menu.cc

@@ -9,6 +9,7 @@
 
 #include "blook/blook.h"
 #include "blook/memo.h"
+#include "config.h"
 #include "utils.h"
 #include "zasm/base/immediate.hpp"
 #include "zasm/x86/mnemonic.hpp"
@@ -184,29 +185,31 @@ void mb_shell::fix_win11_menu::install() {
                 }
             }
 
-            if (auto explorerframe = proc->module("ExplorerFrame.dll")) {
-                auto disasm =
-                    explorerframe.value()->section(".text")->disassembly();
+            if (config::current->context_menu.patch_explorerframe_dll) {
+                if (auto explorerframe = proc->module("ExplorerFrame.dll")) {
+                    auto disasm =
+                        explorerframe.value()->section(".text")->disassembly();
 
-                for (auto &ins : disasm) {
-                    if (!is_key_state_call(ins))
-                        continue;
-
-                    auto function =
-                        ins.ptr()
-                            .find_upwards({0xCC, 0xCC, 0xCC, 0xCC, 0xCC})
-                            ->range_size(0x200)
-                            .disassembly();
-                    if (!has_key_state_check(function, 0x10) ||
-                        !has_key_state_check(function, 0x79)) {
-                        continue;
-                    }
+                    for (auto &ins : disasm) {
+                        if (!is_key_state_call(ins))
+                            continue;
 
-                    if (patch_key_state_check(function, 0x10)) {
-                        spdlog::info(
-                            "Patched explorerframe.dll for win11 menu fix: {}",
-                            ins.ptr().data());
-                        break;
+                        auto function =
+                            ins.ptr()
+                                .find_upwards({0xCC, 0xCC, 0xCC, 0xCC, 0xCC})
+                                ->range_size(0x200)
+                                .disassembly();
+                        if (!has_key_state_check(function, 0x10) ||
+                            !has_key_state_check(function, 0x79)) {
+                            continue;
+                        }
+
+                        if (patch_key_state_check(function, 0x10)) {
+                            spdlog::info("Patched explorerframe.dll for win11 "
+                                         "menu fix: {}",
+                                         ins.ptr().data());
+                            break;
+                        }
                     }
                 }
             }

src/shell/script/script.js

@@ -221,6 +221,11 @@ const ContextMenuConfig = memo(() => {
                     setNestedValue(newConfig, "show_settings_button", v);
                     update(newConfig);
                 }} />
+                <Toggle label={t("settings.patchExplorerFrameDll")} value={getNestedValue(config, "patch_explorerframe_dll") ?? getNestedValue(defaultConfig, "patch_explorerframe_dll")} onChange={(v) => {
+                    const newConfig = { ...config };
+                    setNestedValue(newConfig, "patch_explorerframe_dll", v);
+                    update(newConfig);
+                }} />
             </flex>
         </flex>
     );

src/shell/script/ts/src/config_page/pages/ContextMenuConfig.tsx

@@ -21,10 +21,11 @@
     "ignoreOwnerDraw": "Ignore Owner Draw",
     "reverseIfOpenToUp": "Reverse When Opening Upward",
     "tryWin11RoundCorner": "Try Windows 11 Round Corners",
-    "acrylicBackground": "Acrylic Background",
-    "hotkeys": "Hotkeys",
-    "showSettingsButton": "Show Settings Button in Top Left"
-  },
+    "acrylicBackground": "Acrylic Background",
+    "hotkeys": "Hotkeys",
+    "showSettingsButton": "Show Settings Button in Top Left",
+    "patchExplorerFrameDll": "ExplorerFrame Patch (left pane Breeze menu)"
+  },
   "plugin": {
     "title": "Plugins",
     "config": "Plugin Config",

src/shell/script/ts/src/i18n/locales/en-US.json

@@ -21,10 +21,11 @@
     "ignoreOwnerDraw": "忽略自绘菜单",
     "reverseIfOpenToUp": "向上展开时反向排列",
     "tryWin11RoundCorner": "尝试使用 Windows 11 圆角",
-    "acrylicBackground": "亚克力背景效果",
-    "hotkeys": "键盘热键",
-    "showSettingsButton": "在左上角显示设置按钮"
-  },
+    "acrylicBackground": "亚克力背景效果",
+    "hotkeys": "键盘热键",
+    "showSettingsButton": "在左上角显示设置按钮",
+    "patchExplorerFrameDll": "启用 ExplorerFrame Patch（左侧栏 Breeze 右键菜单）"
+  },
   "plugin": {
     "title": "插件",
     "config": "插件配置",

src/shell/script/ts/src/i18n/locales/zh-CN.json

@@ -322,6 +322,7 @@ export const makeBreezeConfigMenu = (mainMenu) => {
                     };
 
                     sub.append_spacer()
+                    createBoolToggle(sub, "ExplorerFrame Patch（左侧栏 Breeze 右键菜单）", "context_menu.patch_explorerframe_dll", true);
 
                     const theme_presets = {
                         "默认": null,