用途:wuji-cli-viz 通过 wuji viz 命令启动官方 Rerun Web Viewer,实时可视化 Wuji Hand 2 或 Wuji Glove 的手部数据,用于检查手部姿态、逐 taxel 触觉等信息。
主要能力:支持 Wuji Hand 2 与 Wuji Glove。Hand 2 显示实时手部姿态,若硬件具备触觉能力则显示触觉视图与力历史,包括 3D 手模型、逐 taxel 力箭头、每指合力箭头、五个指尖 3D 面板及 60 秒滚动合力幅值曲线;无触觉硬件时仅显示关节姿态并隐藏触觉面板。Glove 显示实时手部与传感器可视化。命令打印 Viewer URL 并默认用浏览器打开,会话与 Viewer 持续运行直到停止。
使用方式:直接运行 wuji viz 会同时扫描两类设备,仅在恰好发现一个受支持设备时连接;交互终端中多设备会打开可搜索选择器,所选设备才连接。用 wuji viz --sn <SN> 指定设备;结构化输出与无人值守调用在存在多个受支持设备时必须提供 --sn。在无图形界面的主机上或用户要求手动打开 URL 时用 --no-open。需要机器可读启动报告时用 --json 或 --jsonl。默认仅回环绑定;用户明确需要远程浏览器且网络可信时才加 --lan 或 --bind <local-IP>。
触觉置零:仅对带触觉硬件的 Hand 2 生效,--no-zero 用于阻止置零。Glove 与已确认无触觉硬件的 Hand 2 跳过此操作。CLI 实际执行置零时,须保持五个指尖无负载,直到终端打印 Tactile zero: ready.。
适用场景:本地检查手部姿态与触觉数据、可信局域网内远程查看、Agent 管理的会话启动。
限制:仅支持实时数据,不录制 RRD,也不加载或回放 MCAP/RRD 文件;不接受 --address 或 --handedness 作为设备选择器;每个 wuji viz 会话仅支持一个活动 Viewer 页面;非回环访问无认证、无 TLS;断开连接后 Viewer 保留最后状态且不自动重连;若已安装的 wuji 二进制或受支持设备不可用,会报告具体阻塞原因而不会声称已启动。其余细节(如具体版本、平台要求)暂未提供。