企业官网建设流程全解析

完整指南：用零遥测的开源工具 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 是一款零遥测、本地优先的开源工具，专门用来重映射罗技鼠标和键盘的按键。如果你有一台罗技鼠标或键盘，又不想注册账号、不想装臃肿的官方软件，这篇文章就是为你写的。全程拆成 5 个任务，从装好到完成第一次按键重映射，大约 10 分钟。

先对比一下 Options+

OpenLogi 是 Rust 原生实现，和你最关心的差异如下：

支持的连接方式：Logi Bolt 接收器、Unifying 接收器、蓝牙或有线，GUI 里能看到电池电量和充电状态。

完成第 1 个任务：按你的系统装好它

⚠️先退出 Logi Options+（Linux 上是 Solaar）。两个程序会争夺同一个接收器的独占访问权，同一时刻只有一个能拥有它。同时运行会导致设备丢失或功能异常——这是新手排名第一的坑。

系统门槛集中列在这里：

macOS：一条命令装好签名版，或下载.dmg后把OpenLogi.app拖进/Applications：

brew install --cask openlogi

Linux：按发行版安装，安装包会自动写入 udev 规则，你的用户无需 sudo 就能访问/dev/hidraw*与/dev/uinput：

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

再启用后台代理，所有设备 I/O 都跑在它里面：

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

NixOS、手动与源码构建见 Linux 安装文档。

Windows：发布包提供按用户安装的.msi与免安装.zip。用 zip 时，OpenLogi.exe和代理openlogi-agent.exe必须放在同一目录，否则 GUI 没有任何设备数据可连。

完成第 2 个任务：三步让设备上线

1. 授予权限。macOS 首次启动会请求辅助功能与输入监控，点允许——按键重映射依赖这两个输入钩子。Linux 打开设置 → 权限，确认显示Granted；如果设备是在装 udev 规则之前接入的，把接收器拔下重插一次。
2. 验证连接。终端运行openlogi list，能看到插槽号、设备代号与电池电量即连接成功。
3. 回看 GUI。主窗口应出现设备卡片与电量状态，确认代理已接管设备。

完成第 3 个任务：三步改掉第一个鼠标按键 ✨

1. 选中按钮。打开设备详情里的Buttons面板，点击要改的按钮，例如侧键Back。
2. 挑一个动作。从内置动作目录里直接选（如BrowserBack），或录入自定义快捷键。把中键设为Ctrl+Space的「按住触发」（HoldShortcut）是语音开麦的标准用法：按住时组合键保持按下，松开物理按键组合键才松开。
3. 区分长短按。同一个按钮可以一次绑两个动作：500 ms 内松开触发短按动作，按住满 500 ms 触发长按动作。一个按钮，两种用法。

两个值得知道的延伸：

• 按应用切换：per_app_bindings让同一个按钮在不同应用里执行不同动作，比如切回 VS Code 时侧键变成「撤销」。
• Actions Ring 动作环：触发ShowActionsRing，屏幕中央出现 8 个插槽的环形动作盘，布局可按应用自定义。

以上每一项都实时写进本地那个 TOML 文件（macOS / Linux 在~/.config/openlogi/config.toml，Windows 在%USERPROFILE%\.config\openlogi\config.toml）。GUI 自动保留 5 份备份；schema 是严格的——拼错字段或越界会直接标出错误位置，GUI 转为只读，而不是静默吞掉。字段细节与可运行样例见配置文档和完整示例。

完成第 4 个任务：顺手配好 DPI 预设与 SmartShift 滚轮

两项配置，一分钟能做完：

• DPI 预设：在设备详情里设置当前 DPI 并保存多组预设（如 800 / 1600 / 3200），再把某个按钮绑到CycleDpiPresets，一键循环切换，不用翻系统弹窗。
• SmartShift 滚轮：棘轮 / 自由旋转切换、灵敏度调节，也可以常开棘轮模式。

配置文件里对应的最小片段：

[devices."receiver:aabbccdd:slot:1"] dpi = 1600 dpi_presets = [800, 1600, 3200] [devices."receiver:aabbccdd:slot:1".smartshift] mode = "ratchet"

完成第 5 个任务：排查三个最常见的症状

更多 CLI 诊断命令（DPI 冒烟测试、SmartShift 测试、灯光控制）见 docs/USAGE.md。

从安装到授权，再到第一次重映射，上面的路径已经全部走通，所有设置都沉淀在那一个 TOML 文件里，换机器直接复制就能同步。项目仍在快速迭代，留意后续版本的新能力。

【免费下载链接】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