企业官网建设流程全解析

OpenLogi 是什么？一文看懂本地优先的罗技设备管理器（无需账号、无遥测）

【免费下载链接】OpenLogi⚡️A native, local-first alternative to Logitech Options+, written in Rust 🦀 — remap buttons, DPI, and SmartShift over HID++. No account, no telemetry.项目地址: https://gitcode.com/GitHub_Trending/op/OpenLogi

OpenLogi是一个用 Rust 编写的本地优先（local-first）开源罗技设备管理器，作为 Logitech Options+ 的轻量替代品，通过 HID++ 协议直接管理罗技鼠标、键盘和摄像头：按键重映射、DPI 预设、SmartShift 滚轮、RGB 灯光与 UVC 摄像头控制一应俱全，无需注册账号、不收集任何遥测数据。支持 macOS、Linux 与 Windows，配置文件就是一个可以用 Git 同步的 TOML 纯文本文件。

一、OpenLogi 与 Options+ 的核心区别

被 Options+ 的强制登录、臃肿体积和遥测困扰？OpenLogi 的设计目标正好相反——把设备控制权完全交还给你：

技术路线上，OpenLogi 直接走 HID++ / UVC 协议与硬件通信，HID++ 协议栈实现在crates/openlogi-hidpp模块中，配置与设备能力模型则在crates/openlogi-core，不依赖任何云端服务。

二、功能清单：一个软件管齐鼠标、键盘、摄像头

🖱️鼠标

• 按键重映射：中键、模式键、拇指滚轮均可捕获重映射，支持短按/长按分离与按住不放组合键（Push-to-talk）
• 手势键自由指定：任意物理按键都能承担手势角色，也可以彻底关闭手势
• Actions Ring：光标为中心的八槽位动作环，支持按应用切换布局
• DPI 控制：预设档位 + 一键循环切换（0x2201特性）
• SmartShift 滚轮：棘轮/自由模式切换、灵敏度调节、永久棘轮面板（0x2111）
• 原生滚动方向反转（0x2121）

⌨️键盘

• F 键全局重映射，与鼠标共用同一套动作目录
• 进阶动作：输入文本、组合键、多步工作流
• 静态 RGB 灯光控制（0x8070/0x8080）

📷摄像头（任何 UVC 罗技摄像头：Brio、StreamCam、C920 系列等）

• 即插即用；实时预览只在你查看时占用摄像头，离开即释放、指示灯熄灭
• 变焦、对焦、曝光、亮度、白平衡等参数直写 UVC 硬件，对 Meet / Zoom / OBS 全局生效
• 内置「默认 / 直播 / 视频通话」一键配置档，可按摄像头持久化保存

🔌连接与状态

• 支持 Logi Bolt、Unifying 接收器、蓝牙与有线连接，实时显示电池电量与充电状态
• 按应用自动切换配置叠加层（焦点切换即生效）

三、安装教程：macOS / Linux / Windows 三步上手

⚠️安装前务必先退出 Logi Options+——两者会争夺 HID++ 访问权，同一接收器同一时间只能由一方持有。

macOS（13 及以上）

brew install --cask openlogi

或从最新 release 下载已签名、已公证的.dmg，拖入/Applications即可。

Linux

# Debian / Ubuntu sudo dpkg -i openlogi_*.deb # Fedora / RHEL sudo rpm -i openlogi-*.rpm # Arch sudo pacman -U openlogi-*.pkg.tar.zst

安装包自带 udev 规则，用户可免 sudo 访问hidraw设备；装完后启用后台 agent：

systemctl --user enable --now openlogi-agent.service

NixOS 用户可直接导入项目自带的 NixOS 模块，完整说明见docs/INSTALL-linux.md。

Windows

release 页提供签名的便携版.zip和按用户安装的.msi（x86_64 与 arm64）。便携版中请让 GUI（OpenLogi.exe）与后台 agent（openlogi-agent.exe）放在同一目录——agent 负责所有设备 I/O。

想从源码构建？参考docs/DEVELOPMENT.md，也可直接克隆仓库：

git clone https://gitcode.com/GitHub_Trending/op/OpenLogi

四、配置指南：一个 TOML 文件管所有设备

OpenLogi 的全部设置都落在一个纯文本 TOML 配置文件里——改键位、加快捷键、调 DPI，都可以直接编辑文件，再用 Git、iCloud 或任何工具在多台机器间同步，这是 Options+ 给不了的自由度。

• 配置格式与字段说明：docs/CONFIGURATION.md
• CLI 命令用法（与 GUI 完全对等的脚本化入口）：docs/USAGE.md
• 示例配置：docs/config.example.toml

典型工作流：在 GUI 里调好按键映射 → 导出/保存 TOML → 推到另一台机器 → 生效。整个流程无需任何账号体系。

五、为什么"本地优先、无遥测"值得你关心

"本地优先"（local-first）意味着：

• 数据不出设备：所有配置、摄像头参数、设备状态都保存在本机
• 零账号：打开即用，没有登录墙，也不存在云端同步冲突
• 零遥测：作为开源项目，行为可审计——你可以直接读源码确认它没有上报任何数据（安全模型见docs/SECURITY.md）
• 离线可用：断网状态下所有功能照常工作

对于在意隐私的用户，这正是选择开源罗技设备管理器而非官方闭源方案的最大理由。

六、常见问题 FAQ

Q1：安装 OpenLogi 后必须卸载 Options+ 吗？不需要卸载，但运行时两者不能同时使用——退出 Options+ 即可，它们会争夺同一接收器的 HID++ 控制权。

Q2：Linux 支持完善吗？Linux 是 OpenLogi 的一等平台而非"移植版"。注意按应用切换配置叠加层在 Linux 上仅支持 X11 / XWayland 环境。

Q3：支持哪些罗技设备？罗技 Bolt / Unifying 接收器、蓝牙、有线连接的鼠标键盘均可，具体能力取决于设备暴露的 HID++ 特性；任何 UVC 罗技摄像头即插即用。

Q4：项目稳定吗？项目仍在积极开发中，功能与配置可能随版本变动。建议关注仓库获取新版通知；参与开发可查看docs/DECISIONS.md中的架构决策记录。

七、总结

如果你受够了账号强制登录和遥测，想用一个轻量、开源、本地优先的罗技设备管理器把 MX 系列鼠标、罗技键盘和摄像头调到最佳状态，OpenLogi 目前是最完整的答案：

1. 装：一条 brew 命令 / 一个安装包
2. 配：一个 TOML 文件搞定全部
3. 用：按键、DPI、SmartShift、灯光、摄像头，全在本地

OpenLogi 与罗技官方无隶属关系，"Logitech"、"MX Master"、"Options+" 均为罗技国际有限公司商标。

【免费下载链接】OpenLogi⚡️A native, local-first alternative to Logitech Options+, written in Rust 🦀 — remap buttons, DPI, and SmartShift over HID++. No account, no telemetry.项目地址: https://gitcode.com/GitHub_Trending/op/OpenLogi