CLI 概览

Wuji CLI 是面向终端、脚本和 AI Agent 的 Wuji 设备命令行工具。不离开终端即可扫描设备、探测连通性、读写参数、订阅实时数据、标定触觉、运行健康诊断和升级固件。

命令一览

在任意命令后加 --help 查看详细帮助。

所有命令默认以表格或树形报告输出。附加全局参数可切换为结构化输出：

参数	输出形式	适用场景
`--json`	格式化 JSON	脚本解析、AI Agent 读取
`--jsonl`	每帧一行紧凑 JSON	流数据采集、管道处理

--json / --jsonl 下，命令错误以固定结构的 JSON 输出到 stderr，stdout 只输出数据。该 JSON 对象含 message（完整错误链）与 argv（本次调用的原始参数数组）：

{
  "error": {
    "argv": ["wuji", "get", "...", "--json"],
    "message": "..."
  }
}

参数解析错误同样输出该结构，退出码为 2。脚本判断成败以退出码为准（0 成功，非 0 失败），不要靠解析 stdout 判断：

wuji get <path> --json 2>&1 | jq .error.message   # 合并 stderr 后提取错误信息
wuji get <path> --json 2>/dev/null                # 丢弃错误输出，stdout 保持纯净

wuji user 和 wuji calib hand-model 的错误自带 code 字段与分档退出码，且输出到 stdout 而非 stderr，与通用错误结构不同，见各自命令页的「自动化调用」。