Tool Bridge Mobile v0.0.2 (Preview)

Tool Bridge Mobile v0.0.2（Preview）

这是供内部定位 Android 前台连接问题的 GitHub Pre-release，不是 production、App Store 或 Google Play
正式版本。

本次变化

• 首页在 SDK transport 失败时显示固定的失败类型、失败阶段和 WebSocket close code；
• 可区分连接超时、DNS、TLS、WebSocket upgrade、网络不可达、连接重置与未知关闭；
• 原始 WebSocket reason、Gateway URL query、Authorization、API key 和 deviceId 不进入诊断、日志、审计
  或 UI；
• 主动暂停、配置切换、credential invalidation 和旧 socket 的迟到事件不会覆盖当前诊断；
• SDK 收到 ready 后清除旧诊断。

本版本没有新增远程 capability、系统权限、原生模块或持久化 schema，也没有调整 SDK 当前连接超时。

安装包

Release 附件中的 tool-bridge-mobile-preview-v0.0.2.apk：

• application id：ai.tokenroll.toolbridgemobile.preview；
• 内嵌 JavaScript bundle，不需要 Metro；
• 使用自动生成的 Android debug test key 签名，只用于内部安装；
• 同目录 .sha256 文件用于核对 APK 完整性。

重要限制

• 固定诊断字段只提升现场取证能力，不代表真机连接根因已经确认或修复；
• pairing、设备专用最小权限 credential、短期 WebSocket ticket、mailbox 与 push 尚未实现；
• 手工 API key fallback 尚未通过完整 Gateway compatibility matrix；配置保存成功不代表鉴权成功；
• 没有 production signer、AAB、iOS 设备包、商店合规、SBOM、真机矩阵或 staged rollout 证据；
• haptic、媒体、位置、通知、后台/锁屏和弱网行为尚未完成双端真机验收；
• 清除本机 Gateway 配置不会撤销服务端 API key。

只有 SDK 收到 Gateway ready 后 App 才显示 online。请不要把 API key 或原始网络异常写进 issue、日志
或截图。