# our-sms

**Repository Path**: fbbzl/our-sms

## Basic Information

- **Project Name**: our-sms
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-18
- **Last Updated**: 2026-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 短信转发

这是一个只在本机运行的 Android 短信转发工具：监听小米短信应用的通知，匹配后转发原文或通知正文到预设手机号。

## 规则

- 可保存多个转发号码；从“选择转发号码”中勾选一个或多个号码后才会转发。
- 发件号码或通知标题关键词、短信正文关键词至少填写一项；两项都不填写时不能启用转发。
- 只填写第一项时，匹配原始发件号码或小米短信通知标题；只填写正文关键词时，匹配原始正文或通知正文。
- 已填写的条件必须同时满足。
- 关闭“启用自动转发”后，应用不再转发。

应用不需要网络权限，不会上传或在状态记录中保存短信内容。它仅处理包名为 `com.android.mms` 的小米短信通知；通知正文被脱敏为“有新信息”时，会读取本机短信库中的对应原文。界面仅保留最近 20 条状态。

## 在手机上运行

1. 用 Android Studio 打开本目录。
2. 安装 Android SDK Platform 35，然后同步项目。
3. 连接手机并运行，或在 Android Studio 中生成 debug APK 后安装。
4. 打开应用，保存手机号并选择一个或多个转发号码，填写可选规则，开启自动转发，并授予“读取短信”和“发送短信”权限。
5. 在应用中点击“授权通知使用权”，在 HyperOS 设置中启用“短信转发通知监听”。
6. 确保小米短信应用的通知处于开启状态，且通知内容可显示。

本项目已经生成 debug APK。连接并授权开启 USB 调试的手机后，可从项目目录执行：

```powershell
D:\Android\Sdk\platform-tools\adb.exe install -r .\app\build\outputs\apk\debug\app-debug.apk
```

安装后仍需在应用内按系统提示手动授权“读取短信”和“发送短信”，并在系统设置中手动授予通知使用权。

## 本机开发目录约定

开发工具和缓存统一放在 D 盘：

```powershell
$env:ANDROID_HOME = 'D:\Android\Sdk'
$env:ANDROID_SDK_ROOT = 'D:\Android\Sdk'
$env:ANDROID_USER_HOME = 'D:\Android\.android'
$env:GRADLE_USER_HOME = 'D:\Android\.gradle'
```

在 Android Studio 的 SDK Manager 中将 SDK Location 设为 `D:\Android\Sdk`；如果使用命令行，再把 Android SDK、Gradle 和各自缓存目录都指定到 `D:\Android` 下。不要使用用户目录下的默认 SDK 或 Gradle 缓存路径。

在红米 K80 / HyperOS 上，将本应用设为允许自启动和“不受限制”电池策略。通知监听依赖小米短信应用显示通知；若通知正文被隐藏，应用会尝试读取本机对应短信原文。

本机可在项目目录执行 `./build-debug.ps1`，生成的 APK 位于 `app/build/outputs/apk/debug/app-debug.apk`。