OrbitLauncher v0.2.0 Surface Dial Preview 1

OrbitLauncher v0.2.0 Surface Dial Preview 1

这是面向 Microsoft Surface Dial 的实验预览版，基于 OrbitLauncher v0.2.0，并包含
main 分支最新的应用切换、窗口恢复和环形启动器功能。

Surface Dial 新功能

• 通过原始 HID 识别 Microsoft Surface Dial（VID 045E / PID 091B）。
• 圆环隐藏时，第一次旋转直接呼出 OrbitLauncher。
• 圆环显示后继续旋转，可逐格选择应用或快捷操作。
• 按下 Dial 立即确认当前高亮项目。
• 支持读取设备旋转分辨率，并可设置每圈 10–40 个逻辑格位。
• 默认启用 Surface Dial 旋转刻度震动，并按设置的每圈步数配置触觉刻度。
• 设置页面显示 Dial 当前连接状态。

休眠与连接优化

• Dial 长时间无输入后，首个 HID 数据包会被识别为设备唤醒。
• 唤醒时清空休眠前残留的旋转余量，避免第一次旋转跳格。
• 设备唤醒后自动重新发送震动刻度配置。
• Mac 从睡眠状态恢复后自动重建 Surface Dial HID 会话。
• Dial 断开、HID 会话打开失败或输入报告异常时自动重连。
• 保留 Dial 自身的省电休眠，不通过持续轮询增加设备耗电。

同步的主线功能

• 应用切换器与多套环形应用启动器。
• 可选第二层快捷操作；关闭后确认图标会直接切换或启动应用。
• 自定义辅助按键，可关闭当前窗口或彻底退出应用。
• 切换到最小化应用时自动恢复窗口并置于前台。
• 自定义启动快捷键、滚轮格位、圆环尺寸、图标尺寸及应用名称显示。
• 首次启动自动引导辅助功能权限。

安装

1. 下载并解压 OrbitLauncher-macOS-arm64.zip。
2. 将 OrbitLauncher.app 移动到“应用程序”文件夹。
3. 首次启动时按住 Control 点击应用并选择“打开”。
4. 在“系统设置 → 隐私与安全性 → 辅助功能”中允许 OrbitLauncher。
5. 如系统要求，再允许“输入监控”权限。
6. 打开设置，在“编码器与滚轮”中确认“启用原始 HID 支持”已开启。

如果应用被 macOS 隔离，可执行：

xattr -dr com.apple.quarantine /Applications/OrbitLauncher.app
open /Applications/OrbitLauncher.app

已知限制

• 当前附件仅提供 Apple Silicon（ARM64）版本。
• 应用使用临时签名，没有 Apple Developer ID 公证。
• Surface Dial 原始 HID 支持仍为实验功能；不同蓝牙环境下的实际休眠唤醒效果需要硬件测试。

OrbitLauncher v0.2.0

OrbitLauncher v0.2.0

本版本新增可配置的环形应用启动器和应用管理操作，并继续改善鼠标滚轮与旋钮编码器的逐格体验。

新功能

• 新增 OrbitLauncher 应用图标。
• 新增“应用切换器”和“环形启动器”两种工作模式。
• 环形启动器支持建立多套应用组，并可添加、移除、重命名或切换应用组。
• 应用切换器新增辅助操作按键：高亮应用时可关闭当前窗口或彻底退出应用。
• 辅助操作按键可设置为 Space、A–Z、F1–F12 或 Delete。
• 首次启动且尚未授权时，自动打开 macOS 辅助功能授权入口。
• 支持关闭第二层快捷操作；关闭后确认应用图标会直接切换或打开应用。
• 开启第二层时，默认操作固定为“切换当前窗口”。
• 应用与操作名称可选择显示或隐藏。

修复与优化

