# SDK 文档路径索引

> 本索引指向 wiki 权威文档，供 skill 生成代码时参考。
> wiki 目录由 `ae-tracking wiki` 从 AE 官方文档抓取，保持同步。

---

## ⚠️ 重要：文档读取优先级

**生成代码时，必须优先读取「主文档」，不要读取历史版本文档！**

| 优先级 | 文档类型 | 说明 |
|---|---|---|
| 🔴 **最高** | 主文档（如 `unity.md`） | 最新版 SDK 使用指南，包含正确的 API |
| 🟡 中等 | 进阶指南、自动采集、预置属性 | 补充信息，主文档读完后再读 |
| ⚫ **忽略** | 历史版本文档（如 `历史版本-unity-sdk-使用指南.md`） | 已过时，API 可能不兼容新版 SDK |

**目录命名规则**：
- `xxx.md` — 最新版主文档（优先读取）
- `历史版本-xxx.md` — 已过时文档（忽略）
- `进阶指南/` — 补充文档（次优先级）

---

## 客户端 SDK

### 原生移动端

| SDK 类型 | 主文档 | 进阶指南 | 自动采集 | 预置属性 |
|---|---|---|---|---|
| Android | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/android.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/android/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/android/进阶指南/自动采集.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/android/进阶指南/预置属性.md` |
| iOS | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/ios.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/ios/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/ios/进阶指南/自动采集.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/ios/进阶指南/预置属性.md` |

### Web / H5

| SDK 类型 | 主文档 | 进阶指南 | 自动采集 |
|---|---|---|---|
| JavaScript | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/javascript.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/javascript/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/javascript/进阶指南/自动采集.md` |

### 小程序 & 小游戏

| SDK 类型 | 主文档 | 进阶指南 | 自动采集 |
|---|---|---|---|
| 小程序小游戏 | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/小程序小游戏.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/小程序小游戏/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/小程序小游戏/进阶指南/自动采集.md` |

### 游戏引擎

| SDK 类型 | 版本 | 主文档 | 进阶指南 | 自动采集 |
|---|---|---|---|---|
| Unity | v3.x | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unity.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unity/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unity/进阶指南/自动采集.md` |
| Unreal | v2.x | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unreal.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unreal/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unreal/进阶指南/自动采集.md` |
| Cocos2d-x | v2.x | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocos2d-x.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocos2d-x/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocos2d-x/进阶指南/自动采集.md` |
| CocosCreator | v2.x | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocoscreator.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocoscreator/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocoscreator/进阶指南/自动采集.md` |
| LayaAir | v2.x | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/layaair.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/layaair/进阶指南.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/layaair/进阶指南/自动采集.md` |

**注意**：Unity SDK 从 v2.x 升级到 v3.x，API 有较大变化：
- v2.x API：`ThinkingAnalyticsAPI.Track()`
- v3.x API：`TDAnalytics.Track()`
- 主文档 `unity.md` 对应 v3.x 最新版，历史文档 `历史版本-unity-sdk-使用指南.md` 对应 v1.x/v2.x 已过时

### 跨平台框架

| SDK 类型 | 主文档 | 进阶指南 |
|---|---|---|
| React Native | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/react-native.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/react-native/进阶指南.md` |
| Flutter | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/flutter.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/flutter/进阶指南.md` |
| uni-app | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/uni-app.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/uni-app/进阶指南.md` |

---

## 服务端 SDK

| 语言 | 主文档 | 进阶指南 |
|---|---|---|
| Java | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/java.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/java/进阶指南.md` |
| Python | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/python.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/python/进阶指南.md` |
| Golang | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/golang.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/golang/进阶指南.md` |
| Node.js | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/nodejs.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/nodejs/进阶指南.md` |
| PHP | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/php.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/php/进阶指南.md` |
| C# | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/c-HF7Dwv.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/c/进阶指南-YGuuwc.md` |
| C++ | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/c-D4KBwg.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/c/进阶指南-Jc1dwk.md` |
| Ruby | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/ruby.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/ruby/进阶指南.md` |
| Lua | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/lua.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/lua/进阶指南.md` |
| Erlang | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/erlang.md` | `~/.ae-tracking/wiki/te-docs/raw/接入指南/服务端-sdk/erlang/进阶指南.md` |

---

## 数据导入工具

| 工具 | 文档路径 | 说明 |
|---|---|---|
| **LogBus2** | `~/.ae-tracking/wiki/te-docs/raw/接入指南/数据导入/logbus2-使用指南.md` | 推荐，配合 LoggerConsumer 使用 |
| DataX Writer | `~/.ae-tracking/wiki/te-docs/raw/接入指南/数据导入/ta-datax-writer-插件使用指南.md` | 数据库批量导入 |
| RESTful API | `~/.ae-tracking/wiki/te-docs/raw/接入指南/restful-api-使用指南.md` | HTTP 直接上报 |

**注意：LogBus v1 已过时，不再推荐使用。所有场景统一使用 LogBus2。**

官方文档链接：
- 使用指南：https://docs-v2.thinkingdata.cn/?version=latest&code=logbus2_installation
- 下载地址在官方文档「二、下载 LogBus2」章节中

---

## 预置属性与系统字段

| 文档 | 路径 |
|---|---|
| 预置属性与系统字段 | `~/.ae-tracking/wiki/te-docs/raw/接入前准备工作/预置属性与系统字段.md` |
| 用户识别规则 | `~/.ae-tracking/wiki/te-docs/raw/接入前准备工作/用户识别规则.md` |
| 数据规则 | `~/.ae-tracking/wiki/te-docs/raw/接入前准备工作/数据规则.md` |

---

## 合成文档（概览）

这些是 LLM 从多个原始文档合成的概览文档，适合快速了解：

| 合成文档 | 路径 | 说明 |
|---|---|---|
| 服务端 SDK 概览 | `~/.ae-tracking/wiki/te-docs/synthesis/server-sdk-overview.md` | 所有服务端 SDK 的统一架构 |
| SDK 选择指南 | `~/.ae-tracking/wiki/te-docs/synthesis/sdk-selection.md` | 如何选择合适的 SDK |
| RESTful API 参考 | `~/.ae-tracking/wiki/te-docs/synthesis/restful-api-reference.md` | RESTful 接口汇总 |
| JS SDK 速查表 | `~/.ae-tracking/wiki/te-docs/synthesis/js-sdk-cheatsheet.md` | JavaScript SDK 快速参考 |