用途：Terra API 移动端 SDK 用于接入没有 Web API 的健康数据源，仅三类集成需要它：Apple Health/HealthKit（iOS）、Samsung Health（Android）、Health Connect（Android）。其他提供方（Garmin、Fitbit、Oura、Whoop、Strava、Dexcom 等 500+）走 Unified API，不走 SDK；Google Fit 可经 Health Connect 由 SDK 读取，但 Web API 更可靠。SDK 采集的数据流向与 Web API 相同的 Data Destination（webhook），连接使用同一 auth 模型。BLE/ANT+ 每秒级实时数据属于 Real-Time SDK。
主要能力：六步工作流在各平台一致——安装 SDK 并声明原生能力（iOS 的 HealthKit/后台能力、Android 的 manifest 权限与 minSDK 28）；每次启动和进入前台都初始化 SDK（TerraManager 或 initTerra，异步且须先完成）；由后端铸造一次性 auth token；用 initConnection 打开连接并传权限集；每次重新初始化后用 getUserId 校验；iOS 需在 AppDelegate 调用 Terra.setUpBackgroundDelivery()。
用法要点：令牌由后端 POST https://api.tryterra.co/v2/auth/tokens（已弃用的 /auth/generateAuthToken 是同一端点），reference_id 作为查询参数以绑定用户，用 auth:write 数据令牌 Bearer 认证，令牌一次性且 3 分钟过期，切勿从 App 调用该端点。账户侧可用 CLI：terra environments list、terra data-tokens create、terra data-tokens list、terra users list 等；data-tokens list 只返回元数据。在编码智能体中用 CLI（macOS/Linux: curl -fsSL https://cli.tryterra.co/install.sh | sh；Windows PowerShell: irm "https://cli.tryterra.co/install.ps1" | iex，或用 Homebrew/npm）；在聊天助手中用 Terra API admin MCP 服务器，MCP 无 --select 与 --jq。
限制与注意：权限弹窗只在首次出现，重复 initConnection 不会再次弹出；HealthKit 弹窗为 WebView，WebView 应用需中断再重开。iOS 后台投递在 App 被杀、手机锁定或无网络时受限，且只投递 Terra API 仪表盘已启用的数据类型。Samsung Health 需已批准的合作伙伴关系，发布版需 ProGuard 规则；Health Connect 需 manifest 配置与 Google 审批。setIgnoredSources 仅 iOS 且不持久化。新设备或重装会替换旧连接并触发 user_reauth。postActivity 需要 device_data 与 iOS 14+。具体数据权限、Samsung 直连或 Health Connect 路线、回填方式等由集成方自行决定。