> ## 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.

# Studio 迁移指南

> 从 Studio 导出数据并导入 CLI 的必要步骤，以及功能、命令与文档对照。

Wuji Studio 自 2026-09-14 起停止维护，最后版本为 v2026.9.14。此后 Studio 不再提供功能更新或设备支持。设备发现、可视化、标定和固件升级改用 [Wuji CLI](/docs/wuji-cli) 或 [Wuji SDK](/docs/wuji-sdk)。

迁移需要 Wuji CLI v2026.9.14 及以上版本。安装与更新方式见[快速开始](/docs/wuji-cli/getting-started)。

## 迁移数据

* **先从 Studio 导出数据。** 在桌面版 Studio 中切换到需要迁移的具名用户档案（非 Default），点击用户头像 → **User data** → **Export Data…**，保存导出的 ZIP 文件。

* **把 ZIP 放到使用 CLI 的电脑上。** 换电脑时复制导出的文件。在同一台电脑上迁移时，直接使用原文件。CLI 未安装时，先按[安装说明](https://github.com/wuji-technology/wuji-cli#installation)安装。

* **在 CLI 中预览并导入。**<br />`wuji user import <ZIP文件路径> --as <新用户名>`<br />替换为实际文件路径和一个未使用的用户名。命令会先展示预览，确认后将数据导入新档案。

* **查看导入结果。** 运行 `wuji user show` 查看用户和标定数据。有跳过或缺失项时，按[用户与标定数据文档](/docs/wuji-cli/user)处理。

详细操作见 [Studio 数据导出](/docs/wuji-studio/basic-settings#导出与导入数据)和[CLI 数据导入](/docs/wuji-cli/user)。录制文件的处理见[录制文件](#录制文件)。

## 功能对照

| Studio 功能 | CLI 命令 | CLI 文档 |
| - | - | - |
| 扫描设备与查看信息 | `wuji devices` / `wuji ping` | [设备管理](/docs/wuji-cli/device-management) |
| 读写设备参数 | `wuji resources` / `wuji get` / `wuji set` | [参数读写](/docs/wuji-cli/parameters) |
| 用户档案与标定数据 | `wuji user` | [用户与标定数据](/docs/wuji-cli/user) |
| 手部模型标定 | `wuji calib hand-model` | [手部模型标定](/docs/wuji-cli/hand-model-calibration) |
| 触觉接触标定 | `wuji calib tactile` | [触觉标定](/docs/wuji-cli/tactile-calibration) |
| 查看实时数据 | `wuji sub` | [数据订阅](/docs/wuji-cli/subscription) |
| 手部可视化 | `wuji viz` | [实时可视化](/docs/wuji-cli/visualization) |
| 采集数据到文件 | `wuji sub <topic> --jsonl` | [数据订阅](/docs/wuji-cli/subscription) |
| 数据录制（MCAP 文件） | `wuji record teleop`（目前仅支持遥操作场景） | [遥操作录制](/docs/wuji-cli/recording) |
| 固件升级 | `wuji upgrade` | [固件升级](/docs/wuji-cli/firmware-upgrade) |
| 查看与导出日志 | `wuji logs` | [日志导出](/docs/wuji-cli/logs) |
| 应用内更新 | `wuji update` | [快速开始](/docs/wuji-cli/getting-started) |

CLI 还提供 `wuji doctor`，用于检查主机环境、设备连接和支持的设备故障。详见[健康诊断](/docs/wuji-cli/doctor)。

## 已安装的 Studio

已安装的 Wuji Studio 可以继续打开，现有功能照常使用，只是不再收到更新。用户档案与标定数据仍可按[迁移数据](#迁移数据)导出并导入 CLI。

## 录制文件

MCAP 录制文件不在用户数据 ZIP 中。Studio 的录制文件默认保存在 `Documents/WujiStudio/recordings/`，在 Studio 设置中改过保存路径时以实际目录为准。需要保留时，从该目录单独复制。详见 [Studio 数据录制](/docs/wuji-studio/visualization/recording)。

CLI 目前仅支持录制运行中的 Wuji Glove → Wuji Hand 2 遥操作会话。先启动遥操作程序，再运行 `wuji record teleop` 录制固定的遥操作通道组合。

CLI 侧的遥操作录制保存在 `~/.wuji/recordings/<RUN_ID>/`。运行 `wuji record list` 查看录制历史，用 `wuji logs export --recording <RUN_ID>` 将指定录制打包进支持包。详见[遥操作录制](/docs/wuji-cli/recording)和[日志导出](/docs/wuji-cli/logs)。


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