Mac Mouse Fix:平滑滚动、手势模拟与按键映射,3 处设置让普通鼠标接近触控板
【免费下载链接】mac-mouse-fixMac Mouse Fix - Make Your $10 Mouse Better Than an Apple Trackpad!项目地址: https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix
Mac Mouse Fix 是一款开源的鼠标增强工具。它运行在系统和你的鼠标之间,实时改写滚动与点击事件,让一把几十块钱的鼠标也能用上触控板的两大招牌体验——平滑滚动和多指手势,还能把任意鼠标按键绑到音量、亮度、Mission Control 这类系统级动作上。这篇文章按你实际使用的路径来讲:先判断值不值得装,再解决第一次启动的问题,然后是滚轮与按键两项核心能力的调法、三个常见故障的处理,最后是花钱、隐私和退出时的清理。
值不值得装?30 秒判断:系统版本、价格与 30 天免费期
先给结论:macOS 11 及以后直接用最新版;Catalina、Mojave、High Sierra 这一代的机器请装 Mac Mouse Fix 2;10.12 及更早的系统最多用到 2.2.0。
| 你的 macOS 版本 | 应选版本 | 备注 |
|---|---|---|
| macOS 11 Big Sur 及以后 | Mac Mouse Fix 3(最新版) | 官方主目标平台;Apple Silicon 上 100% 原生运行,不走 Rosetta |
| 10.13 High Sierra / 10.14 Mojave / 10.15 Catalina | Mac Mouse Fix 2 最新版 | 3.x 可能能启动,但界面有显示问题,部分功能可能失效 |
| 10.11 El Capitan / 10.12 Sierra | 2.2.0 或更早 | 系统太老,只能用老版本线 |
价格上,MMF2 永久免费且作者承诺继续维护;MMF3 前 30 天完整功能免费试用,之后花几美元买断。两个版本都可以免费下回来对比着试用,再决定站哪边。
获取方式有三条:官网直接下载最新安装包;终端里让 Homebrew 代劳,一条命令:
brew install mac-mouse-fix需要某个特定旧版本(比如部署到老机器)时,去项目的 Releases 页面拿历史安装包。
第一次启动:辅助功能权限与"关窗不停工"的机制
新手最容易卡住的一步是权限:macOS 要求你先授予辅助功能权限。应用内自带引导页面,会直接指向系统设置里对应的位置(对应 App/UI/Accessibility/AuthorizeAccessibilityView.m),跟着点完即可。
权限通过后,要理解一个关键概念:主窗口只是设置面板。真正干活的是后台的 "Mac Mouse Fix Helper" 进程——只要"启用 Mac Mouse Fix"开关是开着的,它就持续改写鼠标事件,你关掉主窗口、甚至重启电脑,功能都不停。这也解释了一个容易踩的坑:如果发现每次开机都弹出设置窗口,多半是把它加进了登录项。其实开关本身就能跨重启生效,登录项可以删掉。
事件捕获这一侧,Helper 进程里有一条专门跑输入事件流的线程(Helper/Utility/GlobalEventTapThread.m),配置读写也挂在这条线程的 RunLoop 上派发,整条链路相当克制,基本只有两线程在跑。
让滚轮变顺:Scrolling 页的三个开关和它们的默认值
装完立刻就能感觉到滚轮不再"一格一格"了。默认值写在 Shared/Config/default_config.plist 的 Scroll 分组里,核心四项:
smooth= high:平滑度拉满;speed= medium:中等速度;reverseDirection= true:默认反转滚轮方向,用不惯就在界面上翻回去;trackpadSimulation= true:模拟触控板滚动的手感。
配置里还预绑好了四个键盘修饰键,滚轮滚动时随时可以叠加上:Shift 触发横向滚动、Control 触发"swipe"、Option 触发精准滚动、Command 触发缩放。
两个边界要心里有数。其一,可倾斜滚轮:横向滚动能正常工作,而且手感会比裸鼠标更可控;但没法靠倾斜触发切桌面之类的其他动作——那需要鼠标固件改成发送按键信号,依赖厂商私有协议,作者明确说过工作量太大、短期不会做。其二,指针加速:MMF 自身不提供关闭系统指针加速的开关;macOS 14 Sonoma 及以后可以在系统设置 > 鼠标 > 高级… > 指针加速里关掉。MMF 自己的指针速度曲线由 Pointer 分组管理,默认不使用系统加速、加速值 0.6875、灵敏度 1,实现见 Helper/Core/PointerSpeed/。
还有一个进阶选项:如果你想把滚轮完全交给别的工具(比如 MOS 这类滚动增强应用),到 Scrolling 页把所有选项关掉——速度回 "macOS"、把键盘修饰键条目全部点 "x" 删掉——之后 Mac Mouse Fix 会彻底无视你的滚轮,滚动期间不占任何 CPU。官方说明见仓库里的 Captured Scroll Wheels 指南(Support/Guides/)。
同一个按键上连击与长按:多级触发模型
这是让少量按键承载大量功能的核心设计。每个按键都能按"触发方式 + 层级"绑定不同动作:单击、长按、双击、按住并拖动都可以是独立触发器,连续点按还会升级层级(level 1、2……)。负责跟踪按下/保持/释放状态切换的状态机在 Helper/Core/Buttons/ClickCycle.swift。
默认映射表(配置文件里的 defaultRemaps)示范了作者的用法。三键鼠标的中键:
- 单击 → 符号热键 70
- 长按 → 符号热键 36
- 双击(level 2)→ 符号热键 160
- 按住并拖动 → 三指滑动手势
五键鼠标的 Button 4 承担"单击 → 符号热键、按住滚轮 → 四指捏合、拖动 → 三指滑动手势",Button 5 承担"单击 → 智能缩放、按住滚轮 → 缩放、拖动 → 双指滑动手势"。
这些"符号热键"(symbolicHotkey)效果对应系统级功能键——音量、亮度、Launchpad 之类——通过 macOS 的 Symbolic Hotkey 机制触发(Helper/Core/Actions/SymbolicHotKeys.m),所以哪怕手边不是 Apple 键盘,你也能从鼠标"按出"这些键。
上图中还能看到一个更细粒度的玩法:组合触发器,例如"按住 Button 5 再点中键 → Mission Control"。
进阶玩法:点击拖动吸附窗口,鼠标直接管音量与亮度
玩法一:把窗口吸附变成肌肉记忆。Swish 这类窗口管理工具本来是给触控板手势设计的,但只要把任意按键的"Click and Drag"动作设为Scroll & Navigate,这个按键就相当于一根"双指滑动":拖动到屏幕边缘让窗口贴半屏、四分之一屏或全屏,切桌面、开 Mission Control 也都能完成——触控板上双指滑动能做的事,这里基本都通用。
这一特性由 Helper/Core/Drag/ 下的模块分发:TwoFingerSwipe、ThreeFingerSwipe、FakeDrag等子模块把鼠标拖拽模拟成多指手势,最终的触控板事件由TouchSimulator合成。
玩法二:从鼠标上直接控制音量、亮度与媒体播放。任意键盘按键都能绑到鼠标按键上,包括只存在于 Apple 键盘上的那些键(屏幕亮度、音量、媒体播放/暂停)。这些特殊键藏得比较深:在按键选择器里按住 Option(⌥),它们才会显示出来。
⚠️ 三个典型故障:点击延迟、"按键被捕获"提示、App Exposé 无效
点击延迟。每次单击后,MMF 会短停一小会儿,判断你是否要接着双击——这就是双击判定窗口,也是单击"慢半拍"的来源。解法很简单:删掉该按键绑定的所有Double Click动作,延迟立刻消失。
弹出"Button 5 is now captured by Mac Mouse Fix"提示。别被措辞吓到,它的意思是:这个按键对其他应用和 macOS 不可见了,原来的功能(比如侧键在浏览器里后退、中键在终端里粘贴)不再生效。设计目的是防止使用手势时误触发别的功能——例如 Button 4 按住拖动切桌面的同时,还会顺手把浏览器退一页,那就尴尬了。Buttons 页左侧列表就是当前被捕获的按键集合;想让某个按键"还魂",把它的绑定条目全部删掉即可。
如果按键的原始功能你仍然需要,也不必解除捕获:把内建的Middle Click动作绑上去,就能恢复中键在浏览器开链接/新标签、在终端粘贴的用法;绑Back / Forward动作可以恢复侧键导航(MMF 3.0.6 起,这两个动作会模拟真实的 Button 4/5 点击,游戏和专业软件里的按键重映射因此也能继续用)。完整对照表见 Support/Guides/CapturedButtonsMMF3.md。核选项是到 General 页关掉"启用 Mac Mouse Fix"总开关,一切回到原样。
App Exposé 呼不出来。选择 "Spaces & Mission Control" 动作,然后向下按住并拖动绑定的按键。如果没反应,多半是系统层面把 App Exposé 触控板手势关了:去系统设置里打开,或在终端执行:
defaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock成本、许可与隐私:掏钱之前要知道的事
许可:一次购买,所有你的 Mac都能用;登录同一个 Apple ID 时,许可还会经 iCloud 自动同步到其他设备。限制是"一人一份"——与家人共用没问题,公开分享则可能导致许可被作废。它覆盖全部 3.x 版本;未来的 4.0 可能需要重新购买,作者表示会尽量避免。
退款:没有官方退款政策,但 30 天免费期就是无风险试用;购买后遇到问题可以直接联系作者处理。
隐私:应用内无广告、不收集任何个人信息。唯一的数据环节在购买时发生——销售平台 Gumroad 会记录你的邮箱并用于退款、发送许可码,作者可见,且无法关闭。
开源:变现之后依然开源,3 及以后遵循仓库里的 License(MMF License)——你可以把它的源码用进自己的项目,只要不发布 Mac Mouse Fix 的简单复制品。许可与试用状态保存在本地,见 Shared/Config/SecureStorage/SecureStorage.swift。
退出路径:残留文件、清理工具,以及它帮不上忙的三类鼠标
卸载本身一步就够:把应用拖进废纸篓。但系统里会留下文件——~/Library/Application Support下的配置 plist(读写逻辑在 Shared/Config/Config.m)、许可与安全存储状态等。macOS 不允许应用在删除时自行清理这些残留,手动删又容易遗漏,所以官方建议配合 AppCleaner(FreeMacSoft 出品)做彻底清理。
如果不是离开 MMF,而是想减少它的干预:老机器可以退回 MMF2 继续用;只想要平滑滚动的话,可以把滚轮完整解除捕获(见上文进阶选项),交给 MOS 这类专门工具处理。
三类鼠标它目前帮不上忙,提前知道可以省不少折腾:
- Apple Magic Mouse:当前版本对它没有任何效果,未来可能增强,但没有排期;
- 依赖专有驱动的鼠标(需要 Logitech Options 之类软件才能全功能使用的型号):它们走厂商私有协议而非标准 USB 协议通信,MMF 目前认不全这些按键;
- 可倾斜滚轮:只能用于横向滚动,无法当手势触发器用。
找到作者的四个通道:反馈、翻译、购买与 Pull Request
- 反馈:官方 Feedback Assistant 收 bug 报告、想法和功能请求,是"我如果能有……就好了"最快到达作者的路。
- 翻译:项目提供多语言版本,完整的本地化实现在 Localization/ 目录;官方有翻译向导,支持补新语言和修正现有翻译,也可以在向导下评论报告缺失的译文。
- 支持:应用内购买、PayPal 或 GitHub Sponsors 月赞助均可;通过 PayPal 捐过款的用户可以申领免费许可。
- 代码:欢迎任何 PR,但不保证全部采纳。作者的建议是先提交一个"只描述改动方案、几乎不含代码"的初始 PR,拿到回复再动手实现,免得白做。
【免费下载链接】mac-mouse-fixMac Mouse Fix - Make Your $10 Mouse Better Than an Apple Trackpad!项目地址: https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考