企业官网建设流程全解析

OpenLogi 完整指南：免费把罗技鼠标按键重映射、DPI 预设与 SmartShift 滚轮调到位

【免费下载链接】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 是 Logi Options+ 的免费开源替代，本地优先、Rust 原生，通过 HID++ 直连罗技鼠标与键盘。按这篇走完，你能装好三大平台版本、把侧键改造成自定义动作，并配好 DPI 预设。

它不需要账号，也没有遥测：所有设置就一个明文 TOML 文件，你爱怎么跨机器同步都行。设备走 Logi Bolt 接收器、Unifying 接收器、蓝牙或有线接入，列表里能看到电池百分比和充电状态，Linux 在这里是一等公民。

动手之前：先退出官方工具，确认你的连接方式

📌 打开 OpenLogi 之前，先把 Logi Options+（Linux 上是 Solaar）彻底退出。两者会争夺同一个接收器的 HID++ 访问权，同一时刻只有一个应用能独占它。两个一起跑，最典型的后果就是设备从列表里消失，或者功能时好时坏。

然后对一下系统要求，三条都不难满足：

• macOS：13 或更新版本
• Linux：预编译包要求 GLIBC 2.35 起步（也就是 Ubuntu 22.04 及以上）
• Windows：10 / 11，x86_64 与 arm64 架构都提供

确认你的设备属于四种接入方式之一：Bolt 接收器、Unifying 接收器、蓝牙直连、有线。这四种都能被枚举，接收器方案还能顺带读到电池信息。

最快安装命令：装好 OpenLogi 并完成首次授权

如果你在用 macOS，一条命令就够了：

brew install --cask openlogi

也可以下载发布页的签名.dmg，把OpenLogi.app拖进/Applications。首次启动时系统会请求辅助功能与输入监控两项权限，直接允许——按钮重映射靠的就是输入钩子。

如果你在用 Windows，发布页有两种形式：按用户安装的.msi，或者免安装.zip。免安装包里是 GUI（OpenLogi.exe）和后台代理（openlogi-agent.exe）两个文件，所有设备 I/O 都在代理手里，所以两个文件必须放在同一目录，否则 GUI 无设备可连。

如果你在用 Linux，按发行版装对应包（x86_64 / arm64 均有）：

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

安装包会自动写入 udev 规则，让你无需 sudo 就能访问/dev/hidraw*和/dev/uinput。接下来启用属于你用户会话的后台代理：

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

NixOS 用户可以直接导入仓库模块，它连 udev 规则和代理服务一起托管，详见 Linux 安装文档；不想用包管理器的话，安装脚本 也能帮你把二进制、规则和服务单元一次铺好。

✅ 装完先验证。终端跑：

openlogi list

能看到设备的插槽、代号、类型和电池状态，就说明链路通了。Linux 上再打开 GUI 的设置 → 权限页，确认显示Granted；如果你的设备是在 udev 规则装好之前就插上的，重新插拔一次接收器，让规则在重连时生效。

鼠标按键重映射步骤：目标、操作、验证

下面每个场景都按「想达到什么 → 怎么做 → 怎么确认」来走。入口都在同一处：主窗口里进入设备详情，打开Buttons面板。

想让侧键一键回到桌面

目标：手指离开鼠标去翻桌面太麻烦，侧键按一下，所有窗口让开。

操作：在 Buttons 面板点选Back（多数鼠标的左侧键），从内置动作目录里挑ShowDesktop。动作目录里还有Copy、NewTab、LockScreen、Screenshot等几十个现成动作，不用敲任何键码。

验证：点按左侧键，桌面立刻露出来；再点一下恢复原来的窗口。

想让中键直接呼出一个应用

目标：中键的默认行为是滚屏粘贴，不如让它打开你每天要用的程序。

操作：选中MiddleClick，绑一个OpenApplication动作，填上要启动的应用路径，比如浏览器或终端。配置里长这样：

MiddleClick = { OpenApplication = { path = "~/Downloads", display_name = "Downloads" } }

验证：按住滚轮向下点（即中键），目标应用窗口被拉出来或打开。

想让同一个按钮区分短按和长按

目标：一个物理按键干两件事——轻点做轻的事，按住做重的。

操作：绑定写成{ short = ..., long = ... }两个动作。规则是：500 ms 内松开，触发short；按住满 500 ms，long恰好触发一次，之后的松开不会再补发short。仓库示例配置里就有这么一条，DPI 切换键轻点走桌面、长按进 Mission Control：

