macOS 菜单栏小工具,做四件事:
- 平滑滚动 —— 把滚轮的一格一格跳动变成逐帧的像素级滚动
- 独立反向 —— 只反转鼠标滚轮的方向,触控板不受影响
- 指针速度 —— 逐个设备调整指针速度,任何品牌的鼠标都适用,不需要厂商驱动
- 按键与手势 —— 把鼠标的额外按键映射成系统动作、自定义快捷键,或手势导航
基于 Core Graphics 事件管线实现,没有内核扩展、没有驱动、不需要关闭 SIP。滚动手感默认值对齐 Mos;Logitech 按键接管参考 HID++ 开源逆向资料,手势导航则按 2026-08-31 对 Logi Options+ 实际输出的事件采样实现。
同类软件只能开一个。 Mos / LinearMouse / Mac Mouse Fix / Scroll Reverser / BetterTouchTool / Logi Options+ 都会抢同一条事件链,谁赢取决于启动顺序,表现出来像随机失灵。Open Mouse 检测到这种情况会在设置页顶部直接点名。
到 Releases 下载 OpenMouse-x.y.z.zip,解压后把 Open Mouse.app 拖进「应用程序」。需要 macOS 14 以上。
首次启动有三件事要做:
- 首次打开会被拦下来 —— 本版本没有 Developer ID 与 Apple 公证。双击后到「系统设置 › 隐私与安全性」,在下方找到提示点「仍要打开」。
- 授予辅助功能权限 —— 系统设置 › 隐私与安全性 › 辅助功能 → 打开 Open Mouse。授权后一秒内自动接管,不用重启应用。
- Logitech HID++ 设备还需输入监控 —— 系统设置 › 隐私与安全性 › 输入监控 → 打开 Open Mouse,才能可靠读取蓝牙直连 Logitech 鼠标的物理按住与抬起。
当前 GitHub 二进制是未公证的固定自签名社区发布包。自 v0.6.1 起,每个版本都由同一张证书与显式 Designated Requirement 签名;从旧 ad-hoc 版本迁移时需要最后重新授权一次,之后正常替换升级通常会保留辅助功能 / 输入监控权限。自 v0.6.2 起支持应用内自动更新:下载的新版本必须满足当前版本自己的 Designated Requirement(即由同一张证书签发)才会被安装。
配置存在 ~/Library/Application Support/OpenMouse/preferences.json,是给人看的 JSON,可以直接编辑。
| 能力 | 说明 |
|---|---|
| 平滑滚动 | 吞掉离散滚轮事件,逐帧合成像素级滚动,锁显示器 vsync |
| 反转方向 | 垂直 / 水平独立开关,只作用于滚轮鼠标 |
| Shift + 滚轮 | 按住 Shift 时把垂直滚轮切换为水平滚动;触控板与物理横向滚轮不受影响 |
| 最短步长 | 单次滚动至少走多少像素,默认 35 |
| 速度增益 | 在系统上报的像素增量上再乘的倍数,默认 3.00 |
| 平滑度 | 0% 干脆跟手 → 98% 顺滑绵长,默认 87% |
| 加速度 | 连续快速滚动时额外放大距离,默认关 |
| 预设 | 默认 / 顺滑 / 干脆,只改手感,不动方向与设备选择 |
| 实时试滚区 | 设置页内嵌可滚动区域,拖滑块即刻感受效果 |
触控板与 Magic Mouse 默认完全不碰 —— 它们本来就是像素级连续滚动,插手会破坏手势与惯性。
给任何品牌的鼠标单独调整指针速度,不依赖厂商驱动、不需要 root、也不需要额外权限。做法是往 HID 事件系统里该设备的服务写指针加速属性,所以厂商 ID 不重要——Logitech 的 HID++ DPI 切换是私有协议,这条路不是。
设备是勾选而不是自动接管:系统给出的信息不足以可靠区分鼠标、键盘和虚拟指针设备(本机 135 个服务里有 4 个自称鼠标,其中一个是键盘、一个是 Karabiner 的虚拟设备),与其猜错不如让你选。勾选后滑块旁边有数字输入框,可以直接输入精确值。
写入失败在界面上会说出来:「设备未连接」「设备不支持」「系统拒绝了设置」是三条不同的提示,不是同一个没反应的滑块。取消勾选、关闭总开关或退出应用都会把设备交还给系统的跟踪速度。
三模鼠标会占两行。 同一只鼠标在有线和无线下会被系统报成两台不同的设备,名称和 ID 都不一样(实测 MCHOSE A5:有线 MCHOSE A5 / 0x2023,蓝牙 MCHOSE A5 5.0 / 0x1234),拔掉线它会在半秒内切到蓝牙回来。想让它换连接方式后手感不变,把两行都勾上——勾一次就会一直记住。每行都标了连接方式,不用靠 ID 猜。没有按名字自动认成同一台:那会把你没勾选的设备也一起改掉。
诊断日志:
/usr/bin/log stream --predicate 'subsystem == "com.openmouse.OpenMouse" && category == "pointer"'具体限制见文末「已知限制」。
不预设按键列表 —— 不同鼠标能报出的按键并不一样。按下你想用的键,它才出现在列表里,然后为它选择动作。录入时可以同时按住修饰键,给同一个物理键配出不同组合:侧键 4 = 后退,⌘ + 侧键 4 = 调度中心。
**M720 隐藏拇指键(实验性,蓝牙直连或标准 Unifying)**已接入独立按键录入,以「拇指键」显示,可设置自定义快捷键或手势导航,不与前进/后退键共用绑定。Unifying 当前限定 C52B / C532 接收器上的 M720,按设备类型和无线 ID 405E 确认槽位,不接管键盘。需要辅助功能与输入监控权限,并退出 Logi Options+ 等同类软件。本项目尚无 M720 实机验证,回测步骤与诊断见 蓝牙说明和 Unifying 说明。
共 65 个动作,按类别收进二级菜单:
| 类别 | 动作 |
|---|---|
| 鼠标 | 切换 DPI(两个可配置的硬件档位,默认 1000 ↔ 1600 DPI;当前硬件档位会高亮) |
| 窗口与桌面 | 调度中心、应用程序窗口、显示桌面、左右切换桌面、循环切换窗口、启动台、显示 / 隐藏 Dock、切换应用(⌘⇥)与反向、最小化、隐藏当前 / 其他应用、关闭全部窗口、退出当前应用 |
| 浏览与编辑 | 后退 / 前进、新建 / 关闭标签页、上一个 / 下一个标签页、复制 / 粘贴 / 剪切、撤销 / 重做、全选、查找、放大 / 缩小 |
| 文件 | 新建 Finder 窗口、新建文件夹、移到废纸篓、清倒废纸篓、复制文件、显示简介、前往文件夹、图标 / 列表 / 分栏 / 画廊显示 |
| 媒体 | 播放暂停、上一曲 / 下一曲、音量增减、静音 |
| 系统 | 聚焦搜索、控制中心、截屏(全屏 / 选区)、截屏与录屏、切换输入法、快速备忘录、锁定屏幕、Esc、表情与符号、强制退出、退出登录、反转颜色 |
| 自定义 | 自定义快捷键(录入任意组合)、打开指定应用 |
手势导航(Logi Options+ 风格):把一个键设成手势导航,然后按住它 ——
| 操作 | 结果 |
|---|---|
| 原地单击 | 调度中心 |
| 上划 | 调度中心 |
| 下划 | 应用程序窗口 |
| 左划 | 切到右边的桌面 |
| 右划 | 切到左边的桌面 |
横向是刻意反的:把鼠标往左推等于把当前桌面推开,和触控板划动同向。横向越过 7px 死区即锁定;上下需要 14px 且至少是横向的两倍,避免按侧键时的轻微抖动误开调度中心或应用程序窗口。锁定方向后,一次物理按住只触发第一次移动对应的一个系统动作;同一次按住中的继续移动、速度变化和反向都不会重复触发。松开后重新按住,即使上一段桌面动画尚未结束,也会立即发送下一次或反方向动作。这个模型来自对 logioptionsplus_agent 的实际采样:左右切换分别是一次 Control + Left/Right Arrow,没有 Dock-swipe 进度或速度事件。
- 应用例外:为指定应用完全不干预,或使用独立的滚动参数;菜单栏可一键为最前面的应用停用
- 冲突检测:同类软件在运行时直接点名
- 实时诊断:拦截了多少、合成了多少、帧源是 vsync 还是定时器兜底、事件投给了哪个进程
- 更新检查:直接读取 GitHub Releases(不使用限流 API);验证新包满足当前版本自己的 Designated Requirement 后应用内自动安装并重启,Developer ID 与固定社区证书两种发布身份都支持
- 登录时启动
- 空闲时零开销:没有滚动时帧源会销毁,事件掩码只订阅当前配置真正需要的事件
只需要 Xcode Command Line Tools(xcode-select --install),不需要完整 Xcode。
make app # 编译 + 组装正式名称的 .app → build/Open Mouse.app
make debug # 独立测试包 → build/Open Mouse Debug.app
make debug-run # 构建并启动独立测试包(单独的 Bundle ID、权限和配置)
make run # 构建并启动正式名称的本地包
make install # 拷到 /Applications 并启动(登录项注册需要装在这里)
make test # 跑全部内置自检
make dist # Developer ID 发布包(需要显式传入证书)
make dist-community # 无 Developer ID 时,使用固定自签名证书打包未公证版本v0.3.0 使用过 Apple Development 签名,独立更新助手会被其他 Mac 拒绝启动;v0.4.0 至 v0.6.0 改为 ad-hoc 社区包,但 CDHash 每版变化会重置 TCC 权限。自 v0.6.1 起社区包固定使用仓库公开证书 Resources/OpenMouseCommunitySigning.cer 对应的自签名身份,Requirement 同时锁定 Bundle ID 与证书指纹。私钥只存在发布者钥匙串和加密 .p12 备份中。社区包仍未公证,但自 v0.6.2 起启用应用内安装:门槛按证书指纹(不是证书名称,自签名证书的名称谁都能伪造)识别固定社区身份,make dist 的 Developer ID 包同样启用。从 v0.6.1 之前的 ad-hoc 版本升级仍需手动下载一次,因为 ad-hoc 的 Requirement 是每版变化的 CDHash,新包不可能满足它。若授权条目变成勾了也不生效的幽灵项,用 make tcc-reset 清掉重来。
命令行开关:
OpenMouse --self-check # 跑内置自检并退出,返回码即结果
OpenMouse --verbose # 把事件管线计数实时打到 stderr
OpenMouse --tab buttons # 启动即打开指定设置页(scroll/buttons/apps/general)
OpenMouseUpdater --validate-signature old.app new.app # 验证两个 Developer ID 发布包身份连续排查「到底有没有在工作」最快的手段是 --verbose:smoothed 是被吞掉的滚轮格数,synthesized 是合成出去的事件数,后者显著大于前者说明插值在跑。frameSource=timer 表示没锁上 vsync,那滚动会带轻微抖动。
- HID++ 当前聚焦蓝牙可编程按钮、M750 DPI 与 M720 拇指键 —— 蓝牙直连使用鼠标接口;标准 Unifying
C52B / C532则通过专用 vendor 接口找到 M720 槽位,当前只接管一个 M720 的拇指键,普通侧键仍走 CGEvent,不承诺接收器下的物理长按增强。Bolt / Nano / Lightspeed、USB 有线及其他接收器鼠标尚未接入。M750 的硬件 DPI 切换仍只走蓝牙,档位表固定为 400–4000 / 100 步进,不读取设备上报档位。非 Logitech 鼠标(厂商 ID 不是0x046D)完全不适用。SmartShift 和高分辨率滚轮开关尚未实现 - 指针速度是加速曲线,不是硬件 DPI —— 逐设备生效、任何品牌都适用、不需要额外权限,但它调的是 macOS 的指针加速曲线:快速甩动被放大的比例高于慢速微调。真正等价于 DPI 的
HIDPointerResolution在 macOS 26 上已经写不进去(实测写入被拒且无任何效果),所以做不到线性缩放。另外,在「系统设置 › 鼠标 › 跟踪速度」拖动后系统会覆盖这里的值——重新插拔设备、系统唤醒或改动本页都会重新生效,但不会立刻纠正 - 设备列表里会出现键盘和虚拟指针设备:系统暴露的信息不足以可靠区分它们(
kIOHIDBuiltInKey在本机所有鼠标上都是 nil),所以由用户勾选而不是自动接管 - 界面目前只有中文文案,都在
Strings.swift里 - 没有做 Apple 公证
- Mos 的「聚焦」(键码 177)与「听写」(176)在 macOS 26.6 上实测已失效,故未收入
MIT License。第三方代码声明见 THIRD_PARTY_NOTICES.md。