给 Windows 配一套鼠标轮盘手势（StarPie）

Windows 上高频操作的分布很碎。一部分在应用自己的快捷键里，一部分在任务栏和托盘里，还有一部分藏在右键菜单的多级子项下。换一个软件、换一台机器，这套记忆就得重新认一遍。鼠标轮盘手势想做的是给这些操作找一个统一入口，让手不离开鼠标就能把动作打出去。

StarPie（星盘）是 Windows 10/11 的鼠标轮盘手势工具，用 C# 与 WPF 写成，把快捷键、启动程序、网址、OCR 等动作挂到轮盘扇区，按住触发键滑动即触发。

默认交互是按住鼠标右键并滑动超过设定阈值，轮盘在光标位置展开，滑向某个扇区后松开按键就执行对应动作。普通右键单击不受影响，仍然弹出原生菜单。触发键不限于右键，中键、侧键、键盘单键与组合修饰键都能用。程序在本机运行，配置保存在本地 config.json 里，仓库 Topics 标了 local-first 与 offline-first。

五分钟先跑通

仓库目前有两条版本线：正式版 v1.7.4（2026-09-19），以及仍在测试中的 v1.8.0 Beta，最新为 beta.7（2026-10-10）。插件系统和主题工作室属于 Beta 线，不在正式版里，日常使用以 v1.7.4 为准。

Release 提供三种形态的发行包：Setup 安装版、Standalone 独立便携版、Lightweight 轻量版。Standalone 内置 .NET 运行时，解压即用，不需要另外装运行时。

1. 打开 https://github.com/Star-Pie/StarPie/releases ，在 v1.7.4 下面选 Standalone 独立便携版下载。
2. 解压到一个固定目录，运行主程序。除 .NET 运行时已内置这一点外，仓库里没有说明这一步还有别的前置依赖。
3. 在任意窗口里按住鼠标右键滑动超过阈值，轮盘在光标处展开；滑向扇区后松开按键，动作触发。

想自己编译的话，仓库里有 WinPieGestures/、installer/、tests/、plugin/ 等目录，README 也留了「本地构建」章节的入口，具体的构建命令不在可引用的范围里，需要到仓库对应章节查看。

跑通之后你会得到什么

光标所在位置上会出现一个圆形轮盘，默认 8 个扇区，每个扇区挂一个动作。松手执行，不想执行就滑回中心核圆或者向外甩出去取消。动作可以是快捷键、启动程序、打开网址、运行命令等。

配置入口在设置控制台里。动作页是「配置方案 + 聚焦编辑卡片 + 实时轮盘画布」的双栏工作区，也保留了适合快速查看的紧凑全览列表。右侧画布支持缩放、平移、复位、点击选中与拖拽换位，调参数即时可见。

所有配置落在本地 config.json。README 把这一点描述为绿色便携，换机器时带上这个文件就行。

下一步可以做三件事：给不同的前台软件建专属方案；把常用动作的二级子动作挂到扇区外环上；给不常用的动作配上外甩取消，避免误触。

主要功能

鼠标手势呼出与动作触发。按住触发键滑动超过阈值呼出轮盘，滑向目标扇区后松开按键触发。普通右键单击依然弹出原生菜单。呼出方式可选拖动越阈值或长按延时。录制快捷键时可以临时独占并暂停全局热键，避免 Win + D、Alt + Tab 这类系统组合被意外执行。底层走的是 Win32 WH_MOUSE_LL 事件流。

多级级联子轮盘。任意扇区方位可以扩展 1~4 个二级子动作。光标在扇区内停留时，外环以弹性动画展开二级子扇区，向外滑入触发。二级形态有外圈子环与蜂窝扇两种，带迟滞保持和防抖判定，减少边界移动时的闪烁与误收起。一级与二级之间的主题、配色可以完全独立定制，也可以一键同步主轮盘。

扇区数与轮盘形态。支持 4 / 8 / 12 扇区，默认 8。4 键适合盲操，12 键适合动作密集的工作流。中心核圆可以配置独立动作，支持死区松开触发。外形有经典紧凑扇区（Original）、独立悬浮圆形（Circle）、圆角胶囊（Capsule）、蜂巢六边形（HexagonHive）四种。主题预设包括跟随系统、浅色模式、深色模式、液态毛玻璃、抹茶森林、冰川透蓝、莫兰迪柔灰。仓库根目录还留了一个「主题尺寸配置文件」目录。

多程序专属配置方案。按当前前台程序自动匹配专属轮盘配置，没有专属方案时回退到全局配置。方案可新建、复制、删除、重命名。v1.7.4 的继承规则是：新建专属方案默认关闭「继承全局方案未配置槽位」，开启后第 N 层优先继承全局第 N 层，超出全局层数的部分回退到全局第 1 层。

独立轨迹手势。轨迹手势可以单独指定右键、中键或侧键，和轮盘触发键并行使用。支持最多 3 段、8 方向的组合，通过短段过滤与相邻同向合并减少快速绘制时的微小抖动误判。绘制时显示透明轨迹浮层、起点和释放提示，分段灵敏度与提示文字方位可调。

动作类型体系。动作分八类：快捷热键、启动程序、打开网址、打开文件夹、运行命令（CMD、PowerShell、WSL，支持隐藏终端模式）、屏幕 OCR、窗口管理（切换、平铺、跨屏移动、置顶、透明度）、系统控制（锁屏、音量、媒体、任务视图、虚拟桌面）。动作执行与显示图标已经解耦，同一个动作可以独立选内置矢量图标、程序图标或自定义图片。

