用途：面向 Telegram Mini Apps 开发，覆盖前端构建、WebApp API 调用、initData 认证与 Telegram 集成。
主要能力：通过 window.Telegram.WebApp 初始化应用（ready、expand、close）、获取用户数据（initDataUnsafe 仅用于展示）、获取签名数据 initData 并发送至后端校验；配置 MainButton、BackButton；读取主题参数 themeParams 与 CSS 变量；监听 themeChanged、viewportChanged 等事件；使用 DeviceStorage、SecureStorage、CloudStorage 存储。
SDK 用法：安装 npm install @telegram-apps/sdk @telegram-apps/sdk-react，使用 SDKProvider 包裹应用，并通过 useLaunchParams、useInitData、useInitDataRaw、useThemeParams、useViewport、useMainButton、useBackButton、useCloudStorage 等 Hooks 访问能力。开发环境可用 mockTelegramEnv 模拟。
后端认证：以 Kotlin/Spring 示例展示 initData 校验，使用 HMAC-SHA256 与 bot token 计算 hash，校验 auth_date 时效，并通过 Authorization: tma ${initDataRaw} 传递。
组件库：安装 npm install @telegram-apps/ui，使用 AppRoot、Button、Cell、Section、Switch、Input、Select、Slider、Spinner、Placeholder 等组件。
限制：生产环境需 HTTPS；sendData() 限制 4096 字节；无法直接访问摄像头/麦克风；initData 约 1 小时后过期；受 WebView 能力约束；不同客户端功能可能存在差异。
适用场景：需要在 Telegram 内构建交互式前端、进行用户身份校验及与机器人后端集成的开发者。
暂未提供：具体收费、价格、平台支持范围及效果数据。