桌面应用【免费下载链接】Mos一个用于在 macOS 上平滑你的鼠标滚动效果或单独设置滚动方向的小工具, 让你的滚轮爽如触控板 | A lightweight tool used to smooth scrolling and set scroll direction independently for your mouse on macOS项目地址https://gitcode.com/gh_mirrors/mo/Mos点击查看免费下载Mos 是一款免费、轻量、用 Swift 编写的 macOS 菜单栏工具核心目标只有一个让你的鼠标滚轮滚动得像触控板一样平滑自然同时允许用户独立翻转鼠标滚轮的滚动方向、按应用定制滚动行为。本文以仓库根目录下的 README.enUS.md 为主线完整继承其特性清单与安装指南并结合 Mos/ScrollCore 目录下的源码从事件拦截、插值计算、相位模拟到参数配置逐层拆解其实现原理。读完本文你既能完成 Mos 的安装与基本配置也能理解平滑滚动在系统底层究竟是如何被伪造出来的。项目概览一个菜单栏常驻的滚动魔法师Mos 定位于免费且简单free simple它不修改系统文件、不注入任何第三方库到目标应用而是通过 macOS 的 Quartz Event Services 在系统事件流层面截取滚动事件经过插值计算后重新注入平滑的滚动事件从而让传统机械鼠标/滚轮鼠标获得接近触控板的滚动手感。从 README.enUS.md 列出的特性看Mos 的核心能力包括平滑滚动让鼠标滚轮滚动像触控板一样顺滑可定制滚动行为支持调整滚动速度与加速度曲线等参数触控板 / 鼠标分离处理可以单独为鼠标滚轮设置滚动方向不影响触控板图形化监控窗口实时展示滚动事件的可视化图表应用级白名单/黑名单内置按应用处理的例外列表纯 Swift 构建要求 Xcode 9.0 与 Swift 4.0见 README 徽章与 Mos.xcodeproj 工程。这些特性在仓库中都有对应的源码模块滚动核心 ScrollCore.swift、事件模型 ScrollEvent.swift、插值器 Interpolator.swift、事件发送器 ScrollPoster.swift、相位状态机 ScrollPhase.swift 以及曲线滤波 ScrollFilter.swift。下载与安装Homebrew 一键安装与手动安装README 提供了两种安装途径以下是完整可复制的操作步骤。通过 Homebrew 安装如果你的 Mac 已安装 Homebrew安装 Mos 只需一条命令$ brew install mos安装完成后应用会被放置在系统应用目录/Applications/Mos.app当发布新版本时通过以下命令升级$ brew update $ brew reinstall mos升级完成后退出并重新启动应用即可生效README 明确要求 Quit then relaunch the app。需要说明的是当前仓库并未提供自制homebrew配方文件brew install mos的可用性取决于官方 cask/formula 仓库的维护状态。手动安装也可以从 GitHub Releases 页面下载最新版本的 dmg 镜像手动安装。仓库 dmg 目录中提供了构建 DMG 安装包所需的资源create-dmg.commandDMG 制作脚本dmg-bg.png安装器背景图1400x800dmg-icon.png安装器图标1024x1024。下载后将Mos.app拖入/Applications目录即可。首次运行 Mos 时macOS 会要求授予**辅助功能Accessibility**权限因为 Mos 需要通过 CGEventTap 读取并注入全局滚动事件这是其工作的前提。核心机制一次滚轮滚动在 Mos 内部经历了什么要理解 Mos 的价值需要先理解它的工作链路。从源码看Mos 的滚动处理由ScrollCoreScrollCore.swift统筹其startHandlingScroll()方法在应用启动后创建了三个 CGEventTap 事件拦截器见 ScrollCore.swift拦截器监听事件掩码Tap 类型用途scrollEventInterceptorscrollWheel滚动.defaultTap可修改截获滚动事件并执行平滑/翻转hotkeyEventInterceptorflagsChanged修饰键.listenOnly只读监听 Control/Option/Command/Shift 热键mouseEventInterceptorleftMouseDown左键按下.listenOnly只读点击左键立即停止滚动三个拦截器均挂在.cgAnnotatedSessionEventTap的.tailAppendEventTap位置即事件流的尾部。scrollEventInterceptor使用.defaultTap意味着它可以修改或吞掉事件这是实现平滑滚动的关键另外两个只监听不修改。一条滚动事件进入scrollEventCallBackScrollCore.swift后处理流程如下触控板判定与放行调用ScrollEvent.isTrackpad(with:)判断事件来源。若判定为触控板直接原样放行事件return Unmanaged.passUnretained(event)这正是独立处理触控板与鼠标的底层实现。判定依据是事件的滚动相位字段scrollWheelEventMomentumPhase/scrollWheelEventScrollPhase与累计加速度scrollWheelEventScrollCount是否非零详见 ScrollEvent.swift。此外源码注释特别指出黑苹果的触控板驱动直接模拟鼠标输入、Magic Mouse 的滚动特征与内置触控板一致这两类设备无法被可靠区分。滚动阶段介入ScrollPhase.shared.kickIn()更新滚动相位状态机。目标应用解析通过ScrollUtils.shared.getRunningApplication(from:)获取滚动事件的目标应用进而查询该应用是否在例外列表中getExceptionalApplication。平滑/翻转开关决策根据例外应用配置或全局配置决定enableSmooth与enableReverse。若 Launchpad 处于激活状态则强制关闭平滑防止桌面图标抖动。数据解析ScrollEvent(with:)从事件中提取 Y/X 双轴的滚动数据分别读取scrollWheelEventDeltaAxis1/2整数增量、scrollWheelEventPointDeltaAxis1/2点增量与scrollWheelEventFixedPtDeltaAxis1/2固定点增量按优先级选取可用值详见 ScrollEvent.swift。方向翻转若启用翻转则对事件的三个增量字段全部取反并更新可用值reverseX/reverseY见 ScrollEvent.swift。归一化若启用平滑且输入数据为非 Fixed 类型即来自pointDelta的动态增量则使用 Step 作为门限值将过小的滚动增量归一化保证插值有足够的输入量normalizeY/normalizeX见 ScrollEvent.swift。注入平滑事件若启用平滑则吞掉原始事件返回nil将归一化后的增量交给ScrollPoster异步插值发送否则原样放行事件。平滑滚动的核心CVDisplayLink 驱动的插值发送器平滑滚动的平滑感来自ScrollPosterScrollPoster.swift。它使用CVDisplayLinkCreateWithActiveCGDisplays创建与显示器刷新率同步的回调循环见 ScrollPoster.swift每个刷新帧执行一次processing()// 计算插值 let frame ( y: Interpolator.lerp(src: current.y, dest: buffer.y, trans: duration), x: Interpolator.lerp(src: current.x, dest: buffer.x, trans: duration) ) // 更新滚动位置 current (y: current.y frame.y, x: current.x frame.x) // 平滑滚动结果 let filledValue filter.fill(with: frame) // 变换滚动结果Shift 横向滚动归一化 let shiftedValue shift(with: filledValue) // 发送滚动结果 post(ref, shiftedValue)这里Interpolator.lerp线性插值见 Interpolator.swift每帧从当前位置向目标缓冲位置逼近duration比例的位移duration越小逼近越快、滚动越跟手越大则越柔和绵长。滚动手感即由此参数控制。ScrollFilterScrollFilter.swift则对插值结果做曲线峰值滤波用定长非线性数列[first, first0.23*diff, first0.5*diff, first0.77*diff, nextValue]填充用于去除滚动起始时的抖动使曲线更平滑。post(_:_:)方法ScrollPoster.swift复制原始事件、写入插值后的增量数据scrollWheelEventPointDeltaAxis1/2将fixedPtDelta清零、isContinuous置 1并通过tapPostEvent(proxy)将事件发布到事件流中——源码注释指出使用tapPostEvent发布事件可以避免事件被回调本身重复接收。滚动结束后当插值帧的位移小于precision精度门限时自动暂停stop(Phase.PauseAuto)避免无意义的持续事件。滚动相位模拟让第三方应用以为是触控板为什么平滑滚动事件能被 Chrome、Safari 等应用接受并表现顺滑关键在于 Mos 模拟了触控板滚动的相位字段。ScrollPhaseScrollPhase.swift维护一个状态机Phase 状态含义Scroll/Momentum 取值Idle空闲0.0 / 0.0Contact手指触碰开始128.0 / 0.0Tracing跟随滚动2.0 / 0.0Momentum缓动惯性滚动0.0 / 2.0PauseAuto自动停止0.0 / 3.0PauseManual手动停止4.0 / 0.0状态在kickIn()新滚动事件到达与transfrom()发送时之间按映射表流转其中applyMomentum()使用 300ms 防抖将状态推进到 Momentum模拟触控板的惯性阶段见 ScrollPhase.swift。特别地stop()中针对 Chrome 的处理ScrollPoster.swift当目标应用是 Chrome 时发送一个带PauseManualScroll4.0的零事件来重置 Chrome 的滚动缓冲区否则 Chrome 会残留惯性状态。热键与鼠标干预ScrollCore还监听修饰键按下/抬起ScrollCore.swift支持三类临时行为Dash冲刺按住配置的修饰键时dashAmplification变为 5.0滚动增益放大 5 倍用于快速翻页Toggle切换方向按住时临时翻转滚动方向Block屏蔽平滑按住时临时禁用平滑滚动并调用ScrollPoster.brake()刹车。这些修饰键的配置保存在每个应用例外项中dash/toggle/block三个字段见 Constants.swift左右键均可触发。同时左键按下事件会立即停止正在进行的平滑滚动mouseLeftEventCallBack见 ScrollCore.swift避免在滚动中点击产生漂移。配置参数默认值与存储方式Mos 的全部设置通过Options单例Options.swift读写UserDefaults。以下是 Constants.swift 中定义的默认参数与对应存储键基础设置General配置项默认值UserDefaults 键说明平滑滚动truesmooth是否启用鼠标平滑滚动翻转方向truereverse是否翻转鼠标滚动方向不影响触控板登录自启false系统 LoginItems通过 LoginServiceKit 管理隐藏菜单栏图标falsehideStatusItem隐藏状态栏图标白名单模式falseallowlistfalse黑名单true白名单应用列表空applications例外应用JSON 编码对应界面代码见 PreferencesGeneralViewController.swift四个复选框平滑、翻转、自启、隐藏图标直接绑定上述开关。高级设置Advanced / 滚动曲线配置项默认值UserDefaults 键说明Step步进35.0step非 Fixed 事件的归一化门限值Speed速度3.00speed插值增益系数越大滚动越快Duration时长3.90duration插值缓动时长0~5越大越柔和Precision精度1.00precision位移小于该值时自动停止插值Dash 热键0dash冲刺热键修饰键枚举值Toggle 热键0toggle方向切换热键Block 热键0block平滑屏蔽热键其中duration不会直接参与插值而是通过generateDurationTransition(with:)Constants.swift转换为过渡系数durationTransitionlet upperLimit 5.0 0.2 let val 1-(duration/upperLimit).squareRoot() return Double(round(1000 * val)/1000)即durationTransition 1 - sqrt(duration / 5.2)默认duration3.90对应约0.134。这个转换让滑块取值与手感呈非线性关系小数值区间更精细。读取配置时Options.swift会同步计算durationTransition并保存到scrollAdvanced。所有参数在写入时通过didSet观察器自动持久化saveOptions()并设置optionsExist标志读取时若标志不存在则先以默认值写入一次。配置采用 JSON 编码存于UserDefaults.standard其中应用列表使用EnhanceArrayEnhanceArray.swift按path去重并监听变更自动保存。按应用定制例外应用与黑白名单Mos 允许为特定应用单独配置滚动行为。ExceptionalApplicationExceptionalApplication.swift是 Codable 模型字段包括path应用可执行路径或 Bundle 路径唯一标识Equatable 按此比较displayName显示名称可为空为空时从路径解析inherit是否继承全局高级参数仅影响 Advanced 部分默认truescrollBasic/scrollAdvanced该应用自己的滚动基础与高级配置。运行时决策逻辑在 ScrollCore.swift若事件目标应用在例外列表中则使用该应用的isSmooth/isReverse/getStep/getSpeed/getDuration否则在非白名单模式allowlist false即黑名单语义下使用全局配置。注意isSmooth与isReverse的判定是双重 AND应用级开关与全局开关同时为真才生效ExceptionalApplication.swift。当allowlist为true时则转为白名单语义只有例外列表中的应用才会应用平滑/翻转其他应用一律放行原始事件。这就是 README 所称的built-in per app block/allow list support的完整实现。图形化监控与窗口管理README 提到的informative graph that shows the scroll events对应仓库的 Monitor 模块。从 Constants.swift 可看到应用维护了四类窗口控制器introductionWindowController首次启动引导welcomeWindowController欢迎窗口monitorWindowController滚动事件监控窗口图形化呈现preferencesWindowController偏好设置窗口。监控窗口的实现位于 Windows/MonitorWindow偏好设置则拆分为 General / Advanced / Exception / Donate / About 等多个面板见 Windows/PreferencesWindow其中例外应用管理界面支持添加、编辑与输入PreferencesExceptionViewController.swift 与 PreferencesExceptionInputViewController.swift。贡献与许可证Mos 欢迎任何形式的贡献你可以通过提交 Issue 报告问题或提出改进也可以直接提交 PR 完善代码或本地化翻译仓库 Localization 目录已包含 en、zh-Hans、zh-Hant、ja、ko、ru、de、tr、uk、el 等多语言Localizable.strings。提交 Issue 与 PR 前可参考 ISSUE_TEMPLATE.md、CONTRIBUTING.md 与 CODE_OF_CONDUCT.md。许可证方面README 明确Mos 采用CC Attribution-NonCommercial署名-非商业性使用许可LICENSE版权归 Caldis 所有且禁止将 Mos 上传至 App Store。在使用、二次开发或分发时请务必遵守该非商业限制。总结从 README 到源码的完整闭环回顾 README.enUS.md 的五项核心特性每一项目前都能在仓库中找到对应实现平滑滚动由ScrollCoreScrollPosterInterpolator协作完成方向独立翻转由ScrollEvent.reverse与事件分类保证触控板事件被直接放行速度与加速度曲线由step/speed/duration参数控制监控窗口由 Monitor 模块提供黑白名单由ExceptionalApplication列表与allowlist标志实现。Mos 的巧妙之处在于它不在任何应用内部做手脚而是站在系统事件流这一更高维度用 CGEventTap 截流、用 CVDisplayLink 逐帧插值、用相位字段伪装触控板滚动语义——这套事件级平滑方案正是它保持轻量、免费且广泛兼容的底层原因。安装、配置与源码结合阅读后你既可以用brew install mos快速上手也能在需要时深入 Mos/ScrollCore 定制属于自己的滚动曲线。赞分享桌面应用【免费下载链接】Mos一个用于在 macOS 上平滑你的鼠标滚动效果或单独设置滚动方向的小工具, 让你的滚轮爽如触控板 | A lightweight tool used to smooth scrolling and set scroll direction independently for your mouse on macOS项目地址https://gitcode.com/gh_mirrors/mo/Mos点击查看免费下载相关推荐Mos 使用指南与源码原理全解在 macOS 上实现鼠标滚轮平滑滚动与方向独立设置Mos 使用指南与源码原理全解在 macOS 上实现鼠标滚轮平滑滚动与方向独立设置 Mos 是一款免费、开源的 macOS 状态栏小工具核心目标是用软件手段桌面应用macOS滚动方向设置完全指南3步解锁触控板与鼠标独立控制macOS滚动方向设置完全指南3步解锁触控板与鼠标独立控制 Scroll Reverser是一款专为macOS设计的开源工具通过创新的独立滚动控制技术彻底桌面应用Mac滚动革命Mos工具实现鼠标触控板独立控制终极方案Mac滚动革命Mos工具实现鼠标触控板独立控制终极方案 在Mac使用过程中你是否经常遇到这样的困扰习惯了触控板的自然滚动方向但外接鼠标却总是反向操作在桌面应用上一篇macOS iSCSI启动器终极指南在苹果系统上实现企业级存储连接下一篇最全面的前端代码统计指南从HTML/CSS到React/Vue的cloc实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考