Mac Mouse Fix 使用指南10分钟完成 macOS 鼠标增强与侧键映射【免费下载链接】mac-mouse-fixMac Mouse Fix - Make Your $10 Mouse Better Than an Apple Trackpad!项目地址: https://gitcode.com/GitHub_Trending/ma/mac-mouse-fixMac Mouse Fix 是一款开源的 macOS 鼠标增强工具接管鼠标侧键与滚轮把侧键映射到启动台、调度中心等系统功能让滚轮获得类似触控板的平滑滚动。下文按安装、授权、按键映射的顺序走完全部步骤。项目定位Mac Mouse Fix 代码完全开源采用基于 MIT/BSD 的自定义 MMF 许可可以直接阅读源码并自行编译。Mac Mouse Fix 2 及以下版本永久免费3 版提供 30 天免费试用之后支付少量费用即可解锁。它要求 macOS 11 Big Sur 及以上Apple Silicon 上为原生运行。核心价值有两点平滑滚动和按钮映射系统。它不依赖任何鼠标的品牌驱动绝大多数 USB 和蓝牙鼠标接上就能用。安装与首次运行三种获取方式任选其一普通用户从官方渠道下载预编译安装器直接拖进应用程序文件夹。Homebrew 用户在终端执行brew install mac-mouse-fix。开发者git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix然后用 Xcode 打开 Mouse Fix.xcodeproj 编译运行。启动后按这个顺序操作打开应用进入通用标签页打开启用 Mac Mouse Fix开关。系统会请求辅助功能权限按提示在系统设置 → 隐私与安全性 → 辅助功能中勾选应用若系统同时请求输入监控权限一并允许。重启应用。此时后台的Mac Mouse Fix Helper进程开始接管鼠标事件主窗口之后随时可以关闭效果持续。授权之后第一步做什么切到按键标签页完成下面第一个演示验证整条链路已经打通。️ 核心功能逐个演示把侧键映射到系统功能macOS 对第三方鼠标的侧键基本无感MMF 会拦截这些按键并让它们执行任意动作。点击顶部标签栏的按键通用 / 按键 / 滚动 / 关于。把鼠标指针移入界面中央的大区域内然后真实按下要映射的那个鼠标按键。按键名称会出现在下方列表同时弹出按键 X 被 Mac Mouse Fix 捕获到的提示。在新增的动作行里选择触发方式点按、双击、点按并拖动再从右侧下拉框选具体功能智能缩放、启动台、调度中心或任意键盘快捷键、系统快捷键。同一个按键可以挂多行动作删掉某一行就解除该行为的捕获。映射逻辑在 按键映射实现 中。调出平滑滚动传统滚轮一格一格地跳平滑滚动让它连续且带惯性。点击滚动标签页。在平滑下拉框里选低、中、高选关闭则回到系统原生行为。按需勾选反转方向自然滚动调整速度并设置修饰键按住 Command 横向滚动、按住 Shift 精确滚动。点按并拖动模拟两指手势按住某个按键再移动鼠标等价于在触控板上双指滑动。在按键标签页给某个按键添加点按并拖动这一行动作。动作下拉框选滚动与导航。使用中按住该键左右拖动可切换桌面向下拖动打开应用窗口App Exposé。 可抄作业的配置方案三套按键映射照抄进按键标签页即可。括号里标注适用软件。按键设计Photoshop、Figma开发VS Code、Xcode日常办公浏览器、PDF左侧键点按智能缩放点按并拖动滚动与导航点按启动台双击Mission Control点按启动台右侧键点按调度中心点按Mission Control点按调度中心中键点按并拖动滚动与导航画布平移点按并拖动滚动与导航窗口贴边点按智能缩放只有三个按键的鼠标没有侧键可以用点按按键 5 点按中键这类按键组合替代默认配置里就有这种示例。⚙️ 进阶能力映射下拉框支持组合触发修饰键、其他按键、连按次数都可以叠进来。选快捷键时按住 Option 还能调出 Apple 键盘特有的特殊键——亮度、音量、媒体播放即使手上是普通键盘也能用鼠标触发。原理速览应用分两个进程主 App 只负责界面真正干活的是后台的Mac Mouse Fix Helper。开启开关后 Helper 常驻所以关掉主窗口、甚至重启电脑后鼠标效果都在。Helper 通过全局事件钩子拿到滚轮和按键的原始事件。滚动模块滚动实现用两级指数平滑处理预测值由当前输入和上一时刻的趋势共同决定输出不再受滚轮物理格数限制松手后还会按衰减趋势补完剩余滚动量这就是惯性的来源。配置存在本地的 plist 里默认值见 default_config.plist按 Scroll / Pointer / Remaps / General 分段。每个按键动作都是触发器 效果对触发器记录是哪个按键、哪种触发方式效果指向一个系统快捷键或触控板手势。️ 排障手册症状映射后按键没反应。原因按键其实没被捕获或通用页的启用开关是关的。 解法把指针移回区域重新真实按一次该按键看到被捕获到提示再继续确认 Helper 进程在运行。症状点击出现明显延迟。原因该按键挂了双击动作MMF 每次单击都要等系统双击窗口期才能判定是单击还是双击。 解法删掉该按键的双击动作延迟立即消失。症状某些侧键在列表里根本不出现。原因部分鼠标常见于罗技只通过官方驱动的私有协议上报侧键系统层看不到。 解法先卸载官方驱动软件再试深度绑定私有协议的型号属于已知局限。症状点按并拖动无法打开 App Exposé。原因系统应用窗口触控板手势被关掉了。 解法终端执行下面命令后重开 Dockdefaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock症状滚动方向和预期相反。原因默认启用了自然滚动方向。 解法在滚动标签页切换反转方向勾选状态。项目的贡献方式反馈、翻译、代码与已有贡献者名单见 Acknowledgements.md。仓库地址git clone https://gitcode.com/GitHub_Trending/ma/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
