前置条件
- Ubuntu 22.04 LTS 及以上版本
- 设备与主机在同一局域网(UDP),或通过 USB 连接
用安装脚本一键安装(推荐):
也可以从 Releases 下载最新二进制文件后手动安装:
运行 wuji devices,确认能发现设备:
列表为空时,检查设备是否上电、与主机是否在同一网段。
更新 CLI
wuji update --check 输出当前版本、最新版本和 skills 状态,有更新时附上最新版本的更新日志。
wuji update 安装最新版本,并同步已安装的 skills。安装 CLI 时跳过 skills 的机器,可用 wuji update --skills 单独安装。
wuji update --skills 把 skills 同步到当前 CLI 版本。
CLI 也会在后台检查新版本(每 24 小时至多一次),有可用更新时在命令输出末尾提示,不会阻塞或减慢命令。设置环境变量 WUJI_NO_UPDATE_CHECK=1 可关闭提示。
配置 shell 补全(可选)
配置后,在终端输入 wuji 命令时按 Tab 自动补全子命令与参数,不必记忆完整拼写。以 bash 为例:
zsh、fish、powershell 和 elvish 替换命令中的 shell 名称即可,详见 wuji completions --help。
安装 AI skills(可选)
为 Claude Code 等 AI 编程助手安装 Wuji CLI skills,让 AI Agent 直接操作设备:
也可以用安装脚本:
安装后可用的 skills:
AI Agent 可直接读写参数并控制设备。让它执行前先确认操作,尤其是写参数、固件升级等改变设备状态的动作,避免误操作损坏设备。