SDK 下载与版本
商户登录后可在“配置接入 → 接入指南”下载 SDK。以下相对地址同时由平台端和商户端 Web 容器提供；正式站将 <console-base> 替换为 https://pink.ya.wang。独立部署按实际 Web 基础路径填写。
| 客户端 | 当前版本 | 下载地址 | 能力 |
|---|---|---|---|
| Web / H5 | 0.3.0 | /sdk/web/roze-pink-web-0.3.0.js | 完整滑块、点选、国际化与恢复 UI；保留 0.1.0 旧地址兼容 |
| TypeScript | 0.1.0 | /sdk/typescript/roze-pink-typescript-0.1.0.tar.gz | 强类型低阶 API |
| 微信/支付宝/抖音小程序 | 0.1.0 | /sdk/miniprogram/roze-pink-miniprogram-0.1.0.tar.gz | 请求适配器，UI 由原生组件实现 |
| iOS | 0.1.0 | /sdk/native/roze-pink-ios-0.1.0.tar.gz | Swift Package，iOS 15+ |
| Android | 0.1.0 | /sdk/native/roze-pink-android-0.1.0.tar.gz | Kotlin Library，minSdk 23 |
| Flutter Android / iOS | 0.1.0 | /sdk/flutter/roze-pink-flutter-0.1.0.tar.gz | WebView 验证弹窗、自动平台和包名、强类型 Proof；Android 24+ / iOS 13+ |
| HarmonyOS NEXT | 0.1.0 | /sdk/native/roze-pink-harmonyos-0.1.0.tar.gz | ArkTS / ohpm 源码包 |
| Node.js 服务端 | 当前源码版本 | sdks/server |
Server Key 验证与联合通过断言 |
成熟度说明
所有客户端 SDK 的前端可配置项、默认值和示例见 客户端配置指南。源码下载包内提供 CLIENT_CONFIGURATION.md；Web 文档发布到 /sdk/client-configuration.md。
Web SDK 提供完整交互组件。iOS、Android 和 HarmonyOS SDK 提供原生网络、强类型模型、挑战轨迹和 Proof 能力，业务应用使用原生图片和交互组件组装界面。小程序包目前是可用传输层，不应描述为完整 UI 组件。
完整性校验
发布前运行：
npm ci
npm run typecheck
npm run test:sdk
npm run test:native-sdks
npm run build:web
npm audit --audit-level=low
npm run package:native-sdks 会重新生成下载归档并复制到两个 Web 发布目录。版本号变更时，必须同时修改打包脚本、下载页面、本文档和变更记录，不能只重命名文件。
安全规则
所有客户端包只允许包含 Public Key。Server Key 必须由业务服务端保存，并通过服务端 SDK 或 POST /api/captcha/verify 消费 Proof。生产 App 和小程序必须发送与平台配置一致的 client_id。