企业官网建设流程全解析

OpenLogi 新手教程：10 分钟装好鼠标按键重映射，免费替代 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

OpenLogi 是免费的 Rust 本地罗技设备管理器，主打鼠标按键重映射：HID++ 协议直连鼠标与键盘，不注册账号、不上传遥测，全部设置存在一个本地 TOML 文件里。这篇新手教程带你走完装包、系统授权、第一次点亮设备，最后把一个侧键改成"按住说话"。

先花 10 秒判断该不该装

直接给结论：

适合装的人

• 被 Options+ 的账号、联网、云端同步缠住，想要设置落本地文件——这就是 OpenLogi 的默认形态
• 在 Linux 上用 Bolt / Unifying 接收器设备：它是一等公民，Solaar 缺的按钮重映射在这里补齐
• 想给侧键换活儿，且要求同一按键在不同应用里干不同的事

不适合装的人：项目还在活跃开发，配置结构可能随版本变动；如果只有一台蓝牙鼠标、系统默认行为就够用，不必折腾。

动手前清场：退出冲突程序，核系统版本

先退出 Logi Options+（Linux 上是 Solaar）。两个程序会互相抢接收器的 HID++ 控制权，同开必丢一台设备。

系统门槛三条：macOS 13 起；Linux 预编译包要求 GLIBC 2.35+（Ubuntu 22.04 起步）；Windows 10 / 11，x86_64 与 arm64 都有安装包。

三平台装法对照：一张表看懂 macOS、Windows、Linux

三条差异提醒：

• Windows 若走免安装.zip，OpenLogi.exe与openlogi-agent.exe必须同目录——后台 agent 承担全部设备 I/O，缺了它 GUI 连不上任何设备
• Linux 安装包会自动写入 udev 规则，给你的用户免 sudo 访问/dev/hidraw*和/dev/uinput；NixOS 用户可直接导入项目 module，udev 与 agent 一次配齐
• macOS 首次启动会弹系统权限框，辅助功能与输入监控都要打开——按钮重映射依赖输入钩子，Linux 端在 GUI 的 设置 → 权限 页看到Granted即通过

第一次点亮：跑 list 命令验证连接成功

openlogi list

输出里出现一行设备的插槽号、代号、类型、在线状态与电池百分比，接收器就已经落进 OpenLogi 手里。看到online加具体电量，连接即验证成功。

把鼠标侧键重映射成你想要的动作

点选按钮

打开 GUI 主窗口，进入该设备的 Buttons 面板，点选要改的键，比如Back。做完的标志：按钮名在面板中处于选中态，右侧出现动作选择区。

绑第一个动作

两个来源：内置动作目录（如BrowserBack），或录入自定义快捷键。两种自定义值得记牢：CustomShortcut按下即发一组按键；HoldShortcut的组合键全程保持按下，直到你松开物理键。典型用法：中键压住Ctrl+Space做语音开麦，手一松立刻停。做完的标志：按物理键，对应动作立刻发生。

长短按分流（可选）

给同一个键写一对动作{ short = ..., long = ... }：500 ms 内松开执行short，按住到 500 ms 执行一次long。一个键，两套行为。做完的标志：快速点一下与按住半秒，分别触发两个不同动作。

按应用覆盖行为（可选）

per_app_bindings让同一按键随焦点切换动作：VS Code 在前台时Back变"撤销"，切到浏览器又变后退。做完的标志：切到覆盖层对应的前台应用后，按键行为随之改变。

挂上动作环（可选）

给任意按钮绑ShowActionsRing，光标处弹出 8 槽环形动作盘，支持按应用单独布局。做完的标志：按键瞬间光标位置浮出环形菜单。

以上全部即点即写盘、即时生效——没有应用按钮，也不用重启。

读配置文件：路径、关键字段与备份机制

GUI 与 agent 读同一份文件：

• macOS / Linux：~/.config/openlogi/config.toml
• Windows：%USERPROFILE%\.config\openlogi\config.toml

关键字段长这样（逐字段完整样例见 docs/config.example.toml）：

schema_version = 7 [devices."receiver:aabbccdd:slot:1"] dpi = 1600 dpi_presets = [800, 1600, 3200] [devices."receiver:aabbccdd:slot:1".bindings] Back = "BrowserBack" [devices."receiver:aabbccdd:slot:1".smartshift] mode = "ratchet" auto_disengage = 16

三个行为要知道：保存是原子写入，滚动留 5 份备份（config.toml.backup.1到.5）；schema 校验严格，字段拼错或越界时 GUI 进只读模式并标出精确的 TOML 错误位置，修好文件重启即可，不会静默回退默认值。CycleDpiPresets配上dpi_presets绑到按钮，侧键就能循环切 DPI；smartshift.mode在棘轮与自由旋转间切换，auto_disengage调触发灵敏度。

踩坑急救：五个高频症状对号入座

• 设备列表是空的— Options+ 或 Solaar 还活着。退出冲突程序再启动，接收器的控制权就回来了
• Linux 钩子装不上— 打开 GUI 设置 → 权限页看/dev/uinput与/dev/hidraw*状态；设备若在规则生效前就连上，重插一次接收器让 udev 重发 ACL
• GUI 变只读并报错— TOML 写错了字段，报错会精确到位置，改完重启即可
• 侧键按了没反应— 按钮没被捕获或没绑动作，回 Buttons 面板确认；蓝牙设备先重新配对
• 想查设备底层能力—openlogi diag features与openlogi diag controls，HID++ 特性清单与可编程控件一次看全

侧键已经脱离云端，落在一个可以 diff 的文本文件里。完整字段参考看 docs/CONFIGURATION.md，诊断与自动化命令看 docs/USAGE.md——项目迭代快，升级前留意更新日志即可 🎯

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