键盘

OpenLogi 把键盘当作一等设备：可以重映射 F 区、通过 HID++ 控制 Fn-lock 与背光，还能在键盘切换主机时把配对的鼠标一起带走。

重映射按键有两条相互独立的路径：

HID++ F 区按键

罗技键盘的媒体 / 快捷键区可以逐键通过 HID++ 接管，按下时派发 OpenLogi 动作而非其印刷功能。OpenLogi 建模了 Signature 系列的九个控件：

只有带绑定的按键才会被接管，未绑定的按键保持固件原生功能，OpenLogi 完全不碰它。设备未暴露的控件会被跳过并记录日志，因此支持不完整的键盘是逐键降级，而不是整体失败。

[devices."receiver:aabbccdd:slot:2".bindings]
KeySearch = "MissionControl"
KeyScreenCapture = "CaptureRegion"
KeyMicMute = { CustomShortcut = "Cmd+Shift+M" }

功能键重映射

Keys 标签页通过系统钩子重映射任意键盘的功能键：键盘照片旁边是一排标注气泡，点击某个键即可选中它并滑出动作面板（动作目录与鼠标选择器相同，另含 Power User 分区）。

这些绑定是全局的而非按设备，保存在 config.toml 的 [keyboard.bindings] 下。触发键写作 [修饰键+]…按键，修饰键为 shift、control（ctrl）、option（alt）、command（cmd），按键为 esc 与 f1–f19：

[keyboard.bindings]
f1 = "MissionControl"
"shift+f2" = "ShowDesktop"
"cmd+f5" = { CustomShortcut = "Cmd+Shift+P" }

Fn-lock

fn_lock 通过 HID++ fn 反转（0x40a2，多主机键盘为 0x40a3）在印刷媒体功能与纯 F1–F12 之间切换 F 区：

[devices."receiver:aabbccdd:slot:2"]
fn_lock = true    # 无需按住 Fn，F 区直接发送 F1–F12

true 把整排锁定为 F1–F12，false 恢复印刷功能，不写该键则表示「不要改动键盘当前的状态」。该状态按主机存放在设备内存中，因此键盘每次重连时代理都会重新下发你的选择。目前尚无对应的 GUI 控件。

主机切换

支持多主机（Easy-Switch）的键盘可以在切换主机时把鼠标一起带走。把目标设备的物理键列在键盘的条目下：

[devices."receiver:aabbccdd:slot:2"]
host_switch_targets = ["receiver:aabbccdd:slot:1"]

按下键盘的主机键时，会先切换列出的每个目标，键盘自己最后离开。两台设备必须已经配对在彼此对应的通道上，且每个目标都要暴露 HID++ 主机切换相关特性（0x1814 changeHost / 0x1815 hostsInfo）。由于这一关系由键盘发起，请在每台可能发起切换的电脑上都配置一次。

灯光

键盘背光与 RGB 见灯光：通过 0x8070 / 0x8081 设置静态每键颜色，通过 0x1982 设置单色背光档位。

状态： F 区接管、Fn-lock 与主机切换都走 HID++，在 macOS、Linux、Windows 上均可用。功能键重映射依赖系统键盘事件，钩子目前在 macOS 与 Windows 上投递；Linux 的按键捕获尚未接入。