屏幕 OCR。框选屏幕区域后调用识别，通道有三种：Windows 本地离线识别、AI 视觉接口、自定义 HTTP OCR。

场景隔离与防误触。运行全屏独占应用或游戏时自动放行原生右键；按住 Ctrl / Shift / Alt 时可以绕过轮盘；指定进程可以加入排除名单。界面内置简体中文、繁体中文、English、日本語，切换即时生效。

原生极速搜索与交互音效。v1.7.4 的搜索不再依赖 Everything，改用应用预索引，带分类过滤、搜索按钮与键盘操作。交互音效在高级模式里配置，五类事件可以用合成音效或本地 WAV，音效方案支持导入导出。

v1.8.0 Beta 线在推插件系统。它用 .NET 进程内 DLL 插件架构，插件引用独立的 StarPie.Plugin.Abstractions 契约程序集，通过 Initialize 注册动作等贡献；主程序为每个插件创建宿主包装实例，统一管理扫描、加载、惰性激活、调用租约、异常隔离、异步停用和程序集卸载。官方插件的源码、打包和发布在独立仓库 StarPie-Official-Plugins 里维护，主仓库的 plugin/StarPie-Official-Plugins/ 是它的 Git 子模块检出目录。发行包不携带官方插件 DLL。

常用参数与配置

• config.json：本地配置文件，保存全部方案与外观设置。
• 外甩取消距离灵敏度：可调范围 140px ~ 320px，也可以在设置里整个关闭外甩取消。
• 后台内存：README 给出的静默后台工作集目标是 15 ~ 30 MB，实际占用随环境与使用情况变化。
• 轮盘扇区：4 / 8 / 12 三档，默认 8；二级子动作每个方位 1~4 个。
• 轨迹手势：最多 3 段、8 方向组合。
• 唤醒死区灵敏度：中心核圆的配置项。
• 插件 SDK：v1.8.0-beta.7 兼容 SDK API 1.11，保留 1.10 的交互事件契约，支持桌宠 0.1.5。

结果在哪里看

动作执行的结果直接体现在被操作的窗口上，轮盘本身是唯一的交互界面。配置的结果看设置控制台：双栏工作区右侧的画布会实时反映当前方案的长相，紧凑全览列表适合一次性核对多个扇区里挂了什么。

落盘的结果在 config.json。版本变化在仓库根目录的 CHANGELOG.md，这个文件有 285.2 KB，比一般的更新日志厚很多。插件相关的说明在 plugin/README.md，官方插件另有一个独立仓库。

实际使用中的坑

「高级全量模式」下给某个软件添加第二个轮盘层，任何操作都没反应，只有第一层能用。同一条反馈里还提到，把轮盘切换方式改成 tab 之后功能正常，但界面仍显示「滚轮切换」。这条 Issue 有 12 条评论，目前标记为已解决。

用「启动程序」动作启动的软件无法拖放文件。反馈者用 StarPie 启动 PowerShell 和 renamer 做图和批量重命名，发现拖放图片进去之后加载不了；关掉 StarPie 直接打开这两个软件就正常。这条有 6 条评论，已解决。

任务栏图标的右键功能在星盘后台运行时会失效，唤出星盘控制台之后恢复一会，把控制台关掉或放到后台又会再次失效。同一条反馈还提到，在任务管理器里结束 StarPie 进程只杀掉了 UI，对默认隐藏托盘图标的使用者来说容易造成困惑。这条已解决。

副屏呼出轮盘时，轮盘没有在鼠标位置出现；OCR 屏幕选区也不准确。两条都已解决。后者的成因和 ScreenHelper 有关，README 说它统一处理多显示器、混合 DPI 与屏幕边缘坐标。

还有一条仍标记为待解决的功能建议：希望新增程序专属配置时能自动读取已安装软件的快捷热键和图标，希望给每个软件单独配置轮盘唤醒触发键，以及加一个置顶悬浮球。

选型参考

这两个项目能解决部分相同的问题：和 StarPie 一样，它们都在 Windows 桌面上缩短某个操作路径，重合仅止于此。StarPie 在开箱完整度上不如已经打包好的成品工具。插件系统和主题工作室还在 Beta 线，官方插件要自己下载、启用并设置预加载，主程序不内置。你的需求如果是文件预览或远程连接管理，它接不了；反过来，只想补一个单点小工具的人也用不上整套轮盘。

合规红线

StarPie 的屏幕 OCR 会读取你框选区域的屏幕内容，这是这个工具里唯一会把画面送出去的功能。本地离线识别只在机器上处理；一旦选 AI 视觉接口或自定义 HTTP OCR，选区截图就会发到你配置的那个服务端点，具体传到哪里、留存多久，由那项服务的条款决定。

把 OCR 用在别人的屏幕上、用在工作机上的涉密内容上，或者用于未经授权的信息采集，风险由使用者承担。其余功能都在本机运行，发行包不随包携带官方插件 DLL，仓库标注的也是 local-first 与 offline-first。

什么情况下别用它

只用一个固定软件、快捷键已经够用的人，装它只是多一层要维护的配置。用 macOS 或 Linux 的人直接排除，它只发 Windows 10 / 11 x64。

要求开箱即用、不接受 Beta 功能的人也要想清楚：插件系统和主题工作室还在 v1.8.0 测试线，官方插件需要单独下载安装并按需设置预加载，不随主程序打包。

另外，它不会替代文件预览、远程连接、屏幕录制这类工具。屏幕上那些零散的高频操作如果你已经有一套顺手的方案，换过来的收益有限。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.2 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。