Repository navigation
Closed
Labels
Description
Parent: #17
背景
A4 核心功能。前置:#11(依赖准入与 D6 翻转)、#13(两个纯策略)。
方案
WorkManager 调度
- 依赖:
androidx.work:work-runtime-ktx(版本以 deps(android): 引入 androidx.work 依赖准入并翻转 MOBILE-PLAN D6 决策 #11 结论为准,≥ 2.8.0) - 唯一任务名:
deepseek-meter-background-refresh - 策略:
ExistingPeriodicWorkPolicy.UPDATE - 约束:
NetworkType.CONNECTED - 周期:≥ 15 分钟(Best Effort,不承诺精确时间)
BackgroundRefreshWorker 流程
1. 读 lowBalanceAlertsEnabled == false → Result.success()(防御性 early-return)
2. KeystoreTokenStore 读 Token;无 Token → Result.success()
3. PlatformService.fetchSummary(),取 normalWallets.firstOrNull()(与 AppModel 同规则,保证通知币种与 UI 一致)
4. 读上次 alerted 状态 → LowBalancePolicy.evaluate()
5. shouldNotify 且 areNotificationsEnabled() → LowBalanceNotifier.notify()
6. 持久化新的 alerted 状态
7. 错误映射:BackgroundRefreshDecision → RETRY→Result.retry();COMPLETE→Result.success()
Token 严禁进入 WorkManager InputData(会落 WorkManager 数据库),由 Worker 自行从 Keystore 读取。
通知开关闭环
- OFF→ON:未授权→解释用途并请求;已授权→保存
enabled=true→enqueueUniquePeriodicWork(UPDATE) - ON→OFF:保存
enabled=false→cancelUniqueWork(...)→ 重置 alerted 状态 - 双保险:Worker 每次执行先检查开关
通知权限三态(Android 13+ POST_NOTIFICATIONS)
- 未请求:设置页开启开关时解释用途并请求
- 曾拒绝但仍可请求:以
areNotificationsEnabled()为事实依据;shouldShowRequestPermissionRationale仅作提示参考,不自动弹窗骚扰 - 永久拒绝:开关保持 disabled + 提示「通知权限已关闭,请在系统设置中允许」+ 提供系统设置入口
拒绝时余额/用量/趋势/登录等所有非通知功能必须完全正常。
币种、阈值与去重
- 阈值:
0 < balance < 1.0,1.0 表示「当前钱包币种的一个单位」(CNY→¥1.00、USD→$1.00) - 通知文案用
currencySymbol(currency),不硬编码 ¥ alerted状态持久化于 SharedPreferences(非敏感标志)
NotificationChannel
- minSdk 26 起创建 Channel;纯本地通知,无任何第三方推送
验收条件
- 多次进入设置页 / 重启不产生多个后台 Worker
- 关闭开关后 Unique Work 被 cancel;即使被系统调度也立即 success 不联网
- 低余额首次出现通知一次;持续低余额不重复;恢复重置;再次跌破再通知
- Token 失效(40002/40003)→ success 不无限重试;临时断网 → retry
- 非 CNY 钱包阈值与文案使用实际币种
- 拒绝/永久拒绝通知权限不影响其他功能;永久拒绝有系统设置入口
- Token 不出现在 Logcat / WorkManager Data / SharedPreferences 明文
涉及文件
android/app/build.gradle.kts(新增 work 依赖)- 新增
android/app/src/main/kotlin/com/deepseek/meter/app/background/BackgroundRefreshWorker.kt - 新增
android/app/src/main/kotlin/com/deepseek/meter/app/background/BackgroundRefreshScheduler.kt - 新增
android/app/src/main/kotlin/com/deepseek/meter/app/notification/LowBalanceNotifier.kt android/app/src/main/kotlin/com/deepseek/meter/app/SettingsScreen.kt(通知开关 + 权限三态 UX)android/app/src/main/AndroidManifest.xml(POST_NOTIFICATIONS)
阻塞关系
- Blocked by: deps(android): 引入 androidx.work 依赖准入并翻转 MOBILE-PLAN D6 决策 #11(依赖准入)、feat(android-core): LowBalancePolicy 与 BackgroundRefreshDecision 纯策略 + JVM 测试 #13(纯策略)
非目标
- ❌ 后台余额快照冷启动复用(独立增强 / A5)
- ❌ Firebase / 第三方推送
Activity
Qiyuanqiii commentedon Aug 16, 2026
PR 已提交:#23。6 个 commit:Worker / Scheduler / Notifier / gradle 依赖 / manifest 权限 / 设置页开关。阻塞项(#11、#13)已解除。请 review;真机通知矩阵在 #16 QA 阶段执行。