docs: sync CLAUDE.md to v1.5.0

- version 1.2.0/code 3 -> 1.5.0/code 8 (was badly stale)
- package table: add PhoneCallMonitor/ConnectivityMonitor/CarrierDetector/
  CarrierBalanceQuery/SmsFallbackForwarder/UpdateChecker; fix A2iApp holders
- core data flow: add offline SMS-fallback branch + phone/update side paths
- pipeline: 12 -> 14 steps (sent-SMS filter, carrier-balance interception)
- release flow: actual python+gh-token.txt process (no gh CLI)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

CLAUDE.md

@@ -55,17 +55,21 @@ adb install -r app/build/outputs/apk/release/app-release.apk
 
 ```
 NotifyListenerService (系统通知入口)
-  → NotificationProcessor.process(sbn) → Decision(message, reason, code)
-  → BarkClient.push(msg) → OkHttp POST
-  → LogStore.addLog(...)
-失败 → 加入 pending → RetryWorker (WorkManager, 15min 周期)
+  → NotificationProcessor.process(sbn) → Decision(message?, reason, code, silent)
+    ├─ 在线：BarkClient.push(msg) → OkHttp POST；失败入 pending → RetryWorker (15min 周期)
+    └─ 离线：紧要通知(验证码/来电) → SmsFallbackForwarder 走短信兜底
+  → LogStore.addLog(...)（silent 的静默过滤不写日志）
+
+旁路（不经通知监听器）：
+  PhoneCallMonitor 轮询 getCallState() → 来电/未接构造 Decision 推送（绕过 MIUI 限制）
+  UpdateChecker 查 GitHub Releases → 新版本横幅 → 应用内下载 + 系统安装器
 ```
 
 ### 包结构 `com.a2i.forwarder`
 
 | 文件 | 职责 |
 |---|---|
-| `A2iApp.kt` | `Application` 单例；持有全局 `appScope` 和三个 Store（`settings`、`appRules`、`logStore`）。Store 都用 `MutableStateFlow`，UI 通过 `collectAsState()` 订阅。 |
+| `A2iApp.kt` | `Application` 单例；持有全局 `appScope`（`SupervisorJob+Dispatchers.Default`）与全局组件：三个 Store（`settings`/`appRules`/`logStore`）+ 监听类（`phoneCallMonitor`/`connectivityMonitor`/`carrierBalanceQuery`/`smsForwarder`/`updateChecker`）。全部经 `A2iApp.instance.xxx` 访问，`onCreate` 构造并 `start()`。UI 通过 `collectAsState()` 订阅 Store 的 `StateFlow`。 |
 | `service/NotifyListenerService.kt` | `NotificationListenerService` 实现；每条通知调 `processor.process()`，过滤后推送。 |
 | `core/NotificationProcessor.kt` | **核心决策点**。包含 LRU 去重缓存（5s）、脱敏检测（`*****` → 回退到 `tickerText`）、系统状态消息过滤、广告过滤、验证码提取、特殊 App 解析。返回 `Decision(message?, reason, appLabel, code)`。 |
 | `core/CodeExtractor.kt` | 三段正则：关键词+数字、数字+关键词、纯数字 4-8 位。检测到全 `*****` 时直接返回 null。 |
@@ -75,11 +79,17 @@ NotifyListenerService (系统通知入口)
 | `core/RetryWorker.kt` | WorkManager 周期任务，每 15 分钟重发 `pending` 队列中的失败消息。 |
 | `core/LogStore.kt` | 最近 300 条日志 + 失败重发队列（≤100）。DataStore 持久化。 |
 | `core/IconExporter.kt` | 一键导出所有已安装 App 图标到用户选择的 SAF 目录（用于部署到 iOS Bark 图床）。 |
+| `core/PhoneCallMonitor.kt` | 轮询 `TelephonyManager.getCallState()`（800ms）感知来电/未接来电，构造 Decision 推送。绕过 MIUI 不向第三方监听器分发系统电话通知的限制。 |
+| `core/ConnectivityMonitor.kt` | `ConnectivityManager` + `NetworkCallback`，暴露 `isOnline: StateFlow<Boolean>`，供离线兜底判断。 |
+| `core/CarrierDetector.kt` | SIM MCC+MNC 映射到运营商（移动/联通/电信/广电），供短信兜底发免费查询码。 |
+| `core/CarrierBalanceQuery.kt` | 向运营商服务号发查询短信、解析回执余量、余额≤5 自动挂起。 |
+| `core/SmsFallbackForwarder.kt` | 断网时把紧要通知（验证码/来电）用短信发到 iPhone，5 分钟限频 + 余额检查。 |
+| `core/UpdateChecker.kt` | 查 GitHub Releases 最新版（24h 节流）→ 语义比较 → 下载 APK → FileProvider 调起系统安装器。 |
 | `store/SettingsStore.kt` | Bark 服务器列表、全局开关、广告关键词等。`MutableStateFlow` + DataStore。 |
 | `store/AppRulesStore.kt` | 黑/白名单模式 + 默认黑名单（系统 App + 三星剪贴板/键盘 + GMS）。 |
 | `ui/nav/AppNav.kt` | 4 个底部 Tab + 日志页。 |
 | `ui/theme/*` | 固定品牌配色（`Color.kt`）、自定义 `Typography`（`Type.kt`），`A2iTheme` 关闭动态取色、统一深浅色方案（`Theme.kt`）。 |