• 将滚轮步进语义修正为“转动几格切换一次”，不再一格跨越多个应用。
• 反向旋转时重新累计格位，减少误切换。
• 关闭窗口改为优先通过 macOS 辅助功能接口直接操作窗口关闭按钮，失败时回退到 ⌘W。
• 修复辅助关闭操作只切换到目标应用、但没有关闭窗口的问题。
• 保留此前对冷启动首格跳动、重复事件监听、快速旋转漏格、前台应用滚轮失效和第二层默认操作随机等问题的修复。

安装

1. 下载 OrbitLauncher-macOS-arm64.zip 并解压。
2. 将 OrbitLauncher.app 移动到“应用程序”文件夹。
3. 首次启动时按住 Control 点击应用并选择“打开”。
4. 根据首次启动提示，在“系统设置 → 隐私与安全性 → 辅助功能”中允许 OrbitLauncher。
5. 如系统要求，再在“输入监控”中允许 OrbitLauncher。

如果应用仍被 macOS 隔离，可执行：

xattr -dr com.apple.quarantine /Applications/OrbitLauncher.app
open /Applications/OrbitLauncher.app

已知限制

• 当前附件仅提供 Apple Silicon（ARM64）版本。
• 应用使用临时签名，没有 Apple Developer ID 公证。
• Microsoft Surface Dial 原始 HID 支持仍位于 agent/surface-dial 实验分支，本次 main
  Release 不包含该功能。

OrbitLauncher v0.1.0

OrbitLauncher v0.1.0

首个可下载版本。OrbitLauncher 是一款 macOS 原生圆环应用启动器，面向鼠标滚轮、
映射为滚轮的旋钮编码器和键盘操作。

新功能

• 按全局快捷键在鼠标当前位置呼出圆环，快捷键可在设置中修改。
• 第一层显示当前正在运行的应用，并优先排列呼出前的前台应用。
• 可选第二层快捷操作，包含切换当前窗口、所有窗口、隐藏、退出和返回。
• 关闭第二层后，确认应用图标会直接切换或打开对应应用。
• 开启第二层后，默认操作固定为“切换当前窗口”，不会继承第一层的选择位置。
• 支持鼠标滚轮、映射成滚轮的编码器、方向键、回车和空格操作。
• 新增扇区高亮、径向拖动、出现与切换动画，以及浅色、深色和跟随系统外观。
• 可调整圆环尺寸、图标尺寸、滚轮步进、连续切换间隔和启动快捷键。
• 可开关应用与操作名称、切换音效、过渡动画和登录时启动。
• 以菜单栏应用运行，不占用 Dock。

历史问题修复

• 修复 OrbitLauncher 自己位于前台时无法接收滚轮事件的问题。
• 同时支持应用内与全局滚轮事件，兼容其他应用位于前台的使用场景。
• 修复编码器旋转一格却连续切换多项的问题。
• 修复滚轮设置未正确影响实际步进与连续切换速度的问题。
• 改进快速旋转识别，使用滚轮增量峰值识别连续物理格位。
• 修复快速旋转时因固定防抖间隔而漏掉格位的问题。
• 修复圆环被 AppKit 自动隐藏后遗留事件监听器，导致再次呼出时一次输入被处理三次的问题。
• 修复进入第二层时沿用第一层索引、默认操作看起来随机的问题。

安装

1. 下载 OrbitLauncher-macOS-arm64.zip 并解压。
2. 将 OrbitLauncher.app 移动到“应用程序”文件夹。
3. 首次启动时按住 Control 点击应用并选择“打开”。
4. 在“系统设置 → 隐私与安全性 → 输入监控”中允许 OrbitLauncher。

如果应用仍被 macOS 隔离，可执行：

xattr -dr com.apple.quarantine /Applications/OrbitLauncher.app
open /Applications/OrbitLauncher.app

已知限制

• 当前附件仅提供 Apple Silicon（ARM64）版本。
• 应用使用临时签名，没有 Apple Developer ID 公证。
• Microsoft Surface Dial 原始 HID 支持仍位于 agent/surface-dial 实验分支，本次 main
  Release 不包含该功能。