Box如何做到零追踪:移除Firebase与Clearcut日志的隐私改造实录
Box如何做到零追踪:移除Firebase与Clearcut日志的隐私改造实录
Box 是 Android 上最先进的完全离线客户端 AI 套件——聊天、语音、生图、听写全部在本地运行。但一个有趣的细节是:它脱胎于 Google 的开源项目 AI Edge Gallery,fork 之初身上其实带着 Google 的 Firebase Analytics 与 Cloud Messaging 追踪代码。v3.4.5 版本中,Box 完成了一次彻底的零追踪隐私改造:移除 Firebase 依赖、清理 20 处休眠追踪调用、关闭 Manifest 里的 6 条 Google 注册项,并顺手干掉了藏在 ML Kit 里的 Clearcut 使用日志。本文带你复盘这场"外科手术"。
为什么离线 AI 套件也要做零追踪改造?
先说结论:"离线"不等于"干净"。
Box 继承自 Google AI Edge Gallery,上游代码中内置了完整的 Firebase 埋点体系。这些代码在 Box 中从未真正配置(连 google-services.json 都没有),但依赖库、Manifest 注册项和调用点全都躺在 APK 里:
- 依赖包会被打包进应用,占据体积;
- Manifest 中注册的 Google 组件是明确的"追踪意图声明",隐私审计工具会直接标记;
- 一旦未来有人误配了 Firebase 项目,埋点就会"活过来"。
所以 Box 选择连根拔起,而非仅仅禁用。这是零追踪改造的第一步。
第一刀:移除 Firebase 追踪链路
构建配置中的三个追踪入口
改造前,build.gradle.kts 中声明了三组 Google 追踪依赖:
implementation(platform(libs.firebase.bom))
implementation(libs.firebase.analytics)
implementation(libs.firebase.messaging)
版本集中定义在 libs.versions.toml 中(firebase-bom 33.16.0)。v3.4.5 起,这三行连同版本目录中的条目被整体删除——依赖不在了,追踪代码自然无处依附。
Manifest 里的 6 条 Google 注册项
更隐蔽的是 AndroidManifest.xml:Firebase Analytics 的测量接收器(AppMeasurementReceiver / AppMeasurementService / AppMeasurementJobService)、FCM 推送服务(GalleryFcmMessagingService)以及 MESSAGING_EVENT 过滤器等,共 6 处 Google 组件注册全部被清除。Manifest 里的每一行注册,都是"这个 App 可以做什么"的公开声明——删干净了,才谈得上零追踪。
20 处休眠追踪调用与初始化入口
源码中追踪调用分布在十几个界面文件里,例如:
- 启动入口 GalleryApplication.kt 中的
FirebaseApp.initializeApp(this); - 分析门面 Analytics.kt 中的
firebaseAnalytics全局属性; - 推送服务 FcmMessagingService.kt 的 FCM 消息处理;
- 聊天、基准测试、下载等各界面中散落的
firebaseAnalytics?.logEvent(...)调用,累计 20 处。
值得注意的是上游的防御式设计:firebaseAnalytics 用了 runCatching 包裹,缺少配置时会静默降级——这正是问题所在,"静默"意味着你根本不知道埋点是否在工作。Box 的做法更彻底:调用点、初始化、Manifest 注册、依赖声明四处一起删,让"追踪"从二进制里消失,而不是被 try-catch 悄悄吞掉。
第二刀:藏在 ML Kit 里的 Clearcut 使用日志
Firebase 移除后,Box 发现第二层隐患:Clearcut。
Clearcut 是 Google 的一套使用日志传输机制,它不随 Firebase 走,而是捆绑在 ML Kit 内部(Box 用它做背景移除、人脸检测、图像文字识别)。它的隐蔽之处在于:
- 走的是普通 HTTPS 连接,不经过 Google Play 服务——所以哪怕你用 GrapheneOS 这类去 Googled 系统,它也照样能发数据;
- ML Kit 没有提供任何开关可以关闭它。
Box 的解法是从源头掐断:让 Clearcut 的传输层找不到任何已注册的接收者,事件在写入之前就被丢弃。ML Kit 的视觉功能本身完全不受影响。
这一刀的价值在于:它证明零追踪改造不能只看"显式的追踪 SDK",第三方库内嵌的日志通道才是最难发现的暗角。
零追踪之上:Box 的完整隐私矩阵
移除 Firebase 与 Clearcut 只是"做减法",Box 的隐私设计还包括一整套"做加法":
| 机制 | 实现位置 | 作用 |
|---|---|---|
| 硬离线模式 | OfflineMode.kt | 开启后所有网络请求直接抛异常,彻底气隙 |
| 加密审计日志 | SecurityAuditLog.kt | 安全事件只写本地日志,注释明言 "No network" |
| 输入净化与日志脱敏 | SecurityUtils.kt | sanitizePrompt 过滤控制字符,redactForLog 防止完整提示词进日志 |
| SQLCipher 加密数据库 | BoxChatDatabase.kt | 聊天记录 AES-256 静态加密 |
| 生物识别应用锁 | AppLockManager.kt | 每次回到前台自动重新上锁 |
其中 SecurityUtils.secureDelete() 甚至实现了三段式覆写(随机数→全零→随机数)再删除文件,这种细节正是隐私工具的"成色"所在。
总结:如何借鉴 Box 的零追踪思路
如果你是 Android 开发者,或者只是关心隐私的普通用户,Box 的改造实录给出了三条可复用的经验:
- 追踪代码要连依赖、Manifest、调用点、初始化四处一起删,只关开关不算数;
- 警惕第三方库的内嵌日志通道(如 Clearcut),显式 SDK 只是冰山一角;
- 隐私是架构而非功能——硬离线、本地加密审计、日志脱敏应默认开启,而不是藏在设置深处。
Box 用一次版本更新证明:一个功能丰富的 AI 套件,完全可以做到"无云、无账号、无追踪"。它的完整功能列表与版本记录,可以在仓库主文档 README.md 的 Changelog 中查证(v3.4.5 条目),Android 端源码位于 Android/src/app/ 目录。

