快速开始
前置条件
- Ubuntu 22.04 及以上版本
- 设备与主机在同一局域网（UDP），或通过 USB 连接
安装
用安装脚本一键安装（推荐）：
curl -fsSL https://get.wuji.tech/cli | bash也可以从 Releases 下载最新二进制文件后手动安装：
sudo cp wuji_<version>_<arch> /usr/local/bin/wuji验证
运行 wuji devices，确认能发现设备：
$ wuji devices
found 1 device(s)
┌──────────────────┬───────────┬──────────┬─────────────────────┬─────────────────────┐
│ SN ┆ Transport ┆ USB Port ┆ IP ┆ Address │
╞══════════════════╪═══════════╪══════════╪═════════════════════╪═════════════════════╡
│ WG1KXXXXXXXXXXX ┆ Udp ┆ - ┆ 192.168.1.100:50001 ┆ 192.168.1.100:50001 │
└──────────────────┴───────────┴──────────┴─────────────────────┴─────────────────────┘
💡 run `wuji ping` to get device type and firmware version列表为空时，检查设备是否上电、与主机是否在同一网段。
更新 CLI
wuji update # 下载并安装最新版本
wuji update --check # 只检查更新，不安装CLI 也会在后台检查新版本（每 24 小时至多一次），有可用更新时在命令输出末尾提示，不会阻塞或拖慢命令。设置环境变量 WUJI_NO_UPDATE_CHECK=1 可关闭提示。
配置 shell 补全（可选）
配置后，在终端输入 wuji 命令时按 Tab 自动补全子命令与参数，不必记忆完整拼写。以 bash 为例：
mkdir -p ~/.local/share/bash-completion/completions
wuji completions bash > ~/.local/share/bash-completion/completions/wuji
exec bash # 当前会话立即生效zsh、fish、powershell 和 elvish 替换命令中的 shell 名称即可，详见 wuji completions --help。
安装 AI skills（可选）
为 Claude Code 等 AI 编程助手安装 Wuji CLI skills，让 AI Agent 直接操作设备：
npx skills add wuji-technology/wuji-cli也可以用安装脚本：
curl -fsSL https://get.wuji.tech/skills | bashAI Agent 可直接读写参数并控制设备。让它执行前先确认操作，尤其是写参数、固件升级等改变设备状态的动作，避免误操作损坏设备。