RingSwitch

一个快速、原生、注重隐私的 macOS 圆环式应用切换器。

English

按住鼠标中键或设定的侧键，RingSwitch 会在光标位置显示当前正在运行的普通应用。拖向目标扇区并松开即可切换；拖回圆心立即取消。

为什么使用 RingSwitch

• 更短的操作路径：在当前光标位置完成应用选择，不必移动到 Dock。
• 方向式选择：拖动时高亮对应扇区，松开立即切换。
• 原生体验：使用 Swift、AppKit 与系统应用图标，无第三方运行时依赖。
• 本地优先：无网络请求、无遥测，不记录键盘输入或鼠标轨迹。
• 低打扰：常驻菜单栏，不占用 Dock；支持全屏空间和多个桌面空间。

核心交互

1. 按住设定的鼠标按键，默认是中键。
2. 圆环出现在当前光标位置。
3. 保持按住并拖向目标应用，扇区随即高亮。
4. 松开鼠标按键，切换到高亮应用。
5. 进入扇区后拖回圆心，立即取消并隐藏圆环。

RingSwitch 只显示已经运行且 activationPolicy == .regular 的 GUI 应用，不负责启动尚未运行的应用。当前应用仍会显示，但排列在圆环末尾。

功能

• 动态读取当前运行的普通 GUI 应用
• 显示应用原生图标与当前应用状态
• 根据本地激活记录维护最近使用顺序
• 支持中键、侧键一、侧键二和附加鼠标键
• 扇区命中、高亮、触觉反馈与松开切换
• 圆心即时取消
• 菜单栏权限状态与触发按键设置
• 支持全屏空间和多个桌面空间
• 无网络请求、遥测和第三方依赖

系统要求

• macOS 13 Ventura 或更高版本
• Xcode 15 或兼容的 Command Line Tools
• 辅助功能权限

RingSwitch 使用全局事件监听识别并拦截设定的鼠标触发键，因此必须获得“系统设置 → 隐私与安全性 → 辅助功能”权限。

首次启动时 macOS 会请求辅助功能权限。如果替换了应用路径或重新签名，可能需要在系统设置中重新授权。

该命令执行 Debug 编译与方向选择算法单元测试。涉及鼠标监听、全屏空间或多显示器的修改仍需人工验证，参见 贡献指南。

开源协作

• 提交代码前请阅读 CONTRIBUTING.md。
• 参与社区互动即表示同意遵守 CODE_OF_CONDUCT.md。
• 安全问题请按照 SECURITY.md 私下报告。
• 版本变化记录在 CHANGELOG.md。
• 计划中的方向记录在 ROADMAP.md，不代表交付承诺。

许可证

RingSwitch 基于 MIT License 开源。