> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

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

## 前置条件

* Ubuntu 22.04 LTS 及以上版本
* 设备与主机在同一局域网（UDP），或通过 USB 连接

## 安装

用安装脚本一键安装（推荐）：

```bash theme={null}
curl -fsSL https://get.wuji.tech/cli | bash
```

也可以从 [Releases](https://github.com/wuji-technology/wuji-cli/releases) 下载最新二进制文件后手动安装：

```bash theme={null}
sudo cp wuji_<version>_<arch> /usr/local/bin/wuji
```

## 验证

运行 `wuji devices`，确认能发现设备：

```bash theme={null}
$ 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

```bash theme={null}
wuji update           # 下载并安装最新版本
wuji update --check   # 只检查更新，不安装
wuji update --skills  # 只同步 Wuji CLI skills，不更新二进制
```

`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 为例：

```bash theme={null}
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 直接操作设备：

```bash theme={null}
npx --yes skills add wuji-technology/wuji-cli -g
```

也可以用安装脚本：

```bash theme={null}
curl -fsSL https://get.wuji.tech/skills | bash
```

安装后可用的 skills：

| Skill | 用途 |
| - | - |
| `wuji-cli-base` | 扫描设备、握手测试、读写参数、订阅实时数据 |
| `wuji-cli-calib` | 引导 Wuji Glove 手部模型标定与触觉标定 |
| `wuji-cli-doctor` | 设备健康自检，定位 EMF 断连与触觉传感器坏点 |
| `wuji-cli-logs` | 导出、查看和定位设备日志，生成支持包 |
| `wuji-cli-support` | 引导排障并生成故障报告，发送 [support@wuji.tech](mailto:support@wuji.tech) |
| `wuji-cli-upgrade` | 检查固件更新，升级、回退或刷写指定固件 |
| `wuji-cli-user` | 管理 SDK 用户配置，导入导出标定数据 |
| `wuji-cli-viz` | 用 Rerun 可视化实时手部姿态与触觉数据 |

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.