> ## 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 SDK · 阅读指引

> Python 与 C SDK。

<Card img="https://mintcdn.com/wuji-0bbde051/32vMaCBOgjCFMkOf/assets/covers/cover-sdk-live-blank.png?fit=max&auto=format&n=32vMaCBOgjCFMkOf&q=85&s=bd6e4c28fd7b0734d3a517ffc796e596" className="wj-media wj-cover" width="1536" height="486" data-path="assets/covers/cover-sdk-live-blank.png">
  <span className="wj-eyebrow">开发工具 · 产品文档</span>
  <span className="wj-hero-name">Wuji SDK</span>
  <span className="wj-hero-tag">Python 与 C SDK。</span>
  <span className="wj-hero-specs"><Badge>v2026.8.31</Badge> <Badge>C / Python</Badge></span>
</Card>

## 推荐阅读路径

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

<Steps>
  <Step title="安装与首次运行">
    先安装 SDK，再运行第一个示例。

    * [产品介绍](/docs/wuji-sdk/introduction) — 支持的设备、接口语言和 SDK 能力
    * [安装与环境](/docs/wuji-sdk/quick-start) — 系统要求、Python 安装、C 安装和安装验证
      * [系统要求](/docs/wuji-sdk/quick-start#系统要求)
      * [安装 Python SDK](/docs/wuji-sdk/quick-start#安装-python-sdk)
      * [安装 C SDK](/docs/wuji-sdk/quick-start#安装-c-sdk)
      * [验证安装](/docs/wuji-sdk/quick-start#验证安装)
  </Step>

  <Step title="连接设备">
    使用同一个 SDK 管理器发现、连接和管理 Wuji 设备。

    * [设备发现与连接](/docs/wuji-sdk/device-connection) — 自动连接、按 SN、地址、USB 或手性连接
      * [自动连接](/docs/wuji-sdk/device-connection#自动连接)
      * [指定 SN 连接](/docs/wuji-sdk/device-connection#指定-sn-连接)
      * [指定地址连接](/docs/wuji-sdk/device-connection#指定地址连接)
      * [按 USB 连接](/docs/wuji-sdk/device-connection#按-usb-连接)
      * [按手性连接](/docs/wuji-sdk/device-connection#按手性连接)
      * [多设备管理](/docs/wuji-sdk/device-connection#多设备管理)
  </Step>

  <Step title="订阅并理解数据">
    先理解订阅模式，再查看各产品数据流、时间戳和坐标变换。

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

  <Step title="录制数据">
    将多路同步数据录制为 MCAP，并检查录制质量。

    * [数据录制与离线处理](/docs/wuji-sdk/data-recording) — 压缩、时间戳、全局资源、Episode、监控和示例
      * [录制监控](/docs/wuji-sdk/data-recording#录制监控)
      * [质量告警](/docs/wuji-sdk/data-recording#质量告警)
      * [示例](/docs/wuji-sdk/data-recording#示例)
  </Step>

  <Step title="标定与设备管理">
    管理设备参数、SDK 用户和标定数据。

    * [设备参数与用户数据](/docs/wuji-sdk/device-params) — 参数读写、用户隔离、导入导出和标定
      * [参数读取](/docs/wuji-sdk/device-params#参数读取)
      * [SDK 用户管理](/docs/wuji-sdk/device-params#sdk-用户管理)
      * [用户数据导入导出](/docs/wuji-sdk/device-params#用户数据导入导出)
      * [标定](/docs/wuji-sdk/device-params#标定)
  </Step>

  <Step title="进阶与参考">
    根据产品和集成场景深入使用 SDK。

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

## 本版全部文档

<Columns cols={2}>
  <Card title="发布记录" href="/release-notes" horizontal>Wuji SDK 各版本更新内容与变更说明</Card>
  <Card title="产品介绍" href="/docs/wuji-sdk/introduction" horizontal>支持设备、接口语言和 SDK 能力</Card>
  <Card title="安装与环境" href="/docs/wuji-sdk/quick-start" horizontal>Python 与 C 的系统要求、安装和验证</Card>
  <Card title="设备发现与连接" href="/docs/wuji-sdk/device-connection" horizontal>发现、连接和管理 Wuji 设备</Card>
  <Card title="数据订阅" href="/docs/wuji-sdk/data-subscription" horizontal>订阅、合并和调节设备数据流</Card>
  <Card title="Wuji Hand 2 指尖触觉" href="/docs/wuji-sdk/wuji-hand-2-tactile" horizontal>触觉格式、标定和离线处理</Card>
  <Card title="数据录制" href="/docs/wuji-sdk/data-recording" horizontal>录制多通道数据到 MCAP</Card>
  <Card title="通用数据类型" href="/docs/wuji-sdk/data-reference" horizontal>Frame、姿态、惯性和录制类型</Card>
  <Card title="设备参数与用户数据" href="/docs/wuji-sdk/device-params" horizontal>参数读写、用户隔离、导入导出和标定</Card>
  <Card title="时间同步" href="/docs/wuji-sdk/time-sync" horizontal>时间戳语义、自动同步和手动同步</Card>
  <Card title="手部重定向" href="/docs/wuji-sdk/retargeting" horizontal>手部关键点到关节角度的映射</Card>
  <Card title="SDK 使用实践" href="/docs/wuji-sdk/sdk-practice/index" horizontal>重定向、用户管理和指尖触觉示例</Card>
  <Card title="工程实践" href="/docs/wuji-sdk/advanced" horizontal>错误处理、重连、多设备和日志</Card>
  <Card title="故障排查" href="/docs/wuji-sdk/troubleshooting" horizontal>安装、运行、版本兼容和日志问题</Card>
  <Card title="C 接口参考" href="/docs/wuji-sdk/c-sdk-reference" horizontal>C 接口、错误码和 Python 对照</Card>
  <Card title="附录" href="/docs/wuji-sdk/appendix" horizontal>术语、错误码、异常类型和版本兼容</Card>
</Columns>


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