> ## 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-22 起停止维护，最后版本为 v2026.9.22。此后 Studio 不再提供功能更新或设备支持。设备发现、可视化、标定和固件升级改用 [Wuji CLI](/docs/wuji-cli/) 或 [Wuji SDK](/docs/wuji-sdk/)。

迁移需要 Wuji CLI v2026.9.22 及以上版本。安装与更新方式见[快速开始](/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 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 暂不提供数据录制。


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