Mac Mouse Fix 指南10 美元鼠标也能调出 Trackpad 手感【免费下载链接】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 是一款开源的 macOS 鼠标增强工具它在系统事件层截住滚轮和按键输入再重新翻译成触控板级的平滑滚动、双指手势和键盘事件。Mac Mouse Fix 安装授权与首条侧键配置一条 brew 命令起步从装到用惯最快几分钟。先确认你该装哪条版本线你的 macOS装哪条线备注macOS 11 Big Sur 及以上Mac Mouse Fix 3官方目标平台Apple Silicon 原生10.13 / 10.14 / 10.15最新版 Mac Mouse Fix 2MMF 3 能装但界面错乱、部分功能异常10.11 / 10.12Mac Mouse Fix 2.2.0 或更早老系统配老版本两条线的商业规则不一样MMF 2 永久免费且持续维护MMF 3 有 30 天免费试用之后花几美元买下——一份许可证在你名下所有 Mac 上有效同一 Apple 账户登录时经 iCloud 自动同步覆盖全部 3.x 版本。安装只需要一条命令brew install mac-mouse-fix从启动台打开应用系统会提示你去系统设置 → 隐私与安全性 → 辅助功能勾选权限没有这个权限它既看不到也改不了任何鼠标输入。授权后回到应用打开General标签页的Enable Mac Mouse Fix开关。⚠️ 这里有个新手最容易懵的点开关打开后关掉应用窗口、重启电脑增强效果都还在。真正干活的是常驻后台的 Helper 进程不是你眼前的窗口所以完全不需要把它加进登录项。首条配置进Buttons标签页把鼠标指针移进顶部的大 区域直接按一下鼠标侧键左侧列表会多出一条记录在右侧下拉里选Back。侧键单击 浏览器后退第一套配置就位。顺手在General里打开Show in Menu Bar日后某个应用和增强打架时菜单栏点一下就能临时关掉滚轮或按键。平滑滚动、侧键绑 Back、手势模拟装完当天会点到的三个开关 ️先说最改变生活的一个。**平滑滚动。**①Scrolling标签页保持默认就能直接吃平滑度 High、速度 Medium、方向反转打开。② 体感上的变化滚轮每一下输入不再直接变成页面位移而是驱动一段带加速度的缓动——不再咔咔跳而是带一点惯性滑过去。平滑度拉满时它甚至把滚动事件改写为触控板语义应用层以为你在用触控板。③ 想再拧细一点给键盘修饰键绑定修饰功能按住某键滚动即切换横向滚动、精准滚动、快速滚动或缩放参数在modifiers下。源码印证Helper/Core/Config/ScrollConfig.swift**侧键重映射。**① 还是 Buttons 标签页指针移进 区域按哪个键就捕获哪个键右侧动作列表里除了 Back / Forward / Mission Control还有键盘上任意键——选不到亮度、音量这类 Apple 特殊键时按住 Option⌥再选它们就会出现在候选里。② 体感按一下侧键切歌、调亮度不用再伸手够 F 键区。③ 每条记录都是触发方式 × 动作的组合Click、Double Click、Click and Drag、Hold 四种触发可以叠加在同一按键上。源码印证Helper/Core/Buttons/**触控板手势模拟。**① 给某个按键比如 Button 4的Click and Drag触发器选Scroll Navigate配合 Swish 这类窗口管理器可以一键吸附半屏/四分之一屏Blender 里按住拖拽就是环绕视角。② 体感按住拖拽的瞬间像有两根手指在触控板上滑——三指切桌面、Dock 相关手势这类触控板能做的它都能复现。③ 想更稳General里打开lockPointerDuringDrag手势拖拽期间指针原地冻结不会跟着跑偏。源码印证Helper/Core/Drag/滚动参数速查Scroll 配置键默认值与联动关系最常动到的参数都挂在Scroll键下默认值一览配置键默认值人话解释可选值speedmedium滚动速度决定灵敏度区间system/low/medium/highsmoothhigh平滑度决定用哪条动画曲线off/low/regular/highreverseDirectiontrue反转滚动方向布尔trackpadSimulationtrue高平滑度下改发手势滚动事件布尔precisefalse精准滚动逐格微调布尔modifiers.horizontal131072横向滚动的修饰键掩码事件标志位掩码modifiers.swift262144快速滚动的修饰键掩码事件标志位掩码modifiers.precise524288精准滚动的修饰键掩码事件标志位掩码modifiers.zoom1048576缩放的修饰键掩码事件标志位掩码几个联动关系值得记住speed选system时加速算法完全不归它管直接用 macOS 给的数值smooth每降一档曲线就换一种——off无动画、low极低惯性、regular低惯性、high高惯性再叠加触控板模拟就是最高一档的手感四组modifiers掩码则是按住对应按键时滚轮归谁管的开关。指针是另一套独立子系统。Pointer.acceleration默认0.68750~1 的强度、sensitivity默认1、useSystemAcceleration默认false——默认就跑它自建的加速度引擎内部按 125Hz 基准轮询率、1000 基准 CPI 做了补偿所以 250Hz 的鼠标不会越急越飘。这套补偿已实现但 UI 开关尚未开放想直接关掉指针加速度macOS 14 Sonoma 及以上走系统设置 → 鼠标 → 高级 → 指针加速度。后台 Helper 进程截住鼠标事件的 5 个环节真正动你鼠标的不是你打开的那个窗口而是常驻后台的 Mac Mouse Fix Helper 进程——入口在 Helper/main.m主程序只管界面和配置。整条流水线五步拦截按键事件由 Helper/Core/Buttons/ButtonInputReceiver.m 挂的 HID 级事件 tap 截下滚轮由 Helper/Core/Scroll/Scroll.m 的 tap 截下都在专用线程上被捕获的按键事件从此不再透传给系统。分析滚动侧的 ScrollAnalyzer 测量 tick 间隔与速度按键侧的 RemapsAnalyzer 按 Remaps 配置判断要不要等双击、长按超时。执行按键动作按 Remaps 翻译成键盘事件、系统热键、中键语义点击等经 CGEvent 注入集中在 Helper/Core/Remap/Remap.m。输出滚动按配置给出的曲线逐帧输出事件双指/三指滑动等手势先翻译成触控板语义再交给系统。指针Helper/Core/PointerSpeed/PointerSpeed.m 直接改写 Apple HID 驱动的加速度表。商业侧一笔带过MMF 3 的 30 天试用按跨天才 1计数——重启应用、重启电脑、同一天反复用都不重复计触控板使用不计入许可证一份覆盖你名下所有 Mac同账户经 iCloud 自动同步无正式退款政策。项目无广告、不收集个人信息商业化后依然开源条款见仓库根的 License 文件鼓励复用源码但不要直接发布应用副本。单击延迟、前进后退失灵、卸载残留等 6 个症状的排查路径单击明显延迟像钝了一下根因该按键上绑了 Double Click 动作每次单击后 MMF 都要等一下判断你是不是要双击。 解法Buttons 标签页删掉该按键的所有 Double Click 条目延迟当场消失。浏览器前进后退、中键粘贴突然没反应根因这个按键被 MMF 捕获capture了——被捕获的按键只有 MMF 看得到其他应用收不到事件。系统一般会弹一个提示判断标准Buttons 标签页左侧列表里出现过的按键都是被捕获的。三条恢复途径一是在 MMF 内把原功能翻译回来——中键粘贴用 Middle Click 动作、前进后退用 Back / Forward、3D 环绕用 Scroll Navigate二是把该按键左侧全部条目点掉-解除捕获、完全恢复原生行为三是直接关掉General里的 Enable Mac Mouse Fix零干预。向下拖拽触发不了 App Exposé根因不是 MMF 的问题是系统层 Trackpad 的 App Exposé 手势本身被关了。 解法在系统设置里重新开启该手势或终端执行defaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock鼠标上有些按键 MMF 根本不认识根因鼠标走的是厂商专有协议Logitech Options 那类驱动设计不是标准 USB 协议MMF 目前识别不全Apple Magic Mouse 目前也不受 MMF 任何影响。 解法装上直接试这是最稳的确认方式完整兼容需要大量逆向工作短期内不会到来。想要按应用生效的设置根因MMF 3 还没有应用级设置MMF 2 的More... App-specific settings有应用级与鼠标级设置都在规划中、无时间表。 解法General打开 Show in Menu Bar遇到不兼容应用时从菜单栏临时关掉滚轮或按键增强。卸载后觉得不干净根因应用拖进废纸篓只完成一半——沙盒机制下配置与后台残留文件应用自己删不掉。 解法用 AppCleaner 这类第三方清理工具做彻底卸载。一句话定位与今天就能做的一步Mac Mouse Fix 事件拦截 语义化按键重映射 触控板级滚动引擎三件事把 10 美元鼠标的体验拉到 Trackpad 的维度。今天就做brew install mac-mouse-fix装完把侧键绑成 Back滚轮用默认平滑配置跑一天手感对上了再回来拧参数。进阶阅读Support/Support.md 下的按键捕获与滚轮捕获两篇指南配合 Readme.md 的 Questions 部分基本覆盖所有高频疑问。【免费下载链接】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），仅供参考
Mac Mouse Fix 指南10 美元鼠标也能调出 Trackpad 手感【免费下载链接】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 是一款开源的 macOS 鼠标增强工具它在系统事件层截住滚轮和按键输入再重新翻译成触控板级的平滑滚动、双指手势和键盘事件。Mac Mouse Fix 安装授权与首条侧键配置一条 brew 命令起步从装到用惯最快几分钟。先确认你该装哪条版本线你的 macOS装哪条线备注macOS 11 Big Sur 及以上Mac Mouse Fix 3官方目标平台Apple Silicon 原生10.13 / 10.14 / 10.15最新版 Mac Mouse Fix 2MMF 3 能装但界面错乱、部分功能异常10.11 / 10.12Mac Mouse Fix 2.2.0 或更早老系统配老版本两条线的商业规则不一样MMF 2 永久免费且持续维护MMF 3 有 30 天免费试用之后花几美元买下——一份许可证在你名下所有 Mac 上有效同一 Apple 账户登录时经 iCloud 自动同步覆盖全部 3.x 版本。安装只需要一条命令brew install mac-mouse-fix从启动台打开应用系统会提示你去系统设置 → 隐私与安全性 → 辅助功能勾选权限没有这个权限它既看不到也改不了任何鼠标输入。授权后回到应用打开General标签页的Enable Mac Mouse Fix开关。⚠️ 这里有个新手最容易懵的点开关打开后关掉应用窗口、重启电脑增强效果都还在。真正干活的是常驻后台的 Helper 进程不是你眼前的窗口所以完全不需要把它加进登录项。首条配置进Buttons标签页把鼠标指针移进顶部的大 区域直接按一下鼠标侧键左侧列表会多出一条记录在右侧下拉里选Back。侧键单击 浏览器后退第一套配置就位。顺手在General里打开Show in Menu Bar日后某个应用和增强打架时菜单栏点一下就能临时关掉滚轮或按键。平滑滚动、侧键绑 Back、手势模拟装完当天会点到的三个开关 ️先说最改变生活的一个。**平滑滚动。**①Scrolling标签页保持默认就能直接吃平滑度 High、速度 Medium、方向反转打开。② 体感上的变化滚轮每一下输入不再直接变成页面位移而是驱动一段带加速度的缓动——不再咔咔跳而是带一点惯性滑过去。平滑度拉满时它甚至把滚动事件改写为触控板语义应用层以为你在用触控板。③ 想再拧细一点给键盘修饰键绑定修饰功能按住某键滚动即切换横向滚动、精准滚动、快速滚动或缩放参数在modifiers下。源码印证Helper/Core/Config/ScrollConfig.swift**侧键重映射。**① 还是 Buttons 标签页指针移进 区域按哪个键就捕获哪个键右侧动作列表里除了 Back / Forward / Mission Control还有键盘上任意键——选不到亮度、音量这类 Apple 特殊键时按住 Option⌥再选它们就会出现在候选里。② 体感按一下侧键切歌、调亮度不用再伸手够 F 键区。③ 每条记录都是触发方式 × 动作的组合Click、Double Click、Click and Drag、Hold 四种触发可以叠加在同一按键上。源码印证Helper/Core/Buttons/**触控板手势模拟。**① 给某个按键比如 Button 4的Click and Drag触发器选Scroll Navigate配合 Swish 这类窗口管理器可以一键吸附半屏/四分之一屏Blender 里按住拖拽就是环绕视角。② 体感按住拖拽的瞬间像有两根手指在触控板上滑——三指切桌面、Dock 相关手势这类触控板能做的它都能复现。③ 想更稳General里打开lockPointerDuringDrag手势拖拽期间指针原地冻结不会跟着跑偏。源码印证Helper/Core/Drag/滚动参数速查Scroll 配置键默认值与联动关系最常动到的参数都挂在Scroll键下默认值一览配置键默认值人话解释可选值speedmedium滚动速度决定灵敏度区间system/low/medium/highsmoothhigh平滑度决定用哪条动画曲线off/low/regular/highreverseDirectiontrue反转滚动方向布尔trackpadSimulationtrue高平滑度下改发手势滚动事件布尔precisefalse精准滚动逐格微调布尔modifiers.horizontal131072横向滚动的修饰键掩码事件标志位掩码modifiers.swift262144快速滚动的修饰键掩码事件标志位掩码modifiers.precise524288精准滚动的修饰键掩码事件标志位掩码modifiers.zoom1048576缩放的修饰键掩码事件标志位掩码几个联动关系值得记住speed选system时加速算法完全不归它管直接用 macOS 给的数值smooth每降一档曲线就换一种——off无动画、low极低惯性、regular低惯性、high高惯性再叠加触控板模拟就是最高一档的手感四组modifiers掩码则是按住对应按键时滚轮归谁管的开关。指针是另一套独立子系统。Pointer.acceleration默认0.68750~1 的强度、sensitivity默认1、useSystemAcceleration默认false——默认就跑它自建的加速度引擎内部按 125Hz 基准轮询率、1000 基准 CPI 做了补偿所以 250Hz 的鼠标不会越急越飘。这套补偿已实现但 UI 开关尚未开放想直接关掉指针加速度macOS 14 Sonoma 及以上走系统设置 → 鼠标 → 高级 → 指针加速度。后台 Helper 进程截住鼠标事件的 5 个环节真正动你鼠标的不是你打开的那个窗口而是常驻后台的 Mac Mouse Fix Helper 进程——入口在 Helper/main.m主程序只管界面和配置。整条流水线五步拦截按键事件由 Helper/Core/Buttons/ButtonInputReceiver.m 挂的 HID 级事件 tap 截下滚轮由 Helper/Core/Scroll/Scroll.m 的 tap 截下都在专用线程上被捕获的按键事件从此不再透传给系统。分析滚动侧的 ScrollAnalyzer 测量 tick 间隔与速度按键侧的 RemapsAnalyzer 按 Remaps 配置判断要不要等双击、长按超时。执行按键动作按 Remaps 翻译成键盘事件、系统热键、中键语义点击等经 CGEvent 注入集中在 Helper/Core/Remap/Remap.m。输出滚动按配置给出的曲线逐帧输出事件双指/三指滑动等手势先翻译成触控板语义再交给系统。指针Helper/Core/PointerSpeed/PointerSpeed.m 直接改写 Apple HID 驱动的加速度表。商业侧一笔带过MMF 3 的 30 天试用按跨天才 1计数——重启应用、重启电脑、同一天反复用都不重复计触控板使用不计入许可证一份覆盖你名下所有 Mac同账户经 iCloud 自动同步无正式退款政策。项目无广告、不收集个人信息商业化后依然开源条款见仓库根的 License 文件鼓励复用源码但不要直接发布应用副本。单击延迟、前进后退失灵、卸载残留等 6 个症状的排查路径单击明显延迟像钝了一下根因该按键上绑了 Double Click 动作每次单击后 MMF 都要等一下判断你是不是要双击。 解法Buttons 标签页删掉该按键的所有 Double Click 条目延迟当场消失。浏览器前进后退、中键粘贴突然没反应根因这个按键被 MMF 捕获capture了——被捕获的按键只有 MMF 看得到其他应用收不到事件。系统一般会弹一个提示判断标准Buttons 标签页左侧列表里出现过的按键都是被捕获的。三条恢复途径一是在 MMF 内把原功能翻译回来——中键粘贴用 Middle Click 动作、前进后退用 Back / Forward、3D 环绕用 Scroll Navigate二是把该按键左侧全部条目点掉-解除捕获、完全恢复原生行为三是直接关掉General里的 Enable Mac Mouse Fix零干预。向下拖拽触发不了 App Exposé根因不是 MMF 的问题是系统层 Trackpad 的 App Exposé 手势本身被关了。 解法在系统设置里重新开启该手势或终端执行defaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock鼠标上有些按键 MMF 根本不认识根因鼠标走的是厂商专有协议Logitech Options 那类驱动设计不是标准 USB 协议MMF 目前识别不全Apple Magic Mouse 目前也不受 MMF 任何影响。 解法装上直接试这是最稳的确认方式完整兼容需要大量逆向工作短期内不会到来。想要按应用生效的设置根因MMF 3 还没有应用级设置MMF 2 的More... App-specific settings有应用级与鼠标级设置都在规划中、无时间表。 解法General打开 Show in Menu Bar遇到不兼容应用时从菜单栏临时关掉滚轮或按键增强。卸载后觉得不干净根因应用拖进废纸篓只完成一半——沙盒机制下配置与后台残留文件应用自己删不掉。 解法用 AppCleaner 这类第三方清理工具做彻底卸载。一句话定位与今天就能做的一步Mac Mouse Fix 事件拦截 语义化按键重映射 触控板级滚动引擎三件事把 10 美元鼠标的体验拉到 Trackpad 的维度。今天就做brew install mac-mouse-fix装完把侧键绑成 Back滚轮用默认平滑配置跑一天手感对上了再回来拧参数。进阶阅读Support/Support.md 下的按键捕获与滚轮捕获两篇指南配合 Readme.md 的 Questions 部分基本覆盖所有高频疑问。【免费下载链接】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），仅供参考
