介绍

一个使用 Rust 编写的本地优先的 Logitech Options+ 平替。

重新映射按键、调节 DPI 与 SmartShift、按应用切换配置，无需 Logitech 账号、无遥测，也无需安装官方 Options+。

介绍

OpenLogi 通过 Logi Bolt、Unifying 与 Lightspeed 接收器、蓝牙直连或 USB 线缆，直接与 Logitech HID++ 外设通信，无需运行 Logi Options+。一切都留在本机：按键绑定保存在纯 TOML 文件中，按键通过操作系统输入钩子重映射，DPI、SmartShift、滚动与灯光的更改通过 HID++ 直接写入设备。

它能驱动什么

• 鼠标 —— 按应用的按键绑定与受支持的手势、短按 / 长按动作、按住快捷键、DPI 预设、SmartShift、 滚轮反转与分辨率、平滑滚动与灵敏度、拇指滚轮，以及 MX Master 4 的 Haptic Sense 触感面板。
• 键盘 —— 通过 HID++ 的 F 区重映射、Fn-lock、主机切换、RGB 颜色，以及 MX Keys 背光。
• Litra 补光灯 —— 开关、亮度、色温，以及随摄像头自动点亮。
• 摄像头 —— 设备级 UVC 图像控制与实时预览。

超越 Options+

OpenLogi 能做、而 Options+ 做不到的事：

• 跑在 Linux 上。 Options+ 只有 macOS 和 Windows 版本。OpenLogi 把 Linux 当作一等公民：evdev/uinput 钩子、udev 规则、systemd 用户单元，以及 .deb / .rpm / .pkg.tar.zst 安装包。
• 选择受支持的手势键。 后退、前进、专用手势键、触感面板，以及报告可转移与 raw-XY 能力的 DPI / 模式切换键都可以绑定方向手势，也可以同时启用多个。主键和滚轮控件不能新建手势绑定； 已有的中键手势仍会保留。
• 纯文本配置。 全部设置就是一个 TOML 文件，可读、可 diff、可纳入版本管理、可在多台机器间复制。
• 可脚本化。 通过 CLI 查询设备清单、使用 JSON 自动化接口、调节 DPI、SmartShift 与 Fn-lock、预取资源、控制补光灯与摄像头，以及执行 HID++ 诊断。
• 保持轻量。 原生 Rust 二进制：没有 Electron 全家桶、没有常驻更新器、无账号、无遥测。

文档版本

本指南以已发布的 v0.8.11 为基准，最近一次文档更新为 2026 年 10 月 3 日。 未发布的行为会单独标明。各版本变化见更新日志，schema 7 的迁移与恢复见 配置参考，隐私安全的设备 fixture 录制流程见参与贡献。

快速开始

下一步

与 Logitech 无关联。「Logitech」、「MX Master」和「Options+」是 Logitech International S.A. 的商标。