OpenLogiEasy-Switch
查看兼容 Logitech 设备的 Easy-Switch 通道，并重命名已配对的电脑或让键盘带动指点设备切换。
Easy-Switch 设备会在编号通道中保存已配对的电脑。选择设备后，打开设备（Device）标签页。Easy-Switch 卡片会读取设备的 HID++ 0x1815 主机信息。
OpenLogi v0.8.14 新增了这张卡片。只有设备上报 Easy-Switch 通道时，才会显示这张卡片。
通道详情
每一行对应设备上报的一个通道。它会标明通道，当前通道还会显示本机（This computer）。
| 通道状态 | 卡片内容 |
|---|---|
| 当前通道 | 本机，以及可用的已配对电脑详情 |
| 已配对通道 | 电脑名称，或 未命名的电脑；操作系统；以及连接方式 |
| 未配对通道 | 未配对电脑 |
连接方式可能是蓝牙（Bluetooth）、Unifying 接收器（Unifying receiver）、Bolt 接收器（Bolt receiver）或 USB。设备提供名称、操作系统、连接方式和通道状态。
重命名已配对的电脑
只有设备支持软件重命名且通道已配对时，卡片才显示重命名（Rename）。对话框会预填设备上报的名称，并显示电脑名称（Computer name）字段。
OpenLogi 会去除首尾空白。名称不能为空。其 UTF-8 字节数不能超过通道的 name_max_len。
限制按字节而不是字符计算。设备会保存接受的名称。设备不允许软件重命名时，不显示重命名控件。
卡片可能显示以下消息：
| 情况 | 消息 |
|---|---|
| 名称为空 | 请输入名称。 |
| 名称超过字节限制 | 太长：%{used}/%{max} 字节。 |
| 设备未返回请求的名称 | 设备未保留通道 %{channel} 的新名称。 |
| 其他重命名失败 | 无法重命名通道 %{channel} 上的电脑，请重试。 |
OpenLogi 不会自行把本机名称或操作系统写入通道。这与 Logi Options+ 不同，后者会把这些值写入当前通道。
使用 Automation API
使用 openlogi api easy-switch 读取或重命名通道：
openlogi api easy-switch --device "$DEVICE_ID"
openlogi api easy-switch --device "$DEVICE_ID" --channel 2 --name "Work laptop"这两个命令都需要运行中的兼容 OpenLogi 代理。读取结果包含从 1 开始的通道号、设备上报的当前通道、名称、操作系统、连接方式和 name_max_len。
重命名必须同时提供 --channel 与 --name。CLI 会去除首尾空白，不会写入 config.toml，并拒绝 --save。
让目标设备跟随键盘
在 config.toml 中设置 host_switch_targets。OpenLogi v0.8.15 没有这个关系的 GUI 编辑器。
把物理设备键写在键盘的条目中。在每台可由这块键盘发起切换的电脑上配置一次。
schema_version = 9
[devices."receiver:aabbccdd:slot:2"]
host_switch_targets = ["receiver:aabbccdd:slot:1"]配置的键盘在线时，代理会观察可用的主机控制项。按下主机键后，代理会验证键盘请求的通道，按列表顺序尝试目标设备，最后切换键盘。
目标设备不可用或无法切换主机时，键盘仍会切换。每台需要移动的设备都需要 0x1814 changeHost。可用时，代理会通过 0x1815 hostsInfo 拒绝设备明确上报为空的通道。
**状态：**此功能适用于 macOS、Linux 和 Windows 上兼容的 HID++ 设备。读取通道和重命名使用 0x1815 hostsInfo。主机切换使用 0x1814 changeHost。