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

# 阅读指引

> [card]
>
> 开发工具 · 产品文档
> Wuji SDK

## 推荐阅读路径

按阶段阅读，覆盖安装、连接、数据流、录制、设备管理和 C 接口。

**1. 安装与首次运行**

先安装 SDK，再运行第一个示例。

* [产品介绍](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/introduction.md) — 支持的设备、接口语言和 SDK 能力
* [安装与环境](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/quick-start.md) — 系统要求、Python 安装、C 安装和安装验证
  * [系统要求](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/quick-start.md#系统要求)
  * [安装 Python SDK](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/quick-start.md#安装-python-sdk)
  * [安装 C SDK](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/quick-start.md#安装-c-sdk)
* [Docker 部署](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/docker-deployment.md) — 镜像构建、宿主网络、数据挂载和恢复

**2. 连接设备**

使用同一个 SDK 管理器发现、连接和管理 Wuji 设备。

* [设备发现与连接](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-connection.md) — 自动连接、按 SN、地址、USB 或手性连接
  * [自动连接](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-connection.md#自动连接)
  * [指定 SN 连接](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-connection.md#指定-sn-连接)
  * [指定地址连接](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-connection.md#指定地址连接)
  * [按 USB 连接](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-connection.md#按-usb-连接)
  * [按手性连接](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-connection.md#按手性连接)
  * [多设备管理](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-connection.md#多设备管理)

**3. 订阅并理解数据**

先理解订阅模式，再查看各产品数据流、时间戳和坐标变换。

* [数据订阅机制](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-subscription.md) — 异步、同步非阻塞、回调、输出率和跨设备合并订阅
  * [订阅模式](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-subscription.md#订阅模式)
  * [调节订阅流输出率](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-subscription.md#调节订阅流输出率)
  * [跨设备合并订阅](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-subscription.md#跨设备合并订阅)
  * [可用数据流](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-subscription.md#可用数据流)
* [Wuji Hand 2 指尖触觉](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/wuji-hand-2-tactile.md) — 触觉数据格式、标定和离线处理
* [通用数据类型](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-reference.md) — Frame、姿态、惯性和录制类型
* [时间同步与坐标变换](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/time-sync.md) — 时间戳语义、自动同步和手动同步

**4. 录制数据**

将多路同步数据录制为 MCAP，并检查录制质量。

* [数据录制](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-recording.md) — 压缩、时间戳、全局资源、Episode、监控和示例
  * [录制监控](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-recording.md#录制监控)
    * [质量告警](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-recording.md#质量告警)
  * [示例](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-recording.md#示例)

**5. 标定与设备管理**

管理设备参数、SDK 用户和标定数据。

* [设备参数与用户数据](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-params.md) — 参数读写、用户隔离、导入导出和标定
  * [参数读取](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-params.md#参数读取)
  * [SDK 用户管理](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-params.md#sdk-用户管理)
  * [用户数据导入导出](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-params.md#用户数据导入导出)
  * [标定](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-params.md#标定)

**6. 进阶与参考**

根据产品和集成场景深入使用 SDK。

* [手部重定向](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/retargeting.md) — 将 21 个手部关键点映射为 20 维关节角度
* [工程实践](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/advanced.md) — 错误处理、重连、多设备和日志
* [故障排查](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/troubleshooting.md) — 安装、运行、版本兼容和日志问题
* [C 接口参考](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/c-sdk-reference.md) — C 接口、错误码、约定和 Python 对照
* [附录](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/appendix.md) — 术语、错误码、异常类型和版本兼容

## 本版全部文档

> [card] [发布记录](https://docs.wuji.tech/docs/zh/release-notes.md)
>
> Wuji SDK 各版本更新内容与变更说明

> [card] [产品介绍](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/introduction.md)
>
> 支持设备、接口语言和 SDK 能力

> [card] [安装与环境](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/quick-start.md)
>
> Python 与 C 的系统要求、安装和验证

> [card] [Docker 部署](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/docker-deployment.md)
>
> 容器构建、设备访问和数据持久化

> [card] [设备发现与连接](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-connection.md)
>
> 发现、连接和管理 Wuji 设备

> [card] [数据订阅](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-subscription.md)
>
> 订阅、合并和调节设备数据流

> [card] [Wuji Hand 2 指尖触觉](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/wuji-hand-2-tactile.md)
>
> 触觉格式、标定和离线处理

> [card] [数据录制](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-recording.md)
>
> 录制多通道数据到 MCAP

> [card] [通用数据类型](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/data-reference.md)
>
> Frame、姿态、惯性和录制类型

> [card] [设备参数与用户数据](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/device-params.md)
>
> 参数读写、用户隔离、导入导出和标定

> [card] [时间同步](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/time-sync.md)
>
> 时间戳语义、自动同步和手动同步

> [card] [手部重定向](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/retargeting.md)
>
> 手部关键点到关节角度的映射

> [card] [SDK 使用实践](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/sdk-practice/index.md)
>
> 重定向、用户管理和指尖触觉示例

> [card] [工程实践](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/advanced.md)
>
> 错误处理、重连、多设备和日志

> [card] [故障排查](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/troubleshooting.md)
>
> 安装、运行、版本兼容和日志问题

> [card] [C 接口参考](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/c-sdk-reference.md)
>
> C 接口、错误码和 Python 对照

> [card] [附录](https://docs.wuji.tech/docs/zh/wuji-sdk/latest/appendix.md)
>
> 术语、错误码、异常类型和版本兼容


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