OpenMouse：macOS 菜单栏鼠标增强工具 #
OpenMouse是什么？ #
OpenMouse 是一款运行在 macOS 菜单栏的鼠标增强小工具，用纯 Core Graphics 事件管线接管滚轮与按键事件，为任意品牌的鼠标补齐 macOS 原生缺失的手感与效率能力。它主要做四件事：把滚轮的一格一跳变成逐帧像素级平滑滚动；只反转鼠标滚轮方向而不影响触控板；逐个设备调整指针速度、无需厂商驱动；把鼠标额外按键映射成系统动作、自定义快捷键或 Logi Options+ 风格的手势导航。
它解决的是 Mac 用户在第三方鼠标上长期遇到的痛点：滚动手感生硬、滚轮方向跟着触控板一起被反转、指针速度只能靠厂商驱动调、侧键在 macOS 里几乎无用武之地。OpenMouse 不安装内核扩展、不需要驱动、也不用关闭 SIP，安装后常驻菜单栏，空闲时几乎零开销。
OpenMouse有哪些亮点特色？ #
- 像素级平滑滚动：吞掉系统离散的滚轮事件，逐帧合成像素级滚动并锁定显示器 vsync，手柄默认值对齐 Mos，平滑度默认 87%，可在 0%（干脆跟手）到 98%（顺滑绵长）之间自由调节。
- 只反转鼠标、不碰触控板：垂直与水平方向可独立开关，且只作用于滚轮鼠标；触控板与 Magic Mouse 默认完全不干预，避免破坏原生手势与惯性。
- 任意品牌都能单独调指针速度：不依赖厂商驱动、不需要 root、不需要额外权限，直接往 HID 事件系统中该设备的服务写入指针加速属性，兼容任何品牌的鼠标，并支持精确数字输入。
- 65 个内置动作的按键映射：按下想用的键它才出现在列表里，可为同一物理键叠加修饰键组合（例如侧键 4 = 后退，⌘ + 侧键 4 = 调度中心），动作按鼠标、窗口与桌面、浏览与编辑、文件、媒体、系统、自定义等类别收进二级菜单。
- Logi Options+ 风格的手势导航：把一个键设为手势导航后按住它，原地单击或上划触发调度中心、下划显示应用程序窗口、左右划切换桌面；越过 7px 死区并锁定方向后，一次物理按住只触发一个动作，不会重复触发。
- 同类软件冲突直接点名：Mos、LinearMouse、Mac Mouse Fix、Scroll Reverser、BetterTouchTool、Logi Options+ 都会抢同一条事件链，谁赢取决于启动顺序，表现像随机失灵；OpenMouse 检测到冲突会在设置页顶部直接点名。
- 应用例外与实时诊断：可以为指定应用完全不干预或使用独立滚动参数，菜单栏一键为最前面的应用停用；实时诊断会显示拦截了多少、合成了多少、帧源是 vsync 还是定时器兜底、事件投给了哪个进程。
- 应用内自动更新、零内核扩展：自 v0.6.2 起可应用内自动安装并重启，直接读取 GitHub Releases 不使用限流 API；全程无内核扩展、无驱动、不需关闭 SIP，空闲时帧源销毁、事件掩码只订阅当前配置真正需要的事件。
免费下载 OpenMouse #
以下为官方提供的安装包，点击链接即可下载。需要 macOS 14 以上系统。
| 文件名 | 描述 | 大小 | 下载 |
|---|---|---|---|
| OpenMouse-0.7.10.zip | macOS 菜单栏鼠标增强工具，解压后将 Open Mouse.app 拖入「应用程序」 | 1.7 MB | 夸克网盘 |
提示：当前 GitHub 二进制是未公证的固定自签名社区发布包。首次打开会被 Gatekeeper 拦下，需到「系统设置 › 隐私与安全性」中点击「仍要打开」。也可以自行从源码构建。
OpenMouse 如何使用？ #
- 启动与授权：双击打开 Open Mouse.app，按提示前往「系统设置 › 隐私与安全性 › 辅助功能」勾选 Open Mouse，授权后一秒内自动接管，无需重启应用。若使用蓝牙直连的 Logitech 鼠标，还需在「输入监控」中同样打开 Open Mouse。
- 调整滚动手感（滚动页）：打开平滑滚动开关，拖动「平滑度」「最短步长」「速度增益」滑块，设置页内嵌的实时试滚区可以边拖边感受效果；需要反向时单独打开垂直 / 水平反转开关；按住 Shift 可把垂直滚轮临时切成水平滚动。
- 设置指针速度（指针速度页）：在设备列表里勾选你的鼠标（三模鼠标在有线和无线下会各占一行，想换连接方式后手感不变就把两行都勾上），然后拖动滑块或用旁边的数字输入框输入精确值。取消勾选、关闭总开关或退出应用都会把设备交还给系统。
- 映射按键与手势（按键页）：按下你想用的物理键，它才会出现在列表中，然后从二级菜单里挑选动作；把一个键设为「手势导航」后，按住它上划、下划、左划、右划即可触发不同系统动作。
- 配置例外与排查（其他页）：为指定应用设置不干预或独立滚动参数；若发现设置没反应，先看顶部是否有同类软件冲突提示，再用终端命令
/usr/bin/log stream --predicate 'subsystem == "com.openmouse.OpenMouse" && category == "pointer"'或启动参数OpenMouse --verbose查看事件管线计数。
配置文件位于 ~/Library/Application Support/OpenMouse/preferences.json，是可直接阅读和编辑的 JSON。常用命令行开关包括 OpenMouse --self-check（跑内置自检并退出）、OpenMouse --verbose（实时打印事件管线计数）、OpenMouse --tab buttons（启动即打开指定设置页，可选 scroll/buttons/apps/general）。
OpenMouse的常见问题？ #
打开时提示「无法打开，因为 Apple 无法检查其是否包含恶意软件」怎么办？ 本版本没有 Developer ID 与 Apple 公证，属于正常现象。双击后到「系统设置 › 隐私与安全性」，在下方找到对应提示点击「仍要打开」即可。
为什么设置好了却没有反应，或者时好时坏？ 大概率是同类软件冲突。Mos、LinearMouse、Mac Mouse Fix、Scroll Reverser、BetterTouchTool、Logi Options+ 都会抢同一条事件链，谁生效取决于启动顺序。请在设置页顶部查看 OpenMouse 点名的冲突软件并退出其中之一。
鼠标的侧键 / 额外按键在哪里配置？ OpenMouse 不预设按键列表，因为不同鼠标能报出的按键并不一样。到「按键」页按下你想用的键，它才会出现在列表中，然后为其选择动作即可。
三模鼠标切换连接方式后指针速度设置失效了？ 这是系统把同一只鼠标的有线和无线识别成两台不同设备导致的，名称和 ID 都不一样。把两行设备都勾选即可，勾选一次就会一直记住，每行都标了连接方式，不需要靠 ID 猜。
Logitech 鼠标的 DPI 切换和按键接管为什么不能用？ HID++ 相关能力当前只支持蓝牙直连的 Logitech 鼠标，Bolt / Unifying 接收器与 USB 有线连接都不走这条路径；且仅适用于厂商 ID 为 0x046D 的 Logitech 设备，非 Logitech 鼠标完全不适用。
升级新版后辅助功能权限失效了？
自 v0.6.1 起社区包固定使用仓库公开证书对应的自签名身份，正常替换升级通常会保留辅助功能 / 输入监控权限；但从 v0.6.1 之前的 ad-hoc 版本升级需要手动下载一次并重新授权。若授权条目变成「勾了也不生效」的幽灵项，可用 make tcc-reset 清掉重来。
OpenMouse如何安装？ #
目前 OpenMouse 只支持 macOS（要求 macOS 14 及以上），有两种安装方式。
方式一：下载官方发布包（推荐普通用户）
- 从 Releases 页面下载
OpenMouse-x.y.z.zip（当前为 0.7.10 版本）。 - 解压 zip，把
Open Mouse.app拖进「应用程序」文件夹。 - 首次打开会被系统拦下，前往「系统设置 › 隐私与安全性」，在下方提示处点击「仍要打开」。
- 在「系统设置 › 隐私与安全性 › 辅助功能」中勾选 Open Mouse，授权后一秒内自动接管，不用重启应用。
- 若使用蓝牙直连的 Logitech 鼠标，再在「系统设置 › 隐私与安全性 › 输入监控」中打开 Open Mouse，以便可靠读取物理按住与抬起。
- 如需开机自启，在设置中打开「登录时启动」（登录项注册要求应用安装在 /Applications 目录）。
方式二：从源码构建（适合开发者）
只需安装 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 # 使用固定自签名证书打包未公证版本
OpenMouse如何卸载？ #
步骤一：退出应用 点击菜单栏的 Open Mouse 图标，选择退出；或在「活动监视器」中结束 Open Mouse 与 OpenMouseUpdater 进程。
步骤二：移除应用本体
打开「访达 › 应用程序」，把 Open Mouse.app 拖到废纸篓并清空。若通过 make install 安装，也可直接在 /Applications 中删除。
步骤三：撤销系统权限 前往「系统设置 › 隐私与安全性 › 辅助功能」与「输入监控」，取消勾选 Open Mouse（或选中后点减号删除），避免残留无效的授权条目。
步骤四：关闭登录项 在「系统设置 › 通用 › 登录项」中移除 Open Mouse，防止开机自启残留。
步骤五：清理配置文件（可选）
OpenMouse 的配置保存在 ~/Library/Application Support/OpenMouse/preferences.json。如果希望彻底清除所有设置记录，可在终端执行：
rm -rf ~/Library/Application\ Support/OpenMouse
若授权条目变成「勾了也不生效」的幽灵项，可在源码目录执行 make tcc-reset 清除后重新授权。