DpiToggle = { short = "ShowDesktop", long = "MissionControl" }

验证：快按一次、慢按一次，分别命中两个不同动作，且长按不会「双响」。

想让按钮随应用自动换动作

目标：同一个侧键在浏览器里翻历史，在别的程序里干别的。

操作：用per_app_bindings做按应用的覆盖层，按键名是各平台自己的应用标识（macOS 用 bundle id、Linux 用 application id、Windows 用可执行文件名或完整路径），GUI 的 Profile 选择器会直接列出你最近用过的应用。比如给某个 Windows 程序单独定义一条中键动作：

[devices."receiver:aabbccdd:slot:1".per_app_bindings."exe:sharex.exe"] MiddleClick = { CustomShortcut = "F1" }

验证：切到那个应用再按中键，动作跟着变。注意按应用覆盖目前覆盖 macOS 和 Windows；Linux 上仅限 X11 / XWayland 会话，纯 Wayland 下这条用不了。

另外两个顺手的动作可以记住：想要「按住不放、松手才停」的组合键（典型如语音开麦），用HoldShortcut——物理键不松开，组合键就一直按住，中途失效也会自动释放；CustomShortcut则是按一下立刻发完一组按键，用完即止。

进阶加料：DPI 预设、SmartShift 滚轮、Actions Ring 与 CLI

DPI 预设：在设备详情里设当前 DPI，再存一组预设，例如[800, 1600, 3200]。把任意按钮绑到CycleDpiPresets，按一下循环切一档，切分辨率不再依赖系统弹窗。

SmartShift 滚轮：支持棘轮 / 自由旋转两种模式切换、灵敏度调节，还有一块「常开棘轮」面板。滚轮手感直接写进设备（特性0x2111），不依赖任何第三方工具。

Actions Ring 动作环：给某个按钮绑ShowActionsRing，光标中央弹出一个 8 个插槽的环形动作盘，每个插槽可以是独立动作、应用启动或快捷键，还支持按应用换布局——重度键盘玩家可以把一整排快捷动作压缩进一次触发。

这些配置都汇聚在同一个 TOML 文件里：macOS / Linux 在~/.config/openlogi/config.toml，Windows 在%USERPROFILE%\.config\openlogi\config.toml。GUI 每次改动都原子写回，并滚动保留config.toml.backup.1到config.toml.backup.5共 5 份备份，改坏了有退路。DPI 与 SmartShift 的核心片段：

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

想动手前先看设备真实能力，CLI 就是干这个的，与 GUI 完全并列：

openlogi diag features # 列出设备报告的每个 HID++ 特性 openlogi diag controls # 列出可重编程控制键与能力标志

diag dpi和diag smartshift是「写→读回→还原」的冒烟测试，还能用diag lighting ff0000直接给支持 RGB 的有线键盘打纯色，全部命令见 CLI 用法。

常见问题自查：设备不出现、配置报错怎么办

现象：设备列表是空的。原因：Logi Options+（Linux 上是 Solaar）还没退，或接收器被别的程序占着。 处理：彻底退出官方工具，重启 OpenLogi，再跑一次openlogi list。

现象：Linux 上装不了输入钩子，或权限页显示 Not granted。原因：udev 规则未生效，或设备在规则安装前就已连接。 处理：装好 udev 规则 后重新插拔接收器（无线设备断电重连），再回权限页确认Granted，详见 Linux 安装文档。

现象：GUI 变成只读并弹红字。原因：TOML 写错了。OpenLogi 的 schema 是严格的，拼错、过期、超范围的字段会直接阻止加载而不是静默吃默认值，GUI 会精确标出错误位置。 处理：按提示改好文件，重启 GUI。5 份备份在config.toml.backup.1~5，需要时可以取回。

现象：Windows 上 GUI 打开了，但没有任何设备。原因：免安装版的两个可执行文件不在同一目录，GUI 找不到代理。 处理：把OpenLogi.exe和openlogi-agent.exe放进同一个文件夹再启动。

现象：按应用覆盖在我这台 Linux 机器上不生效。原因：你跑在纯 Wayland 会话里。 处理：按应用切换依赖 X11 的应用窗口探测，仅 X11 / XWayland 可用；全局绑定不受影响。

现象：想确认设备到底支持哪些特性。处理：openlogi diag features看特性清单，openlogi diag controls看可重编程控制键，比猜快得多。

到这里，从安装到第一次重映射的路已经走通。完整字段说明在 配置说明，可整体复制的测试示例在 config.example.toml，源码构建看 DEVELOPMENT.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