Breeze Shell：Windows上下文菜单的现代化重构方案

功能概述：重新定义Windows交互体验

Breeze Shell作为Windows系统的第三方上下文菜单解决方案，核心价值在于通过模块化架构和可扩展API，解决传统系统菜单在视觉表现、交互体验和功能扩展性上的局限性。与原生菜单相比，该项目提供三大核心改进：

• 动态视觉系统：支持自定义动画曲线、过渡效果和主题配色，所有视觉元素可通过配置文件精确调整
• 脚本化扩展能力：内置QuickJS引擎，允许开发者通过JavaScript API直接操作菜单结构和行为逻辑
• 轻量化架构：核心组件体积小于5MB，内存占用控制在10MB以内，确保系统响应速度

核心特性：技术架构与设计亮点

⚙️ 可配置动画系统

Breeze Shell实现了基于贝塞尔曲线的动画控制引擎，开发者可通过配置文件定义菜单展开/收起的时间曲线、透明度变化和位移轨迹。当你需要为企业级应用定制品牌化交互时，可通过修改src/shell/contextmenu/menu_render.cc中的动画参数实现完全定制化效果。

🔧 多环境注入机制

提供灵活的注入模式满足不同使用场景：

• 全局注入：通过修改系统注册表实现所有上下文场景的持久化替换
• 临时注入：单次会话生效，适合开发调试和功能验证
• 按需注入：针对特定文件夹或文件类型触发定制菜单

🛠️ 双语言扩展API

同时支持C++原生扩展和JavaScript脚本扩展：

• C++层面：通过reflect.hpp实现的反射系统，可直接注册自定义菜单组件
• JavaScript层面：提供shell.menu_controller核心对象，支持动态菜单构建

应用指南：从环境搭建到功能实现

环境准备

确保系统已安装以下依赖：

• Windows 10 1903+ 或 Windows 11
• xmake构建工具（推荐v2.5.1以上版本）
• Visual Studio 2019+ 构建工具链

一键部署流程

# 获取源码
git clone https://gitcode.com/gh_mirrors/br/breeze-shell

# 进入项目目录
cd breeze-shell

# 构建项目
xmake

# 运行注入工具
xmake run inject

若构建失败，可检查xmake.lua中的依赖配置或查看scripts/rebuild.ps1脚本获取详细构建日志

场景化解决方案

案例1：文件批量处理工具集成

当需要为选中的多个文件添加自定义处理功能时，可通过以下JavaScript代码实现：

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 = prompt("请输入基础名称");
            event.selectedPaths.forEach((path, index) => {
              const newPath = `${path.dir}/${baseName}_${index}${path.ext}`;
              shell.file_system.rename(path, newPath);
            });
          }
        }
      ]
    }, 1); // 插入到第二个菜单位置
  }
});

案例2：动画效果定制

修改配置文件src/shell/config.cc中的以下参数，可实现菜单展开动画的个性化调整：

AnimationConfig menuAnimation = {
  .duration = 300,        // 动画持续时间(ms)
  .easing = Easing::OutCubic, // 缓动曲线
  .fadeEnabled = true,    // 淡入淡出效果
  .offsetX = 10,          // X轴偏移量
  .offsetY = 5            // Y轴偏移量
};

生态拓展：模块化组件与生态系统

核心功能模块

1. 渲染引擎

• Breeze UI：轻量级UI渲染库（deps/breeze-ui.lua），支持硬件加速和矢量图形
• Menu Render：菜单布局引擎（src/shell/contextmenu/menu_render.cc），处理动态布局和动画逻辑

2. 脚本系统

• QuickJS：嵌入式JavaScript引擎（src/shell/script/quickjs/），提供高效脚本执行环境
• QuickJSpp：C++封装层（src/shell/script/quickjspp.hpp），简化原生API绑定

3. 系统集成

• 注入模块：实现系统菜单钩子（src/inject/inject.cc）
• 资源管理：系统资源加载与缓存（src/shell/res_string_loader.cc）

插件开发生态

Breeze Shell提供完整的插件开发框架，开发者可通过以下步骤贡献插件：

1. 创建符合src/shell/script/ts/src/plugin/types.d.ts定义的插件结构
2. 实现PluginMetadata元数据和activate激活函数
3. 提交PR到官方仓库的plugins目录

通过这套生态系统，开发者可以专注于业务逻辑实现，而无需关心底层渲染和系统集成细节，极大降低了扩展开发的门槛。