ae-tracking 0.1.0

package/skills/generate-tracking-code/references/debug-script.md

@@ -0,0 +1,99 @@
+# 模式 F — Debug / 校验脚本
+
+## 产物
+`te-debug.<ext>` 单文件；用于快速验证 SDK 配置是否正确。
+
+---
+
+## Debug 模式验证方式
+
+使用 debug 模式时，需要在 AE 后台添加 debug 设备 ID，数据才会在 AE Web 的 **Debug 数据页面** 显示。
+
+### 验证步骤
+
+| 步骤 | 操作 |
+|---|---|
+| 1 | 在 AE 后台添加 debug 设备 ID：埋点管理 → Debug 数据 → 添加设备 |
+| 2 | 运行 debug 脚本发送测试事件 |
+| 3 | 打开 AE Debug 页面：`https://<host>/#/data/debug` |
+| 4 | 筛选对应的 `distinct_id` 或 `device_id` 查看上报数据 |
+
+### 客户端和服务端 SDK 通用说明
+
+- 两者都使用 **TDDebugConsumer**（或对应平台的 debug 模式 API）
+- 都需要在 AE 后台添加设备 ID 才能在 Debug 页面查看数据
+- 校验失败时 SDK 会打印错误日志或抛异常（具体行为因语言而异）
+
+---
+
+## 各平台 Debug 模式 API
+
+### 客户端 SDK
+
+| SDK | debug 模式 API | 参考文档 |
+|---|---|---|
+| Unity SDK | `TDConfig config = new TDConfig(appId, serverUrl); config.mode = TDMode.DEBUG; TDAnalytics.Init(config);` | `客户端-sdk/游戏引擎/unity/进阶指南/实时调试.md` |
+| Android SDK | `TDConfig config = new TDConfig(this, serverUrl, appId); config.setMode(TDConfig.Mode.DEBUG); TDAnalytics.init(this, config);` | `客户端-sdk/android/进阶指南/实时调试.md` |
+| iOS SDK | `TDConfig *config = [[TDConfig alloc] initWithAppId:appId serverUrl:serverUrl]; config.mode = TDModeDebug; [TDAnalytics startWithConfig:config];` | `客户端-sdk/ios/进阶指南/实时调试.md` |
+| JavaScript SDK | `ta.init({ appId: appId, server_url: serverUrl, debug: true });` | `客户端-sdk/jav
+         -ascript/进阶指南/实时调试.md` |  
+| 小程序 SDK | `ta.init({ appId: appId, server_url: serverUrl, debug: true });` | `客户端-sdk/小程序小游戏/进阶指南/实时调试.md` |
+| CocosCreator | 参考文档 | `客户端-sdk/游戏引擎/cocoscreator/进阶指南/实时调试.md` |
+| Cocos2d-x | 参考文档 | `客户端-sdk/游戏引擎/cocos2d-x/进阶指南/实时调试.md` |
+| Unreal SDK | 参考文档 | `客户端-sdk/游戏引擎/unreal/进阶指南/实时调试.md` |
+| Flutter SDK | 参考文档 | `客户端-sdk/跨平台框架/flutter/进阶指南/实时调试.md` |
+| React Native | 参考文档 | `客户端-sdk/跨平台框架/react-native/进阶指南/实时调试.md` |
+
+### 服务端 SDK
+
+| 语言 | DebugConsumer API | 参考文档 |
+|---|---|---|
+| Java | `new TDDebugConsumer(serverUrl, appId, deviceId)` | `服务端-sdk/java/进阶指南/实时调试.md` |
+| Python | `TDDebugConsumer(serverUrl, appId, device_id="...")` | `服务端-sdk/python/进阶指南/实时调试.md` |
+| Go | `NewDebugConsumerWithDeviceId(serverUrl, appId, false, deviceId)` | `服务端-sdk/golang/进阶指南/实时调试.md` |
+| Node.js | `ThinkingData.initWithDebugMode(appId, serverUrl, { deviceId: "..." })` | `服务端-sdk/nodejs/进阶指南/实时调试.md` |
+| PHP | `new TDDebugConsumer(serverUrl, appId, deviceId)` | `服务端-sdk/php/进阶指南/实时调试.md` |
+| Ruby | `TDDebugConsumer.new(serverUrl, appId, deviceId)` | `服务端-sdk/ruby/进阶指南/实时调试.md` |
+| Erlang | `tddebug_consumer:new(ServerUrl, AppId, DeviceId)` | `服务端-sdk/erlang/进阶指南/实时调试.md` |
+| Lua | `TDDebugConsumer.new(serverUrl, appId, deviceId)` | `服务端-sdk/lua/进阶指南/实时调试.md` |
+| C | `td_debug_consumer_new(serverUrl, appId, deviceId)` | `服务端-sdk/c/进阶指南/实时调试.md` |
+
+---
+
+## Skill 生成时的检查点
+
+生成 debug 脚本时，skill 必须：
+
+1. **先读对应 SDK 的「实时调试」文档**（见下方参考文档路径），确认该 SDK 的 debug 模式 API 和用法（表中 API 仅为索引参考，实际用法可能有差异）
+2. 使用对应平台的 **TDDebugConsumer** 或 debug 模式 API
+3. 设置 `deviceId`（如 `claude-test-device`），用于 AE 后台添加设备
+4. 从 plan 中读取 `SERVER_URL`、`appId`（不是 web host）
+5. 从 plan 中取 3 个代表性业务事件（如有对象组属性，需完整构造）
+6. 建议开启 SDK 日志打印（便于排查问题）
+7. 文件名必须与类名一致（如 Unity: `TEDebugScript.cs`）
+
+### 交付后提示
+
+**平台过滤说明**：
+- xlsx "采集端" 值到 `platform` 字段的映射：
+  - `客户端` / `client` → `platform: "client"`
+  - `服务端` / `server` → `platform: "server"`
+  - `客户端,服务端` / `client,server` → `platform: "both"`
+- 客户端 debug 脚本：只包含 `platform === "client"` 或 `platform === "both"` 的事件
+- 服务端 debug 脚本：只包含 `platform === "server"` 或 `platform === "both"` 的事件
+- 若 xlsx 无 platform 列，则包含全部事件（向后兼容）
+
+```
+验证步骤：
+1. 在 AE 后台添加 debug 设备 ID：埋点管理 → Debug 数据 → 添加设备（输入 deviceId）
+2. 运行 debug 脚本
+3. 打开 AE Debug 页面：https://<host>/#/data/debug
+4. 筛选对应的 distinct_id 或 device_id 查看上报数据
+5. 检查事件属性结构是否正确（特别是对象组属性）
+```
+
+### 参考文档路径
+
+所有 SDK 的实时调试文档位于：
+- `wiki/te-docs/raw/接入指南/客户端-sdk/<sdk>/进阶指南/实时调试.md`
+- `wiki/te-docs/raw/接入指南/服务端-sdk/<language>/进阶指南/实时调试.md`

