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-fixMac Mouse Fix 是一个开源 macOS 应用专门解决第三方鼠标在 Mac 上的短板滚轮跳动、侧键无效、无手势支持。技术定位是一个独立 Helper 进程在系统输入链路中拦截鼠标事件并重新分发。 项目速览项目信息许可证自定义 MMF License基于 MIT 改写源码使用无限制衍生应用发布有限制平台macOS 11 Big Sur 及以上Apple Silicon 原生运行安装方式brew install mac-mouse-fix或克隆源码用 Xcode 编译内存占用见最新版本 release 说明应用本身轻量具体数值以实测为准社区活跃度仓库持续提交中近一个月内仍有自动生成 Acknowledgements 等维护提交最近 release 时间以仓库 releases 页面最新版本为准为什么值得关注它把鼠标驱动这件事从闭源厂商手里拿回来用一套完整的开源实现滚轮平滑、按键捕获、手势模拟覆盖了 Logi Options 这类商业软件的核心能力而且滚轮和按键的行为都可以按自己的习惯重写。 它到底帮你做了什么侧键捕获与任意动作映射用户感知到的变化鼠标侧键不再是系统里点不亮的死按钮而是可以绑到任何系统动作。Helper 进程先于目标应用捕获按键事件被映射的按键对其他应用消失避免冲突触发方式覆盖单击、双击、长按、组合键如按键 5 中键动作库包括启动台、调度中心、窗口切换、智能缩放等系统级操作还能模拟任意键盘按键源码位置滚轮平滑与触控板模拟用户感知到的变化一格一格的滚轮变成带惯性、可反向急停的连续滚动接近 Apple Trackpad 的手感。用动量曲线把离散的滚轮脉冲转成平滑增量反向拨一格即可刹车修饰键体系水平、精确precise、快速swift、缩放zoom滚动各对应一个独立按键配置项含 smooth 平滑档位、speed 速度档位与方向反转都持久化在config.plist源码位置指针速度与加速度用户感知到的变化光标移动的手感可以被独立调校不再完全交给系统默认曲线。内置加速度表桥接IOHIDAccelerationTableBridge与灵敏度调节可切换系统加速度或应用自管曲线注意目前不能在应用内直接关闭指针加速度macOS 14 及以上需到 系统设置 → 鼠标 → 高级 中处理点击拖拽手势把两指轻扫搬进鼠标用户感知到的变化按住某个键拖拽就能触发平时属于触控板手势的操作。滚动与导航Scroll Navigate模拟两指滑动可打开 App Exposé、Launchpad、Mission Control配合第三方窗口管理工具一个键加拖拽即可把窗口吸附到半屏、四分之一屏中键拖拽在 Blender 等 3D 软件中的轨道操作也由此承接源码位置 从零跑起来最短可行路径以源码方式安装为例获取仓库git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix用 Xcode 打开仓库根目录的Mouse Fix.xcodeproj分别构建 App 和 Helper 两个 targetHelper/目录对应 Helper 应用启动应用后授予辅助功能权限系统设置 → 隐私与安全性 → 辅助功能勾选 Mac Mouse Fix打开应用打开 Enable 开关此时 Helper 进程开始接管鼠标事件首次验证进入 Buttons 标签页把指针移进区域按一下鼠标侧键。出现按键 N 被 Mac Mouse Fix 捕获到其他 app 无法再识别这个按键的提示说明链路已经通了 进阶玩法与配置方案滚动行为调校。滚动参数集中存放在配置文件的 Scroll 区块默认值如下Shared/Config/default_config.plist为完整模板Scroll: smooth: high # 平滑档位none / low / medium / high speed: medium # 滚动速度档位 reverseDirection: true # 反转方向 trackpadSimulation: true # 触控板模拟适合讨厌原生滚动行为、想要触控板惯性的日常办公用户。侧键映射系统动作。Buttons 标签页为每个按键提供点按 / 点按并拖移 / 双击 / 长按四个槽位每个槽位独立选动作。参考配置截图同款布局{ 中键: { 点按: 智能缩放 }, 中键: { 点按 按键5 点按中键: 调度中心 }, 按键4: { 点按: 启动台 }, 按键4: { 点按并拖移: 滚动与导航 } }适合想一个侧键开启动台、一个侧键拖出 App Exposé 的效率党。用鼠标模拟 Apple 专用键。按住 Option⌥可以选中亮度、音量、媒体播放这类只存在于 Apple 键盘上的按键直接绑到鼠标按钮上。适合无 Apple 键盘外接场景、或想把音量亮度控制移到鼠标上的用户。⚠ 踩坑与排障现象点击有延迟。原因该按键配置了 Double Click 动作Helper 必须等待判定你是否要双击。解法在 Buttons 标签页删掉该按键的 Double Click 动作延迟立刻消失。现象某些鼠标的侧键完全不识别。原因该鼠标走的是厂商私有协议如 Logi Options 类驱动专属通信不是标准 USB HID 事件系统层拿不到。解法确认鼠标能否以标准模式工作私有协议按键目前无解属于已知限制。现象中键粘贴、浏览器中键开链接突然失效。原因中键被 Mac Mouse Fix 捕获后系统默认行为被拦截。解法删掉中键上的所有动作即可释放uncapture该键或者把需要的默认行为显式映射回去。官方指南有完整说明。现象想要关闭指针加速度应用里找不到开关。原因该功能尚未实现在应用内。解法macOS 14 Sonoma 及以上走 系统设置 → 鼠标 → 高级 → 关闭 Pointer acceleration更早系统版本暂无替代。 源码导航Helper/Core/Buttons/按键捕获、修饰键组合、重映射分析RemapsAnalyzerHelper/Core/Scroll/滚动平滑、动量曲线、修饰键滚动附带开发笔记 ScrollNotes.mdHelper/Core/PointerSpeed/指针速度、加速度表桥接与 Experiments 目录里的调参实验Shared/Config/配置读写、版本号迁移configVersion与default_config.plist模板App/UI/Main/Tabs/设置界面各标签页按键、滚动、通用、关于Shared/MessagePort/App 与 Helper 进程间的本地端口通信 结语Mac Mouse Fix 的价值在于用一套开源实现补齐了 macOS 鼠标生态的空白滚轮平滑、侧键映射、触控板手势三件事第一次可以在不装闭源厂商驱动的前提下全部自定义。想深入的话克隆仓库编译最新版本是最直接的路径遇到识别或行为问题项目 issue 区和 Support/Guides/ 里的捕获指南是最好的排查入口。核心关键词macOS 鼠标增强、Mac Mouse Fix 按键映射、开源鼠标驱动长尾关键词macOS 侧键配置、滚轮平滑滚动优化、鼠标手势自定义、第三方鼠标兼容 macOS、鼠标替代触控板方案【免费下载链接】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），仅供参考