WASI 0.3.1 深入解读：从WebAssembly系统接口到沙箱实践
2026/8/31 11:02:58
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）罗技设备管理工具，作为 Logi Options+ 的原生替代品：无需账号、无遥测，直接通过 HID++ 与 UVC 协议解锁罗技鼠标、键盘和摄像头的完整能力。本文是一份功能支持矩阵速查表，帮你快速判断：DPI 预设、SmartShift 滚轮、按键重映射、RGB 背光、摄像头硬件参数这些特性，OpenLogi 到底覆盖到什么程度，你的设备能否直接用上。
先搞懂：连接支持决定功能上限 📡
OpenLogi 能"完整覆盖"某个特性，前提是设备先被正确识别。它目前支持的连接方式包括：
| 连接方式 | 说明 | 覆盖状态 |
|---|---|---|
| Logi Bolt 接收器 | PID0xC548，Bolt 配对流程 | ✅ 完整 |
| Unifying 接收器 | PID0xC52B/0xC532，HID++ 1.0 协议 | ✅ 完整 |
| Lightspeed / Nano 接收器 | G502、G604、G305、G915、G PRO X 等系列接收器（含0xC537、0xC539、0xC53F、0xC547、0xC54D） | ✅ 完整（经实机验证） |
| 蓝牙直连 | 设备直连电脑 | ✅ 完整 |
| 有线 USB | 直接插拔 | ✅ 完整 |
所有接收器与设备身份定义集中在 crates/openlogi-device-registry/src/receiver.rs，新增型号只需在此登记，这也是判断"某款罗技设备是否受支持"的最快入口。
鼠标特性支持矩阵 🖱️
鼠标是 OpenLogi 覆盖最深的品类，核心能力均直写硬件：
| 特性 | HID++ 特性 ID | 覆盖状态 |
|---|---|---|
| DPI 预设与切换（Cycle / Set-preset 动作） | 0x2201AdjustableDpi、0x2202ExtendedAdjustableDpi | ✅ 完整 |
| SmartShift 滚轮：模式开关、灵敏度、永久棘轮面板 | 0x2110、0x2111SmartShiftEnhanced | ✅ 完整 |
| 每设备滚动方向反转 | 0x2121HiResWheel | ✅ 支持设备完整 |
| 拇指滚轮（Thumbwheel） | 0x2150 | ✅ 完整，含平滑滚动 |
| 中键 / Mode Shift / 拇指滚轮按键捕获与重映射 | 0x1b00~0x1b04ReprogControls | ✅ 完整 |
| 任意按键手势绑定（Gestures2，按方向分别绑定） | 0x6501 | ✅ 完整 |
| 电池电量与充电状态 | 0x1000/0x1001/0x1004 | ✅ 完整 |
| Actions Ring 八格动作环（含按应用切换布局） | 内置动作目录 | ✅ 完整 |
| 每应用配置文件覆盖（随焦点自动切换） | OS 输入钩子 | ✅ 完整（Linux 仅 X11/XWayland） |
💡 小技巧：中键还支持"按住不放"的 push-to-talk 和"短按/长按"分离动作，配置见 docs/config.example.toml 中的
short/long语法。
所有可识别的 HID++ 特性都在特征注册表里逐条登记，包括尚未实现但已知的特性（如0x19c0ForceSensingButton 有意未实现），可直接查 crates/openlogi-hidpp/src/feature/registry.rs 对照你的设备能力。
键盘特性支持矩阵 ⌨️
| 特性 | HID++ 特性 ID | 覆盖状态 |
|---|---|---|
| 全局 F 键重映射（输入文本、快捷键组合、多步工作流） | 0x1c00PersistentRemappableAction + OS 钩子 | ✅ 完整（macOS + Windows） |
| 静态 RGB 灯效 / 单键背光 | 0x8070ColorLedEffects、0x8071RgbEffects、0x8081PerKeyLighting2 | ✅ 支持设备完整 |
| Fn 键反转 | 0x40a2/0x40a3 | ✅ 完整 |
| 多设备切换主机（Change Host） | 0x1814 | ✅ 完整 |
| 太阳能键盘仪表盘 | 0x4301SolarDashboard | ✅ 完整 |
| 禁用 Windows 键等按键 | 0x4521DisableKeys、0x4522DisableKeysByUsage | ✅ 完整 |
| 键盘背光亮度 | 0x1982Backlight2 | ✅ 完整 |
| 多媒体音量 / 侧音 / 均衡器（G 系列耳机） | 0x8300Sidetone、0x8310Equalizer | ✅ 完整 |
⚠️ 注意：按应用自动切换绑定依赖系统前台应用检测，Linux 上仅在 X11 / XWayland 会话生效。
摄像头（UVC）支持矩阵 📷
OpenLogi 对所有标准 UVC 罗技摄像头（Brio、StreamCam、C920 系列等）即插即用，参数直接写入 UVC 硬件，因此在 Meet、Zoom、OBS 等任何调用摄像头的应用里都生效：
- ✅ 图像参数直写硬件：变焦、对焦、曝光、亮度、对比度、饱和度、锐度、白平衡、色调、防频闪、低光补偿
- ✅ 对焦 / 曝光 / 白平衡的自动模式开关
- ✅ 一键预设：内置 Default / Streaming / Video call，外加自定义快照，且按摄像头持久化
- ✅ 隐私控制：离开预览页即完全释放摄像头，指示灯熄灭
实现位于 crates/openlogi-camera/src/controls.rs，跨平台捕获在 crates/openlogi-camera/src/capture.rs。
Litra 灯与其余外设 💡
- Litra Glow / Litra Beam：电源、亮度、色温完整支持，可选"跟随摄像头活动自动开关"，身份定义见 crates/openlogi-device-registry/src/litra.rs。
一分钟自查：你的设备能用哪些功能？ ✅
- 查连接：你的接收器/设备类型是否在上表"连接支持"中；
- 查特性 ID：用 CLI 列出设备，
openlogi list可读取运行中 agent 的设备清单，完整命令见 docs/USAGE.md； - 查配置：所有已启用特性都落在一个纯文本 TOML 文件中，可自由同步多机，完整字段说明见 docs/CONFIGURATION.md 与示例 docs/config.example.toml。
📌 使用前提：先退出 Logi Options+。两者会争抢 HID++ 通道，同一接收器同一时间只能被一个应用占用。
常见问题 FAQ
问：我的 G 系列游戏鼠标能重映射按键吗？能。G502、G604、G305、G915、PRO X SUPERLIGHT 2 等 Lightspeed/Nano 接收器均已登记，按键重映射通过 ReprogControls 特性走硬件，游戏场景同样适用。
问：不联网、不登录，功能会缩水吗？不会。OpenLogi 是本地优先设计：GUI、CLI、后台 agent 全部在本机运行，无账号无遥测，配置文件就是一个 TOML 文件。
问：项目文档在哪里看？官方文档入口：docs/README.zh-CN.md（中文版）、docs/INSTALL-linux.md（Linux 安装与权限）、docs/DEVELOPMENT.md（源码构建）。
OpenLogi 支持矩阵的核心结论：鼠标（DPI / SmartShift / 按键 / 手势）、键盘（F 键 / RGB / Fn 反转 / 多主机）、摄像头（全量 UVC 参数）三大品类的关键特性都已完整覆盖，且覆盖范围以源码注册表为准、持续扩张中。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考