连接设备

OpenLogi 通过三种方式与 Logitech HID++ 设备通信：

• 接收器 —— Logi Bolt、Unifying 或 Lightspeed USB 接收器；OpenLogi 会发现接收器并列出所有已配对设备。已识别的接收器型号见接收器。
• 蓝牙直连 —— 设备直接通过蓝牙与电脑配对，无需接收器。
• 有线 —— 设备通过 USB 连接。

并非所有设备都说 HID++：Litra 补光灯走原始 HID，罗技摄像头走 USB Video Class，两者同样出现在设备库中，见 Litra 补光灯与摄像头。

验证连接

打开 GUI。设备会出现在首页设备库中，在线设备还会显示电量百分比与充电状态。默认使用响应式网格；可用 视图按钮在网格、列表与轮播布局之间切换，所选布局会被保存。

每张设备卡片的菜单都可设置自定义显示名称。删除设备仅对已保存的离线设备可用；它会删除保存的 设备记录、自定义名称与该设备的设置，但不会解除硬件与接收器的配对。

在 CLI 中运行 openlogi list。它会优先读取兼容且正在运行的代理快照，也就是 GUI 使用的同一份 HID 清单。如果代理不可达、超时或协议版本不兼容，命令会在 stderr 说明原因，并回退为直接枚举硬件。 这种回退以及 openlogi diag 硬件诊断命令使用的是 CLI 自己的设备访问权限，而不是代理的权限；因此 直接访问成功并不能证明代理也能打开该设备。

如果设备未出现，请确认 Logi Options+ 已完全退出（包括其后台代理），以免它占用接收器。在 Linux 上，请退出 Solaar，并检查 GUI 的 设置 → 权限 页面：访问 /dev/hidraw* 需要已安装 udev 规则（参见安装）。

配对新设备

GUI 的添加设备流程支持 Bolt 与 Unifying 接收器：

• **Bolt：**发现流程会列出附近可配对的设备。选择一个设备后开始通行码交换；对鼠标而言，是一小段 左右键点击序列。
• **Unifying：**OpenLogi 会打开接收器的配对锁。开启附近一个尚未配对的设备即可连接，无发现列表， 也无需通行码。

Lightspeed 接收器可以被枚举与驱动，但尚未实现向其配对新设备；请使用罗技的配对工具。