Star-Pie/StarPie

StarPie (星盘)

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

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

简体中文 • English

🌟 功能概览 • 🚀 快速开始 • ✨ 功能特性 • 🎨 外观定制 • 🌐 多语言 • 🛠️ 本地构建 • 📋 更新日志 • 🧪 Beta 测试

🤝 参与贡献 • ⭐ Star 历史 • 💬 社区交流 • ❤️ 支持项目 • 📌 项目状态 • 🙏 特别鸣谢

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

在日常使用中可通过鼠标右键 / 中键 / 侧键或键盘触发键呼出快捷轮盘，也可使用独立的轨迹手势直接执行动作。v1.7.4 正式版支持 4 / 8 / 12 方位轮盘、多级子动作、专属程序配置（Per-App Profiles）、窗口管理与平铺、屏幕 OCR、快捷键录制、网址与命令调度，以及更完整的视觉形态定制，帮助将高频操作转化为自然的肌肉记忆。

💡 设计重点：

• 低资源占用：基于原生 C# WPF 构建，无浏览器内核打包，后台常驻内存以轻量化为目标，静默后台工作集目标为 15 ～ 30 MB（实际占用随环境与使用情况变化）；
• 低延迟响应：基于 Win32 WH_MOUSE_LL 底层事件流，响应迅速，不影响鼠标正常右键点击；
• 绿色便携：提供独立单文件版（内置 .NET 运行时，解压即用），配置保存于本地 config.json；

🎬 演示视频 / Video Demo

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

StarPie v1.7.4 延续轮盘、轨迹手势、窗口管理与屏幕 OCR 等能力，重点带来 纯原生极速搜索、专属方案隔离与多层继承优化、自定义交互音效、精简控制台、渲染性能优化和安装版。

📋 更完整的版本变化请查看 CHANGELOG.md。

• 按住鼠标右键滑动超过设定阈值即呼出轮盘，滑向目标扇区后松开按键即可触发对应动作（热键、打开程序、打开文件夹或系统功能）；
• 普通右键单击依然正常弹出原生右键菜单，互不冲突；
• 支持右键、中键、侧键、键盘单键与组合修饰键作为触发键，并可选择拖动越阈值或长按延时呼出；
• 录制快捷键时可临时独占并暂停全局热键，避免 Win + D、Alt + Tab 等系统组合被意外执行。

• 多级轮盘级联交互：支持在任意扇区方位自由扩展 1~4 个二级子动作。光标划向扇区并在扇区内停留时，外环以弹性动画平滑展开二级子扇区，向外滑入即可极速触发。
• 一二级主题与配色完全独立定制：支持单独调节各级尺寸、字号与图标排版；二级轮盘既可一键同步主轮盘，也可完全独立定制专属风格与配色；
• 支持外圈子环与蜂窝扇两种二级形态，加入迟滞保持和防抖判定，降低边界移动时的闪烁与误收起；
• 一级与二级动作均支持拖拽对调，并可选择拖动一级动作时是否同步交换其二级子动作。

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

• 4 种几何形态：经典紧凑扇区 (Original)、独立悬浮圆形 (Circle)、圆角胶囊 (Capsule)、蜂巢六边形 (HexagonHive)；
• 多套预设主题：跟随系统、浅色模式、深色模式、液态毛玻璃、抹茶森林、冰川透蓝、莫兰迪柔灰；
• 右侧提供 实时交互预览画布，支持缩放、平移、复位、点击选中与拖拽换位，调节参数即时可见；同时提供屏幕边缘防溢出策略与 X / Y 安全边距。

• 4 键方位：上下左右大角度，适合盲操；
• 8 键方位：经典 8 向均衡布局（默认）；
• 12 键方位：高密度功能映射，适合多动作工作流；中心核圆也可配置独立动作，并支持唤醒死区灵敏度。

• 支持针对 Chrome、VS Code、Photoshop、SolidWorks 等不同前台程序分别设置专属轮盘配置；
• StarPie 会根据当前活动程序自动匹配对应方案，没有专属方案时回退到全局配置；
• 支持配置方案的新建、复制、删除与一键重命名，方便复用和维护不同工作流。
• v1.7.4 继承规则：新建专属方案默认关闭「继承全局方案未配置槽位」；按需开启后，第 N 层优先继承全局第 N 层，超出全局层数的部分回退到全局第 1 层。
• 中心核圆动作随当前活跃层同步，切层时同步更新外圈子轮盘与高亮状态。

