Wuji Hand
Wuji Glove
Wuji Studio
Wuji SDK设备管理
连接视图概览
启动 Wuji Studio 后进入连接视图（Connect View），这是管理设备的主界面。
连接视图由以下区域组成：
| 区域 | 说明 |
|---|---|
| Left sidebar | 连接历史记录 |
| Panel area header | 连接设备后显示操作按钮（如 Disconnect All） |
| Device list | 每张设备卡片由图标、设备信息和操作按钮组成，优先展示已连接和连接中的设备：
|
| Bottom action area | 连接设备后出现 Enter Visualization 按钮 |
发现与连接设备
应用自动扫描局域网内的 Wuji 设备（每 5 秒刷新一次），发现的设备以卡片形式展示在 Device list 中。
点击设备卡片上的 Connect 按钮即可建立连接。连接时，应用根据设备 SN 自动检测左右手信息并生成默认名称，无需手动命名。
启动 Wuji Studio 时，应用自动尝试恢复上次会话中已连接的设备，恢复期间状态栏显示进度提示。
Wuji Studio 最多支持同时连接 2 台设备。达到上限时继续连接新设备会弹出提示，需要先断开一台已连接设备。
断开设备
断开设备有以下方式：
- 点击设备卡片上的 Disconnect 按钮
- 点击 App bar 中间的设备名称 → 在命令面板中选择 Disconnect
- 点击 Panel area header 的 Disconnect All 按钮一键断开所有设备
使用设备命令面板
点击 App bar 中间的设备名称打开命令面板。连接多台设备时，会先弹出设备选择列表。
已连接设备可用的命令：
| 命令 | 说明 |
|---|---|
| Reconnect | 断开后重新连接设备 |
| Disconnect | 断开当前连接 |
| Rename Device | 重命名设备 |
| Device Info | 查看设备详细信息： 设备名称、序列号、固件版本、地址、传输类型和连接状态 |
点击已断开的设备时，直接弹出名称输入框，输入名称后自动连接。
查看连接历史
Left sidebar 保存最近 5 条连接记录。
点击 Reconnect All 恢复连接——当前网络发现历史设备且处于离线状态时，该按钮可用。
历史记录支持单条删除和全部清空。
设备命名
自动命名
首次连接设备时，Wuji Studio 根据设备序列号自动检测左右手信息并生成默认名称：
| 检测结果 | 默认名称 |
|---|---|
| 左手 | left_glove |
| 右手 | right_glove |
| 手套（未知左右手） | wuji_glove |
| 其他设备 | wuji_device |
重命名设备
- 点击 App bar 中的设备名称打开命令面板。
- 选择 Rename Device。
- 输入新名称并确认。
重命名已连接设备后，应用自动断开并使用新名称重新连接。Topic 路径随之更新（例如 /left_glove/sensor/tactile 变为 /my_device/sensor/tactile）。
命名规则
设备名称遵循 ROS 命名规范：
- 必须以字母开头（a–z、A–Z）
- 仅允许字母、数字（0–9）和下划线（
_） - 最多 50 个字符