跳转到主要内容

​
前置条件

  • Linux：Ubuntu 20.04 LTS 及以上版本，x86_64 或 arm64
  • 设备与主机在同一局域网（UDP），或通过 USB 连接

​
安装

Linux（含 WSL）推荐使用安装脚本：
Linux
也可以从 Releases 下载 Linux 发行包：x86_64-unknown-linux-gnu 或 aarch64-unknown-linux-gnu。解压后，将 wuji 放入 PATH 中的目录。

​
验证

运行 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 可直接读写参数并控制设备。让它执行前先确认操作，尤其是写参数、固件升级等改变设备状态的动作，避免误操作损坏设备。