Prologue
将指针移到鼠标上，看看它感知到的位置Move your pointer over the mouse to see what it senses
它能感知每一根手指落下的位置。可长久以来，它只被用来滚动和轻扫——它的潜力，远不止于此。It senses exactly where every finger lands. Yet for years it has only been used to scroll and swipe. It can do so much more.
约每秒 90 帧读取触点，手势跟手，不迟滞。Touches are read about 90 times a second, so gestures feel immediate.
该触发的必须触发，不该触发的必须安静。What should fire, fires. What shouldn't, stays quiet.
纯 Swift 原生编写，常驻菜单栏，几乎感觉不到它的存在。Native Swift, lives in the menu bar, and stays out of your way.
Gestures
触控板上那些早已长进肌肉记忆的动作——轻点、右键、捏合、缩放——Mopad 把它们原样带到了妙控鼠标上。不必换设备，也不必改习惯，一切都像在触控板上一样轻快又自然。Tap, right-click, pinch, zoom — the trackpad moves that live in your muscle memory. Mopad brings them to the Magic Mouse, just as they are. No new device, no new habits. Everything feels as light and natural as on a trackpad.
慢慢向下滚动，手势会随之一帧帧展开Scroll slowly — each gesture unfolds frame by frame
01 — 04
单指轻点鼠标表面即为点按，不必用力按下按键。可在设置或菜单栏中一键开关。Tap with one finger to click — no need to press the shell down. Toggle it anytime from Settings or the menu bar.
就像在触控板上轻点一样。Just like tap to click on a trackpad.
轻点两下即为连按，打开文件、选中词语都可以。节奏跟随系统的「连按速度」。Tap twice to double-click — open files, select words. The timing follows your system double-click speed.
在触控板上，这同样是轻点两下。Same as double tapping a trackpad.
02 — 04
三指同时轻触，弹出右键菜单。只认「快落快起」，判定时长可在设置里调节。Tap with three fingers to bring up the context menu. Only quick taps count, and the timing is adjustable.
对应触控板上的双指点按。The trackpad's two-finger click, on your mouse.
03 — 04
三指轻轻收拢，打开应用程序索引。不必捏到底，轻轻一收就触发，灵敏度可调。Gently pinch three fingers together to open Apps. A light pinch is enough, and sensitivity is adjustable.
就像在触控板上用拇指与三指合拢。Like pinching with thumb and three fingers on a trackpad.
三指捏合也可以改为打开调度中心、聚焦搜索或显示桌面，按你的习惯来。Prefer something else? Set the pinch to open Mission Control, Spotlight or Show Desktop instead.
握着鼠标时拇指常常搭在侧边。Mopad 同样识别「拇指 + 三指」的捏合，手指短暂丢失 0.15 秒内也不会中断。Your thumb often rests on the side. Mopad recognizes a thumb + three finger pinch too, and tolerates fingers dropping out for up to 0.15 s.
04 — 04
双指张开或捏合，在照片、预览、网页里平滑缩放。触发灵敏度与缩放速度都可调。Spread or pinch two fingers to zoom smoothly in Photos, Preview and the web. Sensitivity and speed are adjustable.
就像在触控板上双指捏合。Just like pinch to zoom on a trackpad.
个别应用不响应原生捏合？把缩放方式切换为快捷键模式，双指捏合会发送 ⌘+ / ⌘−，几乎所有应用都能缩放。An app ignores native pinch? Switch to shortcut mode and the pinch sends ⌘+ / ⌘− instead — it works almost everywhere.
缩放期间及抬指后 0.6 秒内，Mopad 会暂时屏蔽滚动与全屏轻扫，页面停在你想要的位置。During a zoom and for 0.6 s after, Mopad holds back scrolling and full-screen swipes, so the page stays where you want it.
Mopad 只读取妙控鼠标的触点，不会影响触控板。所有手势都可以单独开关。Mopad only listens to the Magic Mouse — your trackpad is unaffected. Every gesture can be turned on or off individually.
Settings
「系统设置 › 鼠标」的常用项全部内置在 Mopad 里，与系统双向同步，拖一下就即时生效。顶部还会实时显示指尖在鼠标上的位置，以及最近识别到的手势。The essentials from System Settings › Mouse are built right in, synced both ways and applied instantly. The header even shows your fingers on the mouse in real time, along with the last gesture recognized.
…还有更多 · 指向一项，看它在哪里…and more · point at one to find it
九项鼠标设置在 Mopad 里改，系统里同步变；在系统里改，Mopad 也会跟上。Change any of nine mouse settings in Mopad and System Settings follows — and vice versa.
跟踪速度 · 滚动速度 · 连按速度 · 自然滚动 · 辅助点按 · 智能缩放 · 在页面间轻扫 · 在全屏应用间轻扫 · 调度中心Tracking speed · Scrolling speed · Double-click speed · Natural scrolling · Secondary click · Smart zoom · Swipe between pages · Swipe between full-screen apps · Mission Control
同时开启「单指轻点」与系统「智能缩放」时，连按会触发缩放。Mopad 会直接提示，并给出一键关闭按钮。With tap to click and Smart Zoom both on, double taps would also zoom. Mopad tells you right away and offers a one-click fix.
辅助功能、事件发送、事件监听三项权限逐一检测。授权完成后 Mopad 自动重启，就绪即用。Accessibility, event posting and event listening are each checked. Once granted, Mopad relaunches itself and is ready to go.
从菜单栏一键启用 / 停用 Mopad，或单独开关「单指轻点」。不占程序坞，不打扰你。Enable or pause Mopad, or toggle tap to click, straight from the menu bar. No Dock icon, no distractions.
开机即用。鼠标断连重连、Mac 从睡眠中唤醒后，Mopad 都会自动重新识别设备。Ready from the moment you log in. After reconnecting the mouse or waking your Mac, Mopad finds it again automatically.
三指轻触的判定时长、三指捏合的灵敏度、双指缩放的触发灵敏度与速度，都有独立滑杆。Separate sliders for three-finger tap timing, pinch sensitivity, and zoom sensitivity and speed.
这个窗口可以直接操作：拨开关、拖滑杆、切换选项This window is live — flip switches, drag sliders, change options
How it works
CGEventNSWorkspaceDownload
安装只需三步Up and running in three steps
打开下载的 DMG，把 Mopad 拖进「应用程序」文件夹。Open the DMG and drag Mopad into your Applications folder.
发布包为自签名、尚未经 Apple 公证。首次打开请在访达中右键 Mopad 选择「打开」，或在终端执行：The app is self-signed and not yet notarized. The first time, right-click Mopad in Finder and choose Open — or run:
xattr -dr com.apple.quarantine /Applications/Mopad.app前往「系统设置 › 隐私与安全性 › 辅助功能」打开 Mopad。授权后它会自动重启，设置页顶部的权限提示消失即就绪。Turn on Mopad in System Settings › Privacy & Security › Accessibility. It relaunches automatically and is ready once the permission notice disappears.
Questions
妙控鼠标（Magic Mouse），搭配 macOS 14 及以上、搭载 Apple 芯片的 Mac。目前已在 macOS 26 与 USB-C 版妙控鼠标上测试，手势阈值仍在持续调校中。Apple Magic Mouse on Macs with Apple silicon running macOS 14 or later. It's currently tested on macOS 26 with the USB-C Magic Mouse; gesture thresholds are still being fine-tuned. The app interface is currently in Simplified Chinese.
不会。Mopad 按设备类型只监听妙控鼠标，触控板和其他鼠标照常工作。No. Mopad only listens to the Magic Mouse by device type. Your trackpad and other mice work exactly as before.
合成点按、右键与缩放，以及识别物理点击、缩放时暂停滚动，都需要这项系统权限。Mopad 不联网，也不收集任何数据。Posting clicks, right-clicks and zooms — and detecting physical clicks or pausing scrolling during a zoom — all require this permission. Mopad never goes online and collects no data.
在「系统设置 › 隐私与安全性 › 辅助功能」列表中选中 Mopad，点「−」移除，再回到 Mopad 点「去授权」重新添加。授权完成后 Mopad 会自动重启。In System Settings › Privacy & Security › Accessibility, select Mopad and click “−” to remove it, then click “去授权” (Grant Access) in Mopad to add it again. Mopad relaunches automatically afterwards.
发布包为自签名，尚未经 Apple 公证。在访达中右键 Mopad › 打开即可放行，或执行 xattr -dr com.apple.quarantine /Applications/Mopad.app。The app is self-signed and not yet notarized. Right-click Mopad in Finder › Open, or run xattr -dr com.apple.quarantine /Applications/Mopad.app.
这是系统「智能缩放」也在响应单指轻点两下。关闭它即可——Mopad 的设置页会直接给出一键关闭按钮。That's the system's Smart Zoom responding to the same double tap. Turn it off — Mopad's settings offer a one-click button for exactly this.
可以在 Mopad 的「系统手势」里关闭「在全屏应用间轻扫」。Turn off “Swipe between full-screen apps” under System Gestures in Mopad.
「原生捏合」通过合成触控板手势事件实现，个别应用可能不接受。把「缩放方式」切换为「⌘+ / ⌘− 快捷键」即可。Native pinch works by synthesizing trackpad gesture events, which a few apps ignore. Switch the zoom mode to “⌘+ / ⌘− shortcut”.
不能。读取妙控鼠标触点需要使用 macOS 私有框架，这不符合 App Store 的上架要求；macOS 大版本更新后也可能需要适配。No. Reading Magic Mouse touches requires a private macOS framework, which the App Store doesn't allow. Major macOS updates may also require an update to Mopad.
目前仅支持 Apple 芯片。如果你需要，欢迎在 GitHub Issues 中告诉我。Apple silicon only for now. If you need it, let me know in GitHub Issues.
先在 Mopad 中关闭「登录时打开」，从菜单栏退出，再把 Mopad 拖到废纸篓。如需清理残留，可删除 ~/Library/Application Support/Mopad 与 ~/Library/Preferences/com.zeki.mopad.plist，并在「辅助功能」列表中移除 Mopad。Turn off “Open at Login” in Mopad, quit it from the menu bar, then move it to the Trash. To remove leftovers, delete ~/Library/Application Support/Mopad and ~/Library/Preferences/com.zeki.mopad.plist, and remove Mopad from the Accessibility list.
完全免费，以 MIT 许可开源。如果它对你有用，欢迎在 GitHub 上点一颗星，或把手感反馈告诉我。It's completely free and open source under the MIT license. If you find it useful, a star on GitHub or feedback on how it feels is always appreciated.
接下来What's next
想要什么新手势、遇到什么问题，欢迎在 GitHub 的 Issues 中提出建议。Want a new gesture or ran into a problem? Share your ideas in GitHub Issues.