# 短信看门狗

**Repository Path**: bllose/SMS_Watchdog

## Basic Information

- **Project Name**: 短信看门狗
- **Description**: 短信看门狗。 你是否遇到交警的劝离短信未能及时察觉，导致错过驶离窗口期，最终吃了罚单。通过本看门狗，可以监听交警短信，并通过“闹钟”，“转发短信”，“转播电话”等方式最大限度提醒所有人。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SMS Watchdog

短信看门狗 — 监听 Android 手机接收的短信，按关键词或正则表达式匹配，自动执行预设动作。  

## 功能

- **短信监听**：后台实时拦截收到的短信
- **灵活匹配**：支持普通文本关键词和正则表达式，自动识别
- **转发短信**：匹配时自动将短信内容转发到指定号码（支持 `{body}` 模板变量）
- **触发闹钟**：匹配时发出全屏闹钟提醒（支持自定义标签）
- **拨打电话**：匹配时自动拨打预设号码
- **前台服务**：持久通知保活，后台不被系统杀死
- **数据持久化**：所有配置实时保存，重启/更新不丢失

## 截图

| 图片展示                               |                                  | |
|------------------------------------|----------------------------------| --- |
| ![图片1](./resources/1920_862_1.jpg)  | ![图片2](resources/1920_862_2.jpg) | ![图片5](./resources/1920_862_5.jpg) |

## 权限说明

| 权限 | 用途 |
|------|------|
| RECEIVE_SMS | 接收并读取短信内容进行匹配 |
| SEND_SMS | 匹配后自动转发短信到目标号码 |
| READ_SMS | 读取短信内容 |
| CALL_PHONE | 匹配后自动拨打电话 |
| POST_NOTIFICATIONS | 发送匹配通知和前台服务通知 |
| SCHEDULE_EXACT_ALARM | 触发精确闹钟提醒 |
| FOREGROUND_SERVICE | 保活前台服务，持续监听短信 |
| VIBRATE | 闹钟触发时振动 |

## 开发环境

- **语言**：Kotlin
- **最低 SDK**：Android 8.0 (API 26)
- **目标 SDK**：Android 15 (API 36)
- **构建工具**：Gradle + Android Gradle Plugin
- **UI**：Material Design 3 + ViewBinding

## 项目结构

```
app/src/main/java/com/bllose/smswatchdog/
├── MainActivity.kt          # 主界面
├── MainViewModel.kt         # 状态管理
├── SmsReceiver.kt           # 短信广播接收器
├── ActionExecutor.kt        # 动作执行器（转发/闹钟/拨号）
├── AlarmReceiver.kt         # 闹钟广播接收器
├── WatchdogService.kt       # 前台保活服务
├── PreferenceManager.kt     # SharedPreferences 持久化
├── PermissionHelper.kt      # 权限检查与申请
└── model/
    ├── ActionType.kt        # 动作类型枚举
    ├── ActionConfig.kt      # 动作配置数据类
    └── AppUiState.kt        # UI 状态数据类
```

## 构建与安装

```bash
# 编译 debug APK
./gradlew assembleDebug

# 安装到设备
adb install app/build/outputs/apk/debug/app-debug.apk

# 模拟发送短信测试
adb emu sms send 13800138000 "您的验证码是123456"
```

## 许可证

MIT License