文档
你能映射的每一个 Trigger 与 Action、设置窗口是怎么组织的,以及全文用到的术语。
快速开始
MouseTuner 是一个菜单栏应用,没有 Dock 图标,也没有主窗口。设置窗口是唯一的完整界面,从菜单栏图标打开。
权限
平滑滚动、按键映射、触控板边缘与 Domain Rule(读取当前浏览器标签页的 URL)都需要辅助功能权限。缺少时,相关面板会说明缺的是什么,并链接到系统设置。
不需要输入监控权限。蓝牙直连的罗技鼠标会额外触发一次蓝牙配对弹窗,补授后需要重启才能生效。
设置面板
- 滚动:平滑滚动的曲线编辑器与实时预览。
- 按键:Trigger 到 Action 的映射。
- 应用覆盖:一份应用列表,同时管该应用的平滑滚动与按键映射。
- 设备:Recognized Device 的 DPI、SmartShift 与电量设置。
- 触控板:接了鼠标时忽略内建触控板,或者忽略落在四边可调边带里的触碰。
- 输入法:按应用或浏览器域名自动切换输入法。
- 通用:更新、iCloud 同步、崩溃上报(默认关闭)。
- 权限:已授予什么、缺什么、为什么重要。
Trigger
Trigger 是你对一颗键做的动作。每条 Trigger 各自指向一个 Action,同一颗键可以挂好几条,只要类型不重复。
- 单击:按下再松开。
- 双击。配了双击之后,这颗键的单击会先等一下第二次按;把这条映射停掉,单击又立刻生效。
- 长按:按住超过你设定的时长。
- 四方向拖拽:按住这颗键,把鼠标往上、下、左、右推一下。判断方向期间指针会停住,免得焦点跑到别的窗口上去。
- Chord:另一颗键已经按住的时候,再按这一颗。
- Hold + Scroll:按住这颗键再拨滚轮,两个方向都算。
- 滚动:什么都不按,单独拨滚轮。
Action
Action 是 Trigger 触发之后做的事。其中两个有始有终:按下开始,松开结束;其余的都是触发一次就完了。
- 发送一个键盘快捷键,修饰键随便配。
- 执行一个系统动作:调度中心、应用程序窗口、显示桌面、向左切换空间、向右切换空间、截屏(整个屏幕)、截屏(选定区域)、锁定屏幕。
- 按一个媒体键:播放 / 暂停、下一首、上一首、提高音量、降低音量、静音。这些走系统的媒体通道,所以 Apple Music、Spotify 和浏览器里的视频都会响应。
- 打开一个 App。
- 打开一个 URL。
- 运行一段 AppleScript。
- 运行一段 Shell 脚本。
- Modifier Hold:按下即按住某个修饰键(比如 Fn),松开即松开。按住说话的语音输入就是靠它:MouseTuner 负责把键按着,剩下的交给你的听写工具。
- Pan While Held:按住这颗键的时候,移动指针就变成滚动,像地图或画布里的抓手工具。它不判断方向,也不是触发一次就完;按住期间的每一点移动都会被换成滚动。速度可调,因为同样一下手腕的动作,在 800 DPI 和 3200 DPI 的鼠标上走的距离差很远。
- 在齿位与自由转之间切换滚轮。滚轮模式键一旦被映射,鼠标就不再自己切模式了,这个 Action 把这件事补回来。
术语表
这些词在 MouseTuner 支持的所有语言里都保留英文,包括这份文档本身。
- Trigger
- 触发条件:单击、双击、长按、四方向拖拽、Chord、Hold + Scroll。
- Chord
- 两个按键同时按下的触发方式。
- Action
- 映射的目标:快捷键、系统动作、媒体键、打开 App/URL、AppleScript、Shell、Modifier Hold。
- Modifier Hold
- 按下即按住某个修饰键、松开即松开的 Action 类型,push-to-talk 是它的应用。
- App Override
- 按前台应用生效的平滑滚动或按键映射覆盖配置。
- Scroll Curve
- 平滑滚动的参数集:最小步长、速度增益、时长、衰减。
- SmartShift
- 罗技滚轮的自适应齿位/自由转切换功能,是支持它的鼠标上的一项设置。
- Device Profile
- 一个已识别机型的能力描述:按键、DPI 范围、SmartShift、电量查询方式。
- Recognized Device
- 存在 Device Profile 的设备,多出 DPI、SmartShift 与电量这几项设置。
- Generic Device
- 其他任意鼠标,平滑滚动与基础按键映射照样能用。
- HID++
- 罗技鼠标用来传递设置的协议,DPI、SmartShift、电量都经由它。
- License Key
- 购买后获得的字符串,一把 key 对应一次购买。
- Seat
- 一把 License Key 允许绑定的机器数,当前是 3。
- Trial
- 30 天全功能试用,无需账号或付款方式。
- Command
- macOS 修饰键,映射与快捷键说明里保留英文按键名。
- Option
- macOS 修饰键,同上。