-| `ui/screens/*.kt` | HomeScreen（品牌横幅 + 运行状态面板 + 统计指标）、AppManageScreen、FilterScreen、SettingsScreen、LogScreen。 |
+| `ui/screens/*.kt` | HomeScreen（品牌横幅 + 运行状态 + 统计 + 更新横幅 + 短信挂起提醒）、AppManageScreen、FilterScreen、SettingsScreen（Bark 服务 / 应用图标 / 断网短信兜底 / 关于与更新）、LogScreen、UpdateDialog（应用内更新弹窗）。 |
 | `ui/Components.kt` | 共享 UI 组件层：`ScreenTitle`、`SectionCard`、`SwitchRow`、`ClickRow`、`IconBox`、`StatusBadge`、`MetricBlock`，以及 `appVersionName(context)`、`drawableToImageBitmap(d)`、`isNotificationListenerEnabled(context)` 工具函数。 |
 
 ### 重要约定
@@ -87,9 +97,9 @@ NotifyListenerService (系统通知入口)
 - **Store 全局单例**：所有 Store 通过 `A2iApp.instance.xxx` 访问。**不要**在 Compose 中创建新的 Store 实例。
 - **协程作用域**：跨屏调用用 `app.appScope.launch { ... }`（Application 级别的 `SupervisorJob + Dispatchers.Default`）。
 - **过滤流水线**（顺序很重要，在 `NotificationProcessor.process` 中）：
-  1. 全局开关 → 2. ongoing 过滤 → 3. App 黑/白名单 → 4. 空内容/脱敏 → 5. 噪音包名 → 6. 系统状态消息 → 7. 近空内容 → 8. 广告过滤 → **9. 去重检查（5s 窗口）** → 10. 验证码提取 → 11. 特殊 App 解析 → 12. 构造 BarkMessage
+  1. 全局开关 → 2. ongoing 过滤（静默）→ 3. App 黑/白名单 → 4. 空内容/脱敏 → 5. 噪音包名 → 6. 系统状态消息 → 7. 近空内容 → 8. 广告过滤 → 9. 已发短信（仅收不发）→ 10. 运营商余额回执拦截 → **11. 去重检查（5s 窗口）** → 12. 验证码提取 → 13. 特殊 App 解析 → 14. 构造 BarkMessage
 - **Bark API** 字段映射在 `BarkMessage.kt`（`@SerialName`）：`device_key`/`autoCopy`/`isArchive` 用下划线/驼峰别名，其他用蛇形。
-- **版本号**：`app/build.gradle.kts` 的 `versionCode`/`versionName`，运行时通过 `appVersionName(context)` 读取，首页底部居中显示 `v{version}`。改完代码记得同步递增。
+- **版本号**：`app/build.gradle.kts` 的 `versionCode`/`versionName`，运行时通过 `appVersionName(context)` 读取，首页底部居中显示 `v{version}`。**改完代码同步递增 versionCode/versionName，并更新本文档「版本与发布」一节的当前版本。**
 
 ### 通知监听授权
 
@@ -101,8 +111,11 @@ NotifyListenerService (系统通知入口)
 
 ## 版本与发布
 
-- 当前版本：`versionCode = 3`、`versionName = "1.2.0"`（位于 `app/build.gradle.kts`）。改完代码记得同步递增。
+- 当前版本：`versionCode = 8`、`versionName = "1.5.0"`（位于 `app/build.gradle.kts`）。**每次改动后同步递增 versionCode/versionName，并同步更新本节。**
 - 远端仓库：`https://github.com/lsxf/a2i.git`，默认分支 `main`。
-- 提交策略：`.gitignore` 已排除 `app/build`、`.gradle`、`.kotlin`、`local.properties`、`.claude/`、`do.ps1`、截图与临时文件，**不要**提交它们。
-- 发版流程：本地打 tag（`git tag -a v1.2.0 -m "..."`）→ `git push origin v1.2.0` → 在 GitHub Releases 基于 tag 发布，并上传 `app-release.apk` 作为二进制附件。
+- 提交策略：`.gitignore` 已排除 `app/build`、`.gradle`、`.kotlin`、`local.properties`、`.claude/`、`do.ps1`、`gh-token.txt`（发版用 token）、`*.token`、截图与临时文件，**不要**提交它们。
+- 发版流程：
+  1. 递增 `versionCode`/`versionName` → `./gradlew assembleRelease`（产物 `app/build/outputs/apk/release/app-release.apk`）
+  2. `git tag -a v{versionName} -m "..."` → `git push origin v{versionName}`
+  3. 本机无 `gh` CLI：用 python(urllib) 调 GitHub API 创建 Release + 上传 APK。token 放仓库根 `gh-token.txt`（已 gitignore），脚本里 `open('gh-token.txt')` 读取，**勿**把 token 写进命令参数。注意 Git Bash 的 `/tmp` 与 Windows python 路径不一致，脚本内一律用项目相对路径。
 - UI 现状：统一品牌科技感主题（固定品牌色 + 自定义 Typography + 共享组件层），深浅色双方案，关闭动态取色；新组件统一通过 `ui/Components.kt` 复用，避免各页面各拼一套样式。