Parent: #17 ## 背景 后台刷新与低余额通知需要两个纯决策逻辑。为守住「:core 决定应做什么,:app 决定用 Android 怎么做」的边界,并让它们能被现有 `:core:test`(JVM、无设备)覆盖,必须放 `:core`(`:app` 无测试设施,引入 Robolectric 属新依赖)。 ## LowBalancePolicy 输入:`balance: Double`、`threshold: Double`(默认 1.0)、`alerted: Boolean`(上次提醒状态,由 App 层持久化)。 输出:`LowBalanceDecision(shouldNotify: Boolean, alerted: Boolean)`。 | 条件 | shouldNotify | alerted | | --- | --- | --- | | balance <= 0 | false | 不变 | | 0 < balance < threshold 且 alerted == false | true | true | | 0 < balance < threshold 且 alerted == true | false | true | | balance >= threshold | false | false(恢复重置) | - 不依赖 `NotificationManager` / `Context` / `SharedPreferences` / `androidx.work` - `alerted` 持久化由 App 层负责(SharedPreferences 非敏感标志),policy 只返回新状态 ## BackgroundRefreshDecision 输入:`PlatformErrorKind` + `apiCode`(40002/40003 判定复用 `PlatformException.isTokenExpired`)。 输出:平台无关枚举 `RETRY | COMPLETE`;App 层 Worker 映射为 `Result.retry()` / `Result.success()`。 | 情况 | 决策 | 理由 | | --- | --- | --- | | 无 Token | COMPLETE | 需用户登录,重试无意义 | | NETWORK | RETRY | 临时网络异常 | | 40002 / 40003 | COMPLETE | 避免失效 Token 无限重试 | | 其他 HTTP / API / DECODING | COMPLETE | 不可恢复,避免无休止重试 | ## 测试(:core:test 新增) - `LowBalancePolicyTest`:balance=0 / <threshold / =threshold / >threshold;首次低余额通知;重复低余额不通知;恢复后 alerted 重置;恢复后再次跌破可再通知 - `BackgroundRefreshDecisionTest`:NETWORK→RETRY;EMPTY_TOKEN / TokenExpired(40002,40003) / HTTP / API / DECODING→COMPLETE 不得在 Core 测试中直接测试 NotificationManager / WorkManager / Context / Permission Launcher(属 App 层)。 ## 验收条件 - [ ] `./gradlew :core:test` 全绿 - [ ] :core 未新增任何 androidx 依赖(返回领域枚举,不引用 `ListenableWorker.Result`) ## 涉及文件 - 新增 `android/core/src/main/kotlin/com/deepseek/meter/core/LowBalancePolicy.kt` - 新增 `android/core/src/main/kotlin/com/deepseek/meter/core/BackgroundRefreshDecision.kt` - 新增对应测试文件 ## 阻塞关系 - Blocks: #15(其 Worker 消费本策略)
Activity
Qiyuanqiii commentedon Aug 16, 2026
PR 已提交:#20。四个 commit:两个纯策略(:core,零 androidx 依赖)+ 两个测试类(16 个用例)。合并后解除 #15 的「纯策略」阻塞。