• 动作页采用“配置方案 + 聚焦编辑卡片 + 实时轮盘画布”的双栏工作区，也保留适合快速查看多个动作的紧凑全览列表；
• 提供智能应用选择器，可汇总已安装程序，并支持名称搜索与快速过滤；
• 提供运行窗口捕捉器，可直接选择当前桌面上的窗口或进程，减少手动查找可执行文件路径；
• 可直接点击画布选择目标扇区，并拖拽交换一级扇区、二级动作和中心核圆的位置；
• 中心核圆可启用独立动作，支持死区松开触发、常用预设及独立文字和图标排版；
• 每个扇区可独立覆盖布局模式、字体、字号、文字颜色、图标大小、文字位置及 X / Y 偏移。

• 全屏与游戏检测：运行全屏独占应用或游戏时自动放行原生右键；
• 修饰键穿透：支持按住 Ctrl / Shift / Alt 时绕过轮盘；
• 黑名单支持：支持将指定进程加入排除名单；
• 多语言热切换：内置简体中文、繁体中文、English、日本語，切换即时生效；ScreenHelper 统一处理多显示器、混合 DPI 与屏幕边缘坐标，减少副屏唤起漂移和轮盘溢出。

• 可为轨迹手势单独指定右键、中键或侧键，与轮盘触发键并行使用；
• 支持最多 3 段、8 方向的轨迹组合，通过短段过滤和相邻同向合并减少快速绘制时的微小抖动误判；
• 绘制时显示透明轨迹浮层、起点和释放提示，可调节分段灵敏度及提示文字方位；
• 未达到拖动阈值的轻点会回放为原生鼠标点击，不影响日常操作。

动作执行与显示图标已经解耦，同一动作可独立选择内置矢量图标、程序图标或自定义图片，不再被动作类型限制。

本节集中介绍仍在测试中的插件系统与主题工作室；这些内容不属于 v1.7.4 正式版。

StarPie 使用轻量的 .NET 进程内 DLL 插件架构。插件只需引用独立的 StarPie.Plugin.Abstractions 契约程序集，通过 Initialize 注册动作等贡献；主程序则为每个插件创建 宿主包装实例，统一管理扫描、加载、惰性激活、调用租约、异常隔离、异步停用和程序集卸载。

Beta 开发线的动作执行路径已具备从注册、配置、参数校验到 Sequential / Background 调度的完整基础闭环； 交互事件与轮盘结构路径也已建立可扩展入口，后续可以继续扩展而不复制整套插件生命周期代码。

📖 插件开发入口：开发文档、当前 API、架构说明、示例工程和历史资料统一收录在 《StarPie 插件开发资源》。 🔗 官方插件仓库：StarPie-Official-Plugins。主仓库中的 plugin/StarPie-Official-Plugins/ 是该仓库的 Git 子模块检出目录；官方插件的源码、打包和发布流程均在这个独立仓库中维护，StarPie 主仓库不重复引用、构建或随发行包携带官方插件 DLL。

• 官方插件手动安装与一次性引导例外 (v1.8.0 Beta)：

  • 发行包零预置：StarPie 发行包不随包携带官方插件 DLL，启动与后台运行保持零自动网络请求。
  • 一次性引导知情同意例外：为了提升新用户上手体验，v1.8.0 Beta 在用户首次交互式打开设置窗口时（非静默启动、非自检模式，且插件系统正常开启），会弹出一次性知情引导弹窗。弹窗展示 5 项核心官方插件（folder, weburl, launch, system, shelltool）、官方仓库来源及所需权限（Process 启动进程、InputSimulation 按键模拟）。
  • 零网络请求原则：用户点击“一键安装”前，宿主绝对不发起任何网络请求（不拉取 catalog、不下载包）；用户点击“一键安装”后，仅下载安装缺失项；已安装项跳过（不覆盖、不升级、保留禁用状态）；若官方目录中包含超出预告范围的权限，暂停并请求用户确认。
  • 常驻重试入口：若用户选择“暂不安装”或部分项下载失败，在「插件与扩展」页面顶部常驻提供一键重试/安装横幅，已成功项保留，随时可补全缺失项。

• 社区插件仍可本地安装：把社区插件 .dll 放进程序目录的 plugin 文件夹后点「重新扫描」，在候选卡片上点安装；或在设置里点「手动安装社区插件 (.dll)」直接挑文件。

• ⚠️ 放进 plugin\ 只会用那一枚 .dll：插件包里的其它文件（图标、资源、依赖 dll） 不会被一起复制过去。需要整包安装时请改用「手动安装社区插件 (.dll)」，选中插件包目录里带 plugin.json 的那一枚 —— 识别到清单后宿主会整目录复制。

• 两个目录职责分开，互不干扰：

  目录	角色
  <程序目录>\plugin\	社区插件候选区：仅用于手动安装社区 .dll；StarPie 只读不写，不会在这里创建任何文件
  %LOCALAPPDATA%\StarPie\plugin-data\	可写数据目录：安装副本、启用状态、插件私有数据都在这里，卸载时整目录清除