package/skills/generate-tracking-code/references/logbus-config.md

@@ -0,0 +1,224 @@
+# LogBus2 配置生成
+
+LogBus2 是 AE 官方提供的日志同步工具，配合 LoggerConsumer（服务端 SDK）使用。
+
+**注意：LogBus v1 已过时，不再推荐使用。所有场景统一使用 LogBus2。**
+
+---
+
+## 架构
+
+```
+服务端代码 → LoggerConsumer → 本地日志文件
+                                    ↓
+                              LogBus2 进程 → AE 后台
+```
+
+---
+
+## 官方文档
+
+生成配置文件时，**必须同步提供官方文档链接**：
+
+| 文档类型 | URL |
+|---|---|
+| **LogBus2 使用指南** | https://docs-v2.thinkingdata.cn/?version=latest&code=logbus2_installation |
+
+**注意**：下载地址在官方文档「二、下载 LogBus2」章节中，包含各平台版本：
+- Linux-amd64
+- Linux-arm64
+- Windows
+- Mac Apple Silicon
+- Mac Intel
+- Docker Image
+
+---
+
+## 触发时机
+
+- 服务端选择 `insert` 或 `snippet` 时，**默认生成**
+- 不需要用户单独选择
+
+---
+
+## 产物
+
+### 1. 配置文件
+
+`.ae-tracking/output/daemon.json`：
+
+```json
+{
+  "datasource": [
+    {
+      "type": "file",
+      "file_patterns": [
+        "/data/ta_log/*.log"
+      ],
+      "app_id": "<appId>",
+      "unit_remove": "day",
+      "offset_remove": 7
+    }
+  ],
+  "push_url": "<SERVER_URL>"
+}
+```
+
+**配置项说明**：
+
+| 配置项 | 说明 | 必填 |
+|---|---|---|
+| `file_patterns` | 日志文件匹配路径（Glob 通配符），与 LoggerConsumer 配置一致 | ✔️ |
+| `app_id` | AE 项目 APP_ID | ✔️ |
+| `push_url` | AE receiver 地址（需 http/https 开头） | ✔️ |
+| `unit_remove` | 文件删除单位：`day` 或 `hour` | 可选 |
+| `offset_remove` | 文件删除偏移量（配合 unit_remove） | 可选 |
+
+### 2. README 文件
+
+`.ae-tracking/output/logbus-README.md`：
+
+```
+# LogBus2 配置使用说明
+
+## 重要提示
+
+- LogBus v1 已过时，请使用 **LogBus2**
+- 本配置文件为 JSON 格式（daemon.json）
+
+## 官方文档
+
+| 文档 | 链接 |
+|---|---|
+| **LogBus2 使用指南** | https://docs-v2.thinkingdata.cn/?version=latest&code=logbus2_installation |
+
+下载地址在官方文档「二、下载 LogBus2」章节中。
+
+## 前置
+
+1. **下载 LogBus2**（对应 OS 版本）：
+   - 访问官方文档，在「二、下载 LogBus2」章节下载对应版本
+   - Linux-amd64 / Linux-arm64 / Windows / Mac / Docker
+
+2. **解压部署**：
+   ```bash
+   tar -xzf logbus2-linux-amd64.tar.gz
+   cd logbus2
+   ```
+
+3. **确认 LoggerConsumer 日志路径**：
+   - 本配置使用：/data/ta_log/*.log
+   - 确保 LoggerConsumer 配置与此一致
+
+4. **放置配置文件**：
+   ```bash
+   cp daemon.json conf/daemon.json
+   ```
+
+## 启动
+
+```bash
+./logbus start
+```
+
+## 常用命令
+
+| 命令 | 说明 |
+|---|---|
+| `./logbus start` | 启动 LogBus2 |
+| `./logbus stop` | 停止 LogBus2 |
+| `./logbus restart` | 重启 LogBus2 |
+| `./logbus env` | 检查配置和连通性 |
+| `./logbus progress` | 查看传输进度 |
+| `./logbus reset` | 重置读取记录（慎用） |
+| `./logbus dev` | 校验文件格式 |
+
+## 验证
+
+1. 查看运行状态：`./logbus progress`
+2. 查看日志：`./logbus/log/` 目录下的日志文件
+3. 打开 AE Debug 页面验证数据入库
+
+## 配置项说明
+
+| 配置项 | 当前值 | 说明 |
+|---|---|
+| push_url | <SERVER_URL> | AE receiver 地址 |
+| app_id | <appId> | AE 项目 APP_ID |
+| file_patterns | /data/ta_log/*.log | 日志文件匹配规则 |
+
+## 注意事项
+
+1. **不要重命名已上传的日志文件**：重命名相当于新建文件，会导致重复上传
+2. **不要操作 runtime 目录**：该目录存储传输进度快照
+3. **配置 glob 通配符，不支持正则**：如 `/data/log/*.log`
+```
+
+---
+
+## 启动命令
+
+```bash
+./logbus start
+```
+
+**常用命令**：
+
+| 命令 | 说明 |
+|---|---|
+| `./logbus start` | 启动 |
+| `./logbus stop` | 停止 |
+| `./logbus restart` | 重启 |
+| `./logbus env` | 检查配置和连通性 |
+| `./logbus progress` | 查看传输进度 |
+| `./logbus reset` | 重置读取记录 |
+| `./logbus dev` | 校验文件格式 |
+
+---
+
+## LoggerConsumer 数据格式
+
+LoggerConsumer 输出为 JSON line 格式，LogBus2 自动解析：
+
+| LoggerConsumer 字段 | 说明 |
+|---|---|
+| `#event_name` | 事件名 |
+| `#time` | 时间戳（ISO 8601） |
+| `#distinct_id` | 访客 ID |
+| `#account_id` | 账号 ID |
+| 业务属性 | track 调用中的 properties |
+
+---
+
+## 客户提示（生成时必须展示）
+
+生成 LogBus2 配置文件后，向客户展示：
+
+```
+LogBus2 配置文件已生成：.ae-tracking/output/daemon.json
+
+## 官方文档
+
+| 文档 | 链接 |
+|---|---|
+| **LogBus2 使用指南** | https://docs-v2.thinkingdata.cn/?version=latest&code=logbus2_installation |
+
+下载地址在官方文档「二、下载 LogBus2」章节中。
+
+## 使用步骤
+
+1. 从官方文档下载 LogBus2（对应 OS 版本）
+2. 解压部署
+3. 将 daemon.json 复制到 conf/ 目录
+4. 启动：./logbus start
+5. 验证：./logbus progress
+
+注意：LogBus v1 已过时，请使用 LogBus2。
+```
+
+---
+
+## 参考文档
+
+- 官方文档：https://docs-v2.thinkingdata.cn/?version=latest&code=logbus2_installation
+- Wiki: `wiki/te-docs/raw/接入指南/数据导入/logbus2-使用指南.md` — LogBus2 官方文档镜像

package/skills/generate-tracking-code/references/modes.md

@@ -0,0 +1,81 @@
+# 输出方式架构
+
+## 核心选择（每个端/平台）
+
+| 输出方式 | 说明 | 参数 | 产物 |
+|---|---|---|---|
+| **insert**（插入） | 直接 Edit 写入用户项目 | 需指定项目路径（绝对路径） | 代码写入指定目录 |
+| **snippet**（片段） | markdown 打印 + 生成代码文件 | 无需路径 | `.ae-tracking/output/<platform>-sdk.<ext>` |
+
+---
+
+## 服务端默认附加
+
+服务端无论选择 `insert` 还是 `snippet`，都额外生成：
+
+| 产物 | 说明 |
+|---|---|
+| LoggerConsumer 代码 | 服务端 SDK 写本地日志文件 |
+| `.ae-tracking/output/daemon.json` | LogBus2 配置（读取日志上传到 TE） |
+
+**注意：LogBus v1 已过时，统一使用 LogBus2。**
+
+官方文档：
+- 使用指南：https://docs-v2.thinkingdata.cn/?version=latest&code=logbus2_installation
+- 下载地址在官方文档「二、下载 LogBus2」章节中
+
+**架构原理**：
+```
+服务端代码 → LoggerConsumer → 本地日志文件
+                                    ↓
+                              LogBus2 进程 → AE 后台
+```
+
+优势：
+- 数据可靠（本地日志持久化）
+- 异步上报（不阻塞业务逻辑）
+- 批量上传（网络效率高）
+
+---
+
+## 独立选项（保留）
+
+| 选项 | 说明 | 产物 |
+|---|---|---|
+| `datax` | 数据库批量导入 | `.ae-tracking/output/datax-job.json` + README |
+| `restful` | RESTful API 直接上报（HTTP POST） | `.ae-tracking/output/restful-client.<ext>` |
+| `debug` | 校验脚本 | `.ae-tracking/output/te-debug.<ext>` |
+
+---
+
+## SDK 集成模式 → 端/平台列表
+
+| SDK 集成模式 | 端/平台列表 |
+|---|---|
+| `client_only` | 客户端：[client_sdk_type]（如 `['android']`） |
+| `server_only` | 服务端：[server_language]（如 `['java']`） |
+| `both` | 客户端：[client_sdk_type]，服务端：[server_language] |
+
+---
+
+## 快捷选择
+
+| 快捷选项 | 说明 |
+|---|---|
+| **全都生成片段** | 所有端/平台都选择 `snippet`，一次性输出所有代码文件 |
+
+适用场景：
+- 不在项目目录下
+- 只想参考代码结构
+- 多端多平台一次性输出
+
+---
+
+## 约束
+
+- 任何 `insert` 执行前必须检查 `git status`，有未提交改动时拒绝
+- 客户端代码只生成 `platform === "client"` 或 `platform === "both"` 的事件
+- 服务端代码只生成 `platform === "server"` 或 `platform === "both"` 的事件
+- 服务端默认 LoggerConsumer + LogBus2，不默认 RESTful
+- **只用 LogBus2，不再使用 LogBus v1**（已过时）
+- 生成 LogBus2 配置时，必须同步提供官方文档链接（使用指南 + 下载地址）

package/skills/generate-tracking-code/references/restful-call.md

@@ -0,0 +1,34 @@
+# 模式 E — RESTful 调用
+
+## 选择模板
+按 appType → 语言：
+- node-server → `src/lib/te-track.ts`（axios）
+- python-server → `src/lib/te_track.py`（requests）
+- go-server → `src/lib/te_track.go`（net/http）
+- java-server → `src/main/java/.../TeTrack.java`（OkHttp）
+
+## 产物（Node 示例）
+```ts
+// src/lib/te-track.ts
+import axios from 'axios';
+
+const SERVER_URL = '<SERVER_URL>';
+const APPID = '<appId>';
+
+export async function track(event: string, props: Record<string, unknown>, distinctId: string) {
+  await axios.post(`${SERVER_URL}/sync_json`, {
+    appid: APPID,
+    event,
+    '#time': new Date().toISOString(),
+    '#distinct_id': distinctId,
+    properties: { ...props },
+  }, { headers: { 'Content-Type': 'application/json' } });
+}
+```
+
+其它语言提供同构版本，参考 `~/.ae-tracking/wiki/te-docs/synthesis/restful-api-reference.md`。
+
+## 生成步骤
+1. 按 appType 选模板；确认 wiki 中的 endpoint/鉴权规则
+2. 若 CWD 是 server 项目 → 直接 Edit 写文件（模式 A 的 Stage 3 逻辑简化版）
+3. 否则 → 按模式 B 片段递交

package/skills/generate-tracking-code/references/sdk-index.md

@@ -0,0 +1,123 @@
+# SDK 文档路径索引
+
+> 本索引指向 wiki 权威文档，供 skill 生成代码时参考。
+> wiki 目录由 `ae-tracking wiki` 从 AE 官方文档抓取，保持同步。
+
+---
+
+## ⚠️ 重要：文档读取优先级
+
+**生成代码时，必须优先读取「主文档」，不要读取历史版本文档！**
+
+| 优先级 | 文档类型 | 说明 |
+|---|---|---|
+| 🔴 **最高** | 主文档（如 `unity.md`） | 最新版 SDK 使用指南，包含正确的 API |
+| 🟡 中等 | 进阶指南、自动采集、预置属性 | 补充信息，主文档读完后再读 |
+| ⚫ **忽略** | 历史版本文档（如 `历史版本-unity-sdk-使用指南.md`） | 已过时，API 可能不兼容新版 SDK |
+
+**目录命名规则**：
+- `xxx.md` — 最新版主文档（优先读取）
+- `历史版本-xxx.md` — 已过时文档（忽略）
+- `进阶指南/` — 补充文档（次优先级）
+
+---
+
+## 客户端 SDK
+
+### 原生移动端
+
+| SDK 类型 | 主文档 | 进阶指南 | 自动采集 | 预置属性 |
+|---|---|---|---|---|
+| Android | `wiki/te-docs/raw/接入指南/客户端-sdk/android.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/android/进阶指南.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/android/进阶指南/自动采集.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/android/进阶指南/预置属性.md` |
+| iOS | `wiki/te-docs/raw/接入指南/客户端-sdk/ios.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/ios/进阶指南.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/ios/进阶指南/自动采集.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/ios/进阶指南/预置属性.md` |
+
+### Web / H5
+
+| SDK 类型 | 主文档 | 进阶指南 | 自动采集 |
+|---|---|---|---|
+| JavaScript | `wiki/te-docs/raw/接入指南/客户端-sdk/javascript.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/javascript/进阶指南.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/javascript/进阶指南/自动采集.md` |
+
+### 小程序 & 小游戏
+
+| SDK 类型 | 主文档 | 进阶指南 | 自动采集 |
+|---|---|---|---|
+| 小程序小游戏 | `wiki/te-docs/raw/接入指南/客户端-sdk/小程序小游戏.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/小程序小游戏/进阶指南.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/小程序小游戏/进阶指南/自动采集.md` |
+
+### 游戏引擎
+
+| SDK 类型 | 版本 | 主文档 | 进阶指南 | 自动采集 |
+|---|---|---|---|---|
+| Unity | v3.x | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unity.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unity/进阶指南.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unity/进阶指南/自动采集.md` |
+| Unreal | v2.x | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unreal.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unreal/进阶指南.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/unreal/进阶指南/自动采集.md` |
+| Cocos2d-x | v2.x | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocos2d-x.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocos2d-x/进阶指南.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocos2d-x/进阶指南/自动采集.md` |
+| CocosCreator | v2.x | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocoscreator.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocoscreator/进阶指南.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/cocoscreator/进阶指南/自动采集.md` |
+| LayaAir | v2.x | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/layaair.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/游戏引擎/layaair/进阶指南.md` | `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 | `wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/react-native.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/react-native/进阶指南.md` |
+| Flutter | `wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/flutter.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/flutter/进阶指南.md` |
+| uni-app | `wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/uni-app.md` | `wiki/te-docs/raw/接入指南/客户端-sdk/跨平台框架/uni-app/进阶指南.md` |
+
+---
+
+## 服务端 SDK
+
+| 语言 | 主文档 | 进阶指南 |
+|---|---|---|
+| Java | `wiki/te-docs/raw/接入指南/服务端-sdk/java.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/java/进阶指南.md` |
+| Python | `wiki/te-docs/raw/接入指南/服务端-sdk/python.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/python/进阶指南.md` |
+| Golang | `wiki/te-docs/raw/接入指南/服务端-sdk/golang.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/golang/进阶指南.md` |
+| Node.js | `wiki/te-docs/raw/接入指南/服务端-sdk/nodejs.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/nodejs/进阶指南.md` |
+| PHP | `wiki/te-docs/raw/接入指南/服务端-sdk/php.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/php/进阶指南.md` |
+| C# | `wiki/te-docs/raw/接入指南/服务端-sdk/c-HF7Dwv.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/c/进阶指南-YGuuwc.md` |
+| C++ | `wiki/te-docs/raw/接入指南/服务端-sdk/c-D4KBwg.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/c/进阶指南-Jc1dwk.md` |
+| Ruby | `wiki/te-docs/raw/接入指南/服务端-sdk/ruby.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/ruby/进阶指南.md` |
+| Lua | `wiki/te-docs/raw/接入指南/服务端-sdk/lua.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/lua/进阶指南.md` |
+| Erlang | `wiki/te-docs/raw/接入指南/服务端-sdk/erlang.md` | `wiki/te-docs/raw/接入指南/服务端-sdk/erlang/进阶指南.md` |
+
+---
+
+## 数据导入工具
+
+| 工具 | 文档路径 | 说明 |
+|---|---|---|
+| **LogBus2** | `wiki/te-docs/raw/接入指南/数据导入/logbus2-使用指南.md` | 推荐，配合 LoggerConsumer 使用 |
+| DataX Writer | `wiki/te-docs/raw/接入指南/数据导入/ta-datax-writer-插件使用指南.md` | 数据库批量导入 |
+| RESTful API | `wiki/te-docs/raw/接入指南/restful-api-使用指南.md` | HTTP 直接上报 |
+
+**注意：LogBus v1 已过时，不再推荐使用。所有场景统一使用 LogBus2。**
+
+官方文档链接：
+- 使用指南：https://docs-v2.thinkingdata.cn/?version=latest&code=logbus2_installation
+- 下载地址在官方文档「二、下载 LogBus2」章节中
+
+---
+
+## 预置属性与系统字段
+
+| 文档 | 路径 |
+|---|---|
+| 预置属性与系统字段 | `wiki/te-docs/raw/接入前准备工作/预置属性与系统字段.md` |
+| 用户识别规则 | `wiki/te-docs/raw/接入前准备工作/用户识别规则.md` |
+| 数据规则 | `wiki/te-docs/raw/接入前准备工作/数据规则.md` |
+
+---
+
+## 合成文档（概览）
+
+这些是 LLM 从多个原始文档合成的概览文档，适合快速了解：
+
+| 合成文档 | 路径 | 说明 |
+|---|---|---|
+| 服务端 SDK 概览 | `wiki/te-docs/synthesis/server-sdk-overview.md` | 所有服务端 SDK 的统一架构 |
+| SDK 选择指南 | `wiki/te-docs/synthesis/sdk-selection.md` | 如何选择合适的 SDK |
+| RESTful API 参考 | `wiki/te-docs/synthesis/restful-api-reference.md` | RESTful 接口汇总 |
+| JS SDK 速查表 | `wiki/te-docs/synthesis/js-sdk-cheatsheet.md` | JavaScript SDK 快速参考 |