重映射按键

在 GUI 的交互式示意图里重新指派罗技鼠标上可编程的按键：点击某个按键热点——或它的标签卡——然后从 动作中挑选，从 Copy/Paste 到 MissionControl、媒体键、真实的鼠标 4/5 键（MouseBack/MouseForward），以及 CycleDpiPresets。左右键始终直通；其余按键都可以重映射、按应用限定，并保存到你的 TOML 配置。

在 GUI 中

在设备列表里选中鼠标并打开它的 Buttons 标签页。页面会显示一张鼠标交互示意图——OpenLogi 有该设备素材时使用其官方渲染图，否则用合成剪影——每个可编程按键上有一个热点圆点，并用引导线连到侧边的标签卡。

• 热点圆点或标签卡 —— 同一流程的两个入口。悬停会高亮该按键；标签卡显示当前绑定，未绑定时显示 Unbound。点击任一处会在右侧固定检查器里选中它。
• 动作选择器 —— 按类别分组、可搜索的列表，当前绑定带勾选标记。选择 Do Nothing 表示捕获输入但什么都不做；Actions Ring 也可直接在选择器中选取。
• 带参数动作 —— CustomShortcut、OpenApplication、TypeText、脚本、工作流与 HoldShortcut 都是有效 TOML 动作，但当前鼠标检查器不会编写它们的参数。请在配置文件中保留或编辑这些绑定。
• 配置档 —— 示意图上方可在 Default 与按应用编辑之间切换。继承的按键会明确标注；修改它只会创建一条稀疏覆盖，Use the Default profile 会删除该覆盖。
• 手势 —— 在 Default 配置档中，受支持的控件会显示 Use gestures。检查器可分别编辑 Up、Down、Left、Right 与 Click。按应用配置每个按键只能保存一个动作，因此其中不会显示手势模式控件。

后退、前进、DPI/ModeShift 键、专用手势键与 MX Master 4 的 Haptic Sense 面板可分别开启手势模式。只有设备实测上报原始 XY 支持后，DPI/ModeShift 才能开启。OpenLogi 不再允许新建中键手势：v0.8.0 已保存的中键手势图仍可编辑，直到你关闭它；关闭后不能重新启用。

按键是如何被捕获的

捕获分为两条路径，最终汇入同一个动作分发器：

• 系统钩子 —— macOS 上的 CGEventTap、Linux 上的 evdev/uinput、Windows 上的 WH_MOUSE_LL，负责重映射中键、后退与前进；只有后退和前进可新建按住滑动手势。macOS 上需要辅助功能权限，Linux 上需要安装包附带的 udev 规则。
• HID++ 0x1b04 reprogControlsV4 会接管专用手势键、Haptic Sense 面板以及支持原始 XY 的 DpiToggle/ModeShift 键来识别手势，也承载这些控件的普通重映射与已绑定的键盘 F 区按键。当拇指滚轮的灵敏度离开默认值，或它的点按 / 某个旋转方向被重新绑定时，滚轮会通过 0x2150 thumbwheel 被接管。

区分手势与点击靠按住时长与位移：按住超过 160 毫秒且主轴位移至少 50 个原始 XY 单位即提交一次方向滑动；快速轻点则在松开时触发 Click 分支。

在配置中

绑定按设备持久化为纯 TOML，以设备的物理键索引。动作名原样序列化，与选择器里看到的一致：

[devices."unit:6be9d300".bindings]
Back = "BrowserBack"
Forward = "BrowserForward"
MiddleClick = "MissionControl"
HapticPanel = "ShowActionsRing"

# 处于手势模式的按键按方向绑定；Click 是单纯按下。
[devices."unit:6be9d300".bindings.GestureButton]
Left = "PrevTab"
Right = "NextTab"
Click = "PlayPause"

同样的键也可以写在 per_app_bindings."<app-id>" 下，只在指定应用位于前台时生效。这些值只能是单个动作：它可以在某个应用里取代全局手势键，但不能包含手势方向或短按 / 长按组合。完整的按键与动作词汇见配置，叠加规则见按应用配置。

TOML 还支持 { short = ..., long = ... } 按键组合与 HoldShortcut。阈值为 500 毫秒；持续快捷键会随发起它的物理按键松开，捕获被取消时也会释放。GUI 会显示组合中的短按动作，但在 GUI 里另选动作会替换整个组合；这两种形式目前请在 TOML 中编写。

状态： macOS、Linux 与 Windows 均可用。逐平台细节见路线图，协议细节见 0x1b04 reprogControls5。