• 安装与启用分离：装完默认是「已安装但未启用」，必须手动勾选才会加载 —— 避免「放一份文件进去」等价于「放行它的代码」。安装前会展示 ID、版本、作者、目标框架、 架构、SHA256、签名状态与声明的能力清单。

• 候选卡片会直接告诉你结论：可安装 / 有新版本 / 版本更旧 / 已装同版本 / 内容已变 / ID 重复 / 无法识别。同一 ID 出现两份文件时两份都会被标成「ID 重复」且不给安装按钮。

• 失败自保护：单个插件加载失败或连续触发异常会被隔离，不影响 StarPie 本体； 连续两次启动异常会进入安全模式并临时禁用可疑插件。

• 给插件作者：先阅读 插件开发资源 中的快速入门和当前源码入口。历史 plugin/samples/ 模板不在当前 checkout，不能照旧路径构建；FloatingBall 当前源码位于官方插件子模块。调试时可用 StarPie.exe --plugin-selftest <插件.dll> [报告路径] --skip-invoke 在临时沙箱里跑 全链路自检（不会碰你已装好的插件），或用 StarPie.exe --plugin-paths 查看当前生效的目录。

「外观样式 → 主题工作室」提供纸感极简、曜石科技、森林柔和、冰川玻璃、复古像素五套风格，可复制编辑配色、字体、圆角与轮盘材质，支持即时预览和主题文件导入／导出。

查看 主题工作室说明 或 可导入示例。旧配置和独立轮盘配色继续保留。

当前正式版：v1.7.4（2026-09-19）。安装版和独立便携版内置 .NET 8；轻量版需要目标电脑已安装 .NET 8 Desktop Runtime。

同一发布页提供 SHA256SUMS.txt，可用于核验下载文件。升级 v1.7.4 后，建议检查专属方案继承、多层动作、中心核圆动作和自定义音效方案。

1. 下载并运行 StarPie.exe，程序会在系统托盘中后台运行；
2. 双击托盘图标打开设置窗口，在「触发设置」中录制轮盘触发键；
3. 按住触发键拖动超过阈值，或按配置长按，即可在光标附近唤出轮盘；
4. 滑至目标扇区后松开触发键执行动作，向外甩出则可取消或执行自定义取消动作；
5. 如需轨迹手势，可启用独立手势触发键，并在动作页映射 1～3 段方向组合。

以下命令检出 v1.7.4 正式版标签。如需参与 v1.8.0 Beta 开发，克隆默认 main 分支并参阅 插件文档；主线源码可能领先于正式发布。

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

# 1. 克隆代码仓库
git clone --branch v1.7.4 https://github.com/Star-Pie/StarPie.git
cd StarPie

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

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

# 4. 发布轻量版（需要目标电脑安装 .NET 8 Desktop Runtime）
dotnet publish WinPieGestures/WinPieGestures.csproj -c Release -r win-x64 --no-self-contained -o releases/local/Lightweight

# 5. 发布独立版（自带 .NET 运行时）
dotnet publish WinPieGestures/WinPieGestures.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true -o releases/local/Standalone

• 正式版：v1.7.4，发布于 2026-09-19。
• 测试线：v1.8.0 Beta；插件系统仍处于测试，预发布资产与记录见 Releases 和 CHANGELOG.md。

Windows 免费代码签名由 SignPath.io 提供，证书由 SignPath Foundation 提供。

QQ 公测群

欢迎使用 QQ 扫描二维码加入 StarPie 公测群，群号：1079199287。

也欢迎在 GitHub 中与我们交流：

请保持友善、尊重与耐心，尽量提供可复现的信息；不要公开密码、API Key 或含隐私的配置文件。

如果 StarPie 对你有帮助，你可以通过以下方式支持项目：

• 给 项目仓库 一颗 Star，或分享给需要鼠标手势与效率工具的朋友。
• 在 Discussions 分享你的主题、使用场景和演示素材。
• 提交有复现步骤的反馈，或按照 贡献指南 帮助完善代码、翻译和文档。

欢迎提交代码、文档与翻译改进，也欢迎提供主题、演示素材和兼容性反馈。开始前请阅读 贡献指南；插件开发请参阅 插件开发文档。

• 反馈问题：先搜索 已有 Issues，再附上 StarPie 版本、Windows 版本、复现步骤与必要的截图或日志。分享日志前请移除隐私信息。
• 讨论方案：涉及交互行为、配置兼容或插件契约的改动，建议先在 Issue 或 Discussions 中沟通。
• 提交改进：通过 Pull Request 说明改动目的、验证结果与尚未验证的部分；视觉效果和真实系统交互仍需实机验收。

感谢所有 项目贡献者 的参与！