StarPie (星盘)

轻量、快捷的 Windows 鼠标轮盘手势与效率工具

Lightweight, Fast & Configurable Radial Pie Menu for Windows 10 / 11

简体中文 • English

🚀 快速开始 • ✨ 功能特性 • 🎨 外观定制 • 🌐 多语言 • 🛠️ 本地构建 • 💡 开发故事与维护说明 • 📋 更新日志

StarPie (星盘) 是一款专为 Windows 10 / 11 打造的轻量级鼠标轮盘手势（Radial / Pie Menu）效率工具。

在日常使用或专业建模软件中，通过按住鼠标右键滑动，即可在光标所在位置呼出快捷轮盘。支持 4 / 8 / 12 方位动作映射、专属程序配置（Per-App Profiles）、快捷键录制、程序极速启动与多种视觉形态定制，帮助将高频操作转化为自然的肌肉记忆。

💡 设计重点：

• 低资源占用：基于原生 C# WPF 构建，无浏览器内核打包，后台常驻内存约 3 ～ 5 MB；
• 低延迟响应：基于 Win32 WH_MOUSE_LL 底层事件流，响应迅速，不影响鼠标正常右键点击；
• 绿色便携：提供独立单文件版（内置 .NET 运行时，解压即用），配置保存于本地 config.json；

🎬 演示视频 / Video Demo

📺 点击前往 Bilibili 观看原声讲解与实机演示

• 按住鼠标右键滑动超过设定阈值即呼出轮盘，滑向目标扇区后松开按键即可触发对应动作（热键、打开程序、打开文件夹或系统功能）；
• 普通右键单击依然正常弹出原生右键菜单，互不冲突。

• 多级轮盘级联交互：支持在任意扇区方位自由扩展 1~4 个二级子动作。光标划向扇区并在扇区内停留时，外环以弹性动画平滑展开二级子扇区，向外滑入即可极速触发。
• 一二级主题与配色完全独立定制：支持单独调节各级尺寸、字号与图标排版；二级轮盘既可一键同步主轮盘，也可完全独立定制专属风格与配色

• 若划出手势后不想执行任何动作，无需反向拉回中心核圆；
• 只需顺势向外快速滑动脱离轮盘边缘，轮盘自动进入半透明安全取消状态，松开右键不触发任何动作；
• 支持在设置中开启/关闭，并可通过滑块微调外甩距离灵敏度（140px ~ 320px）。

• 4 种几何形态：经典紧凑扇区 (Original)、独立悬浮圆形 (Circle)、圆角胶囊 (Capsule)、蜂巢六边形 (HexagonHive)；
• 多套预设主题：跟随系统、浅色模式、深色模式、液态毛玻璃、抹茶森林、冰川透蓝、莫兰迪柔灰；
• 右侧提供 实时交互预览画布，调节参数即时可见。

• 独立折叠面板，支持微调扇区底色、高亮光晕、边框线条与文字颜色；
• 支持十六进制颜色输入、色盘选取与屏幕吸色；
• 支持将当前颜色保存为自定义预设，并支持一键重命名与删除预设。

• 图标库支持直接导入本地 SVG 矢量文件 与 PNG / ICO / JPG 图片；
• 导入图标自动保存在本地配置目录，支持在所有扇区中自由选用，并支持自定义图标重命名与删除。

• 4 键方位：上下左右大角度，适合盲操；
• 8 键方位：经典 8 向均衡布局（默认）；
• 12 键方位：高密度功能映射，适合多动作工作流。

• 支持针对 Chrome、VS Code、Photoshop、SolidWorks 等不同程序分别设置专属轮盘配置；
• 提供智能应用选择器，自动汇总已安装程序，支持快捷搜索过滤；
• 支持配置方案的新建、复制、删除与一键重命名。

• 全屏与游戏检测：运行全屏独占应用或游戏时自动放行原生右键；
• 修饰键穿透：支持按住 Ctrl / Shift / Alt 时绕过轮盘；
• 黑名单支持：支持将指定进程加入排除名单；
• 多语言热切换：内置简体中文、繁体中文、English、日本語，切换即时生效。

1. 下载并运行 StarPie.exe，程序会在系统托盘中后台运行；
2. 在任意界面按住鼠标右键划动即可唤出轮盘；
3. 滑至目标扇区后松开鼠标右键触发对应操作；
4. 双击托盘图标或右键选择「偏好设置」，即可打开控制台进行详细配置。

可在设置页面的「⚙️ 高级与系统」中随时切换界面语言：

• Windows 10 / 11 (x64)
• .NET 8.0 SDK
• Python 3.10+ (仅运行自动化测试套件需要)

# 1. 克隆代码仓库
git clone https://github.com/SoftBlack42/StarPie.git
cd StarPie

# 2. 编译项目 (Release)
dotnet build WinPieGestures/WinPieGestures.csproj -c Release

# 3. 运行项目
dotnet run --project WinPieGestures/WinPieGestures.csproj

# 安装测试依赖
pip install pytest pywinauto

# 执行测试
python -m pytest tests/test_settings.py -v

StarPie/
├── .github/                   # CI 工作流与社区配置文件
├── WinPieGestures/            # 核心源码工程 (WPF / C# .NET 8)
│   ├── ActionExecutor.cs      # 热键、程序启动与命令执行引擎
│   ├── MouseHook.cs           # Win32 低级鼠标钩子管理
│   ├── GestureController.cs   # 手势轨迹判定与状态机
│   ├── StyleRendererFactory.cs# 轮盘形态渲染器工厂
│   ├── I18n.cs                # 多语言字典
│   ├── ConfigManager.cs       # 配置存储与热重载
│   ├── MemoryOptimizer.cs     # 工作集内存管理
│   ├── ProgramPickerWindow.xaml# 应用程序选择器
│   ├── SettingsWindow.xaml    # 图形化设置控制台
│   ├── RadialWindow.xaml      # 轮盘交互透明窗口
│   └── app_icon.ico           # 应用图标
├── releases/                  # 版本发布归档目录
├── attachments/               # 功能演示动图与截图资源
├── tests/                     # 基于 pywinauto 的自动化测试套件
├── CHANGELOG.md               # 版本更新日志
├── CONTRIBUTING.md            # 贡献指南
├── LICENSE                    # MIT 开源许可证
└── README.md                  # 主文档

本人是机械设计制造及其自动化专业的一名学生。在日常三维建模中经常使用 SolidWorks，觉得其内置的鼠标手势轮盘十分便利。

在接触到 AI Agent 辅助开发工具后，萌生了将这种轮盘操作迁移到 Windows 桌面全局的想法，希望能以此提升日常办公与操作的便利性。对于此前未接触过手势轮盘的朋友，这或许也是一种新颖高效的交互体验。

虽然开源社区已有同类轮盘项目，但在功能侧重点和交互细节上各有不同。从最初构想到发布，中途因学业课程与竞赛有所间断，与 AI Agent 协作断断续续历时约一周完成了当前版本。

项目中若有不够完善或考虑不周之处，还请多包涵。欢迎通过 GitHub Issue 提交 Bug 报告、使用反馈或改进建议！

本项目由开发者主导架构设计、交互逻辑规划与系统调优，并由 AI 智能体（AI Agent - Antigravity）协同完成代码构建、多语言支持与 18 项 GUI 自动化测试验证。

• 当前状态：StarPie v1.4.2 核心功能已完整实现并经过验证，可直接作为日常主力工具使用；
• 后续节奏：近期因学业与求职事务，版本更新将转为阶段性维护模式。欢迎社区伙伴提交 Pull Request 共同完善。

本项目采用 MIT License 开源。