侧键映射与平滑滚动Mac Mouse Fix 从上手到搞懂原理【免费下载链接】mac-mouse-fixMac Mouse Fix - Make Your $10 Mouse Better Than an Apple Trackpad!项目地址: https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix把鼠标侧键按下去想切回上一个窗口光标纹丝不动滚轮一格一格地跳快不了也停不干净。macOS 的输入优化几乎全部围绕触控板设计第三方鼠标的侧键和滚轮拿到的系统支持非常有限。Mac Mouse Fix 用后台 Helper 进程拦截并改写鼠标事件把侧键映射、macOS 鼠标平滑滚动和指针加速调到你顺手的程度配置全部留在本地。看懂它怎么工作三层结构 UI 层主应用只有四个标签页——通用、按键、滚动、关于负责把配置写进文件。Helper 层真正拦截并改写鼠标事件的后台进程 Mac Mouse Fix Helper由 launchd 管理启停与主应用通过 MessagePort 通信。配置层所有设置存在本地 config.plist改完即时生效不需要重启。你关掉主窗口、甚至重启电脑映射都还在——因为干活的从来不是那个窗口。安装并授权 Mac Mouse Fix ⚡终端执行安装命令或用 Xcode 打开Mouse Fix.xcodeproj从源码编译源码仓库https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix。brew install mac-mouse-fix启动应用打开 Enable 开关在系统弹窗里授予辅助功能权限——事件拦截依赖它没勾上什么都不会发生。卡点提示勾选后可能不会立刻生效我当时的做法是直接退出应用再重新打开之后就正常了。进入Buttons标签页把鼠标指针移进界面上方的区域单击鼠标上的 Button 5弹窗提示该按键已被捕获即完成第一次核心操作。捕获侧键并绑定动作 ️捕获是理解这个项目的关键一个按钮一旦被 Mac Mouse Fix 捕获其他应用就再也检测不到它——这既保证了映射稳定也意味着想恢复原样就得把该按钮的所有动作删掉。触发动作点按、点按两次、点按并拖移以及点按 Button 5 点按中键这类多键组合默认预设配置文件按三键 / 五键鼠标内置了 Remaps——五键鼠标 Button 4 点按是启动台、Button 5 是智能缩放、中键单击是 Mission Control、按住 Button 5 再滚动是缩放苹果特殊键选择按键时按住 Option (⌥)可以看到亮度、音量、媒体播放这类只有苹果键盘才有的按键。对实际使用的意义是切窗口、开启动台、缩放页面都可以压在手侧的侧键上手指不用离开鼠标。配置平滑滚动与修饰键行为 Scrolling 标签页对应配置文件里这四个键配置键默认值可选范围体感差异smoothhighoff / low / regular / high越高滚轮从一格格跳越接近连续滑动speedmediumsystem / low / medium / high整体滚动快慢system 跟随系统设置reverseDirectiontruetrue / false反转方向配合自然滚动习惯调整trackpadSimulationtruetrue / false开应用把输入当触控板处理关更像原生滚轮修饰键行为默认由四个位掩码定义Command 131072、Control 262144、Option 524288按住什么键滚动时的效果Command水平滚动Control快速滚动Option逐像素精确滚动Command Option缩放开 trackpadSimulation 时事件以 gesture scroll 和 momentum scroll 的形式发出应用会把滚轮当触控板输入处理。对实际使用的意义是滚轮的松手减速、方向手感都能对齐触控板按住 Option 逐像素微调时不再一松手就刹不住。看懂底层机制双进程与平滑引擎 双进程分工。主应用只是设置界面事件拦截全部发生在 Mac Mouse Fix Helper 里。之所以这样拆是因为 Helper 由 launchd 托管HelperServices主应用退出后它照跑不误两者用 MessagePort 通信应用内也内置了restartHelperWithDelay这类重启机制权限出问题时不用手动杀进程。滚动引擎。滚轮输入先经过 DoubleExponentialSmoother 双指数平滑状态是平滑值 L 和趋势 T参数 a 控制多信当前输入、y 控制多信既有趋势之后由曲线和一段拖拽物理产生减速段最后输出模拟的滚动事件。这就是 smooth 等级改变的是减速手感而不是单纯加速度的原因——它模拟的是动量不是倍率。指针加速写进驱动层。项目不在事件层做二次加速而是把自定义加速曲线直接写入 Apple HID 驱动PointerSpeed再按轮询率与 CPI 做补偿。之所以要补偿是因为高轮询率鼠标的原始位移天然偏小不补偿的话加速曲线根本不会正常触发。配置改完即时生效每次修饰键组合、输入轴、显示器的变化都会生成独立的配置副本带缓存所以按住 Option 滚一轮再松开行为是即时切换的。绕开真实使用中的坑 ️事件完全不生效辅助功能权限没勾上或勾完没生效。解法确认权限已勾选退出并重新打开应用Helper 会自动随应用重启。点按有明显延迟给该按钮配了点按两次动作系统要等你确认是否第二次点击。删掉这个动作延迟立刻消失。部分侧键识别不到Logitech Options 这类厂商私有驱动生态的鼠标走私有协议而非标准 HID部分按钮目前识别不了——这是功能边界不是设置问题。Magic Mouse 用户白装了本项目对 Magic Mouse 无效它目前的定位是救普通鼠标不是替代触控板。某款应用不兼容在 General 开启 Show in Menu Bar 后菜单栏可以随时临时关掉平滑滚动等功能不用翻配置。备份很简单拷贝本地~/Library/Application Support/下对应 bundle 目录里的config.plist即可。回到开头的两个痛点侧键现在真的能切窗口了滚轮也终于停得下来。配置留在本地、行为透明可改这是最值得留它的一点。MMF 2 及以前永久免费MMF 3 是 30 天免费后付费项目已支持 20 多种语言欢迎通过仓库提 issue 或贡献翻译。【免费下载链接】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），仅供参考
