Breeze Shell：轻量级交互框架赋能 Windows 右键菜单自定义开发

🔥 核心价值：重新定义 Windows 上下文体验
Breeze Shell 作为替代 Windows 传统上下文菜单（右键菜单系统）的轻量级交互框架，其核心创新在于动态交互引擎——通过毫秒级响应的动画系统与可扩展的脚本接口，实现菜单交互体验的颠覆性升级。不同于静态传统菜单，该框架支持实时主题切换、交互式动画参数调整（如 0-300ms 过渡时长自定义）及多场景行为适配，完美解决 Windows 10/11 菜单交互同质化问题。

🛠️ 环境准备：5分钟零门槛部署

系统要求

• Windows 10 1809+ 或 Windows 11 21H2+
• xmake 2.7.9+ 构建工具
• Visual Studio 2022 生成工具（C++ 环境）

快速部署流程

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/br/breeze-shell

# 进入项目根目录
cd breeze-shell

# 环境依赖校验
xmake --version  # 需返回 2.7.9+
cl.exe  # 验证VS构建工具是否就绪

# 构建项目（首次构建约3分钟）
xmake -j8  # 8线程并行编译

⚠️ 构建失败解决方案：若提示缺少依赖，执行 xmake config --vs=2022 重新配置开发环境

构建完成后，可在 build/windows/x64/release/ 目录找到 breeze.exe，双击启动即可激活增强型上下文菜单。

💡 功能实现：从基础配置到高级扩展

1. 基础交互定制

通过配置文件 src/shell/config.h 可调整核心视觉参数：

• 菜单圆角半径（0-24px）
• 背景模糊强度（0-100%）
• 动画缓动函数（支持 ease-in/out、linear 等 8 种预设）

2. 脚本化菜单扩展

利用内置 QuickJS 引擎（「src/shell/script/quickjs/」），通过 JavaScript API 实现功能扩展。以下示例实现文件批量重命名工具：

// 注册菜单监听器
shell.menu_controller.add_menu_listener((event) => {
  // 仅在选中多个文件时显示
  if (event.selectedPaths.length > 1) {
    event.menu.add({
      type: "submenu",
      name: "智能重命名",
      children: [
        {
          type: "button",
          name: "序号递增命名",
          action: () => {
            const baseName = "file_";
            event.selectedPaths.forEach((path, index) => {
              const newPath = `${path.dir}/${baseName}${index + 1}${path.ext}`;
              shell.file_system.rename(path.full, newPath);
            });
          }
        }
      ]
    }, 1);  // 插入到菜单第2个位置
  }
});

3. 跨版本适配方案

针对 Windows 11 菜单样式差异，框架提供「src/shell/fix_win11_menu.cc」补丁模块，通过以下 API 实现版本兼容：

// C++ 示例：动态调整菜单边距
void adjustMenuMargins(HWND hMenu, OSVersion version) {
  if (version >= OS_WIN11) {
    SetMenuInfo(hMenu, &kWin11MenuStyle);  // 应用Win11圆角样式
  } else {
    SetMenuInfo(hMenu, &kWin10MenuStyle);  // 保留传统直角边框
  }
}

🔄 生态拓展：模块化协作体系
Breeze Shell 生态由四大核心组件构成有机协作网络：

1. 动态交互引擎「src/shell/contextmenu/」

• 功能：处理菜单渲染与用户输入事件
• 协作方式：通过反射接口（「src/shell/reflect.hpp」）向脚本层暴露渲染控制API

2. QuickJS 脚本引擎「src/shell/script/quickjs/」

• 功能：执行用户自定义JavaScript扩展
• 协作方式：通过「src/shell/script/binding_types.cc」实现C++/JS类型桥接

3. Breeze UI组件库「deps/breeze-ui.lua」

• 功能：提供预定义动画组件与主题系统
• 协作方式：通过Lua脚本动态注入样式表

4. 进程注入模块「src/inject/inject.cc」

• 功能：实现资源管理器菜单钩子
• 协作方式：通过「src/inject/data_directory.inc」配置注入规则

通过上述模块化设计，开发者可专注于功能逻辑实现，框架自动处理底层交互与系统兼容。目前生态已支持文件操作、网络请求、系统通知等20+核心能力，第三方插件可通过「src/shell/script/ts/src/plugin/」接口快速集成。

扩展提示：所有用户脚本默认存放在 %APPDATA%/breeze-shell/scripts/ 目录，支持热重载（修改后3秒内生效）。