StrokeMouse：macOS 鼠标手势工具

项目简介

StrokeMouse 是一款面向 macOS 的鼠标与触控板手势自定义工具，常驻菜单栏运行，所有识别与动作执行都在本地完成。按住触发键（默认右键，也可改选中键或侧键）在屏幕上画出轨迹，匹配到手势后执行快捷键、打开应用、窗口操作、媒体键、Shell / AppleScript 等动作。手势可以全局生效，也可以只在指定 App 内生效，配置支持导入导出。

主要功能

• 菜单栏应用：启用 / 暂停手势、打开设置、退出；图标颜色随状态变化（正常 / 暂停 / 缺少权限）；可隐藏菜单栏图标。
• 手势库：侧边栏按「全局 / 单应用」分组，新增手势自动继承当前范围；支持搜索、筛选、排序，多选批量启用、停用、删除；支持 JSON 导入导出，导入时可跳过或强制覆盖重复项；可在「通用 → 不启用全局手势的应用」中为指定 App 关闭全局手势。
• 鼠标绘制：每个手势可独立选择右键、中键或侧键作为触发键；可设置左键附加动作，绘制途中点一次左键，松开时只执行该动作。
• 鼠标组合：按住右键滚动、点左键或拖动滚动；在屏幕任意显示器的上 / 下 / 左 / 右边缘右键或滚动即可直接触发动作，无需绘制。
• 鼠标按键映射：侧键或中键单击直接执行动作（例如后退侧键 → ⌘[ ），可要求同时按住某个修饰键；同一按键既单击又绘制时，未达到最小绘制距离视为单击，不会重复触发。
• Trackpad Draw：按住 Fn / Control / Option / Shift / Command 中的任意一个（默认 Fn）并移动指针来绘制手势。
• 实验性触控手势：内置触控板支持 40 种手势类别，包括三到五指轻点、双击、按压、双击按压、四向滑动，以及二到五指捏合、张开和顺 / 逆时针旋转；提供总开关，可暂停而不删除已配置手势。
• 滚动增强：鼠标滚轮与触控板 / Magic Mouse 可按轴分别反向，可选平滑滚轮滚动（温和 / 标准 / 灵敏或自定义速度、时长、加速度），排除规则按前台 App 匹配。
• 自由路径识别：每个手势可录制 1–5 个样本（推荐 3 个），取最匹配样本；采用弹性弧长对齐，先比方向再比位置，容忍曲线、抖动和末端小钩，拒绝反向、镜像、截断或明显延长的笔画；按住触发键时显示实时笔迹 HUD，提示松手将执行哪个手势。
• 动作类型：系统命令（调度中心、应用程序窗口、上一个 / 下一个空间，可自定义系统快捷键绑定）、快捷键（含 Fn/Globe 单按或组合，并可继续按顺序接其他按键）、打开应用（图标选择器）、URL、媒体键、窗口操作、Shell / AppleScript（带语法高亮的编辑器，内置睡眠、锁屏、清空废纸篓等 AppleScript 预设）。
• 其他：界面支持英文、简体中文、繁体中文、韩文、日文、俄文、法文（可跟随系统）；浅色 / 深色外观；登录时启动；隐藏 Dock 图标；Sparkle 应用内更新，失败时回退到 GitHub Releases。

安装与使用

通过项目维护的 Homebrew Tap 安装：

brew install --cask licoy/tap/strokemouse

强制检查并安装升级：

brew upgrade --cask --greedy strokemouse

也可以从官方下载页下载对应架构的 DMG。卸载默认保留设置，加 --zap 可一并清除。

环境要求：macOS 14 Sonoma 或更高版本。

权限说明：

权限	用途
辅助功能	全局鼠标 / 修饰键 / 滚动监听（CGEventTap）、快捷键注入、窗口 AX 操作
自动化	可选，AppleScript 控制其他 App 时需要

首次启动或进入「设置 → 权限」时，可用应用内的 Guide Me 打开系统设置并把 StrokeMouse 拖入列表。未获得授权时引擎不会假装在监听。

注意事项

• 从 0.0.39 及更早的自签版本升级到 0.0.40 及以上时，macOS 不再认可原有的辅助功能授权：需在「隐私与安全性 → 辅助功能」中移除 StrokeMouse 后重新添加一次（或在权限页点击 Reset Authorization 再打开）。之后的更新会保留授权。
• 实验性触控手势通过 dlopen / dlsym 在运行时加载 Apple 未公开的 MultitouchSupport，macOS 更新后可能失效；框架、符号、设备缺失或启动失败只会导致触控板通道不可用，鼠标与 Trackpad Draw 仍正常工作，没有模拟回退或静默重试。
• StrokeMouse 不会拦截系统原生触控板手势，因此绑定动作可能与系统手势同时发生；例外是 Click 手势，被识别时该次点击会交给手势，应用不再收到。
• 外接 Magic Trackpad 的支持为尽力而为，可能因型号或 macOS 版本而异。
• 项目以 AGPL-3.0 许可证开源。

---

本作品整理自 GitHub 开源项目 Licoy/StrokeMouse，原作者 @Licoy，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。