键盘灯光

OpenLogi 驱动两套不同的键盘灯光系统：G 系列键盘上的 RGB 引擎（以单一静态颜色呈现，而非逐键特效），以及 MX Keys 系列上可调档的白色背光。Litra 补光灯请见 Litra 补光灯。

RGB 键盘

在设备轮播中选中键盘并打开它的 Lighting 标签页：

• 颜色色块 —— 一小组预设强调色。
• 开 / 关 —— 是否应用该静态颜色。
• 亮度 —— 0–100 滑块。松开滑块时才把档位下发到键盘，因此拖动不会产生连串更新。

底层实现上，OpenLogi 优先走键盘的特效引擎——HID++ 0x8070 colorLedEffects，写入固定单色特效——因为这样才能替换掉正在运行的板载配置；在 G 系列固件上，逐键的 0x8080 写入无法覆盖它。颜色只写入 RAM，不会烧写到闪存；键盘重连时由代理重新下发。

你的选择按设备保存在配置的 [devices.<key>.lighting] 下（enabled、color、brightness）。

MX Keys 背光

带白色感应背光的键盘暴露的是 HID++ 0x1982 backlight 而非 RGB 引擎，目前从命令行驱动：

openlogi backlight            # 当前状态（模式、档位、状态）
openlogi backlight off        # 完全熄灭，不再受环境光或手部靠近影响
openlogi backlight on         # 恢复键盘中保存的模式与档位

与 RGB 路径不同，它写入键盘的非易失性配置，因此重连、切换主机、断电后依然生效，无需任何东西重新下发。

状态： macOS、Linux 与 Windows 均可用。协议细节见 0x8070 colorLedEffects、0x8081 perKeyLighting2 与 0x1982 backlight。