SparkKeeper · 抖音自动续火助手

基于 Quan-Robin/douyin-spark（douyin-spark-mobile）的修改版，包名 com.spark.keeper。 通过 Android 无障碍服务 操作抖音「消息」页，自动给好友发送续火消息，保持每日联系。

工作原理

• 无障碍服务 SparkService 接管屏幕，逐级完成「打开会话 → 输入 → 发送」。
• 协议模式（ProtocolService）可将一段 JS 注入抖音私信 WebView（douyin.com/messages），通过 SparkBridge.step() 回传状态。
• 定时任务由 RTC_WAKEUP 闹钟 + PARTIAL_WAKE_LOCK 驱动，息屏也能触发（需屏幕可点亮）。

相对原版的修复（v0.6.1 – v0.6.3）

版本	修复
0.6.1	根因修复：旧版 gotoMessages() 不看前台是谁就盲按 BACK，从聊天页起步会一路退到桌面、甚至弹出「卸载」框。现改为「前台非抖音则重新拉起抖音，绝不乱按 BACK」；消息列表页不再白等 3.6s。
0.6.2	执行提速：逐好友流程的等待统一下调约 30–40%（单好友约 13–15s → 8–10s）。
0.6.3	等待解锁超时默认由 8 小时改为 10 分钟（无法自动解锁时最多等 10 分钟放弃本次）。

构建

需要 JDK 17 + Android SDK（build-tools 34） + Python（Pillow 可选，用于生成图标）。

cd apk
ANDROID_SDK=/你的/android-sdk  JDK_HOME=/你的/jdk-17  bash build.sh
# 产物：../SparkKeeper.apk
# 若真机运行异常，加 NO_SHRINK=1 回退到纯 d8（不裁剪）

首次构建若缺少 debug.keystore 会自动生成（debug 签名）。正式发布请换成你自己的签名。

安装与权限

1. 安装 SparkKeeper.apk（同签名可覆盖安装）。
2. 开启 无障碍服务（设置 → 无障碍 → 续火助手）。
3. 授予 悬浮窗 / 显示在其他应用上层 权限。
4. 在 App 内点「立即运行一次」或配置定时。
5. （可选）开启「处理锁屏」并填写 PIN，配合 Root / 无障碍解锁可实现息屏全自动。

目录结构

apk/
├── src/com/spark/keeper/   # 全部 Java 源码
├── res/                    # 资源（布局、图标、无障碍配置）
├── libs/                   # Shizuku 依赖 jar
├── AndroidManifest.xml
├── build.sh                # 手工构建链（aapt2→javac→d8→zipalign→apksigner）
├── make_icons.py
└── proguard-rules.pro
docs/                       # 问题诊断与修复说明

免责声明

本项目仅供 个人学习与技术研究 使用。自动化操作第三方平台可能违反其服务条款，由此导致的账号限制、封禁等风险由使用者自行承担。请遵守所在地区法律法规与平台规则，勿用于骚扰或批量营销。

致谢

• 原始项目：Quan-Robin/douyin-spark