文档阅读指引

版本发布记录

Wuji CLI 各版本更新内容与变更说明

产品介绍

Wuji CLI 的定位、命令一览与设计理念

• 命令一览
  全部命令与作用速查
• 设计理念
  无状态、占用只读降级与可脚本化退出码
• 输出模式
  --json 与 --jsonl 结构化输出的适用场景

快速开始

安装与更新 CLI、验证设备连接与配置 shell 补全

• 前置条件
  确认系统版本与设备连接方式
• 安装
  用安装脚本或二进制文件安装 CLI
• 验证
  运行 wuji devices 确认能发现设备
• 更新 CLI
  用 wuji update 自更新，被动检查可关闭
• 配置 shell 补全（可选）
  生成 bash 等 shell 的自动补全脚本
• 安装 AI skills（可选）
  为 AI 编程助手安装 Wuji CLI skills

设备管理

扫描设备、探测连通性与指定目标设备

• 扫描设备
  列出 USB 和 UDP 总线上的全部设备
• 探测连通性
  握手确认设备可用并报告固件版本
• 指定目标设备
  按序列号、地址或手性选择设备
• 设备被占用时的行为
  了解只读回退与写操作限制
• 常见提示与处理
  速查常见提示消息的含义与处理

参数读写

发现设备资源，读取与写入参数

• 发现资源
  列出设备的可读写参数与可订阅 topic
• 读取参数
  用 get 读取参数并自动解码为 JSON
• 写入参数
  用 set 写入 JSON 值或十六进制字节
• 注意事项
  网络参数生效时机与虚拟参数行为

数据订阅

订阅实时数据流并采集到文件

• 订阅 topic
  订阅实时数据并控制接收帧数
• 采集数据到文件
  用 --jsonl 配合管道轻量录制数据

健康诊断

逐项体检设备，定位 EMF 断线与触觉坏点故障

• 检测范围
  了解支持的设备与故障类型
• 用法
  诊断全部或指定设备的常用命令
• 读懂报告
  理解状态标记、修复建议与退出码
• 展开全部检查项
  用 -v 查看包含通过项的完整清单
• 结构化输出
  用 --json 保存含原始指标的完整结果

固件升级

检查固件更新，批量升级设备或安装指定版本

• 范围与动作
  范围选设备、动作选版本的组合模型
• 用法
  常用升级与查询命令速查
• 读懂报告
  理解逐台状态与退出码语义
• 示例
  更新概览、批量升级与降级标注
• 结构化输出
  --json 报告与 --yes 的配合