# 轻记 1.1.3 · 微信／支付宝支付通知自动记账

## 安装与开启

1. 安装 `轻记-1.1.3.apk`。与提供的 1.0.0 使用相同签名，可覆盖升级，数据库会保留原有账目与预算；建议升级前先做一次 JSON 备份。
2. 打开轻记 → **我的** → **支付通知自动记账**。
3. 开启 **自动记录新付款**，阅读说明并选择 **同意并开启**。
4. 在系统的 **通知读取／通知使用权** 设置中允许 **轻记 · 支付通知记账**。系统名称因手机型号而异。
5. 返回轻记，确认显示 **监听已连接**。可以分别选择微信支付、支付宝；关闭总开关即暂停记账。
6. 保持微信、支付宝的付款通知开启，并显示金额。下一次真实付款后，核对账本中是否出现标有 **自动** 的账目。

通知识别规则目前仅用合成数据测试，没有在真实手机上的微信／支付宝通知中验证。连接成功只代表系统已连接监听器，不代表所有付款通知都能识别。

## 会记录什么

只处理来自微信 `com.tencent.mm` 和支付宝 `com.eg.android.AlipayGphone`、具有匹配标题和明确付款成功金额的新通知。保存为一笔支出，分类为 **其他**，备注标注微信支付／支付宝及自动记录；如果明确给出商户，也会记录商户。可以点击账目修改、分类或删除。

开启前的通知、汇总通知、缺少金额或含歧义金额的通知不入账。退款、转账、红包、收款、还款、充值、提现等当前不自动处理，按实际需要手动记账。不会自动冲销后来退款的原支出。

有原始时间的通知按应用、通知标识和时间去重；缺少原始时间时使用系统发布时间，并保存临时通知身份来识别重复回调。通知移除后释放临时身份。删除自动账目后保留去重标记，避免同一通知又创建该账目。不同标识或不同原始时间仍可能重复，用户需要核对。新 JSON 备份包含来源和去重信息，并兼容旧版备份。

## 无法直接读取完整个人账单

这是在安卓系统授权后识别可见通知，不是微信／支付宝个人交易接口，也不读取密码、余额或历史账单。通知只包含部分信息，不能证明实际扣款；聊天中仿造的付款文字也不能作为付款凭证。

微信／支付宝未发送通知、应用在前台未展示通知、正文隐藏金额、通知格式变化或系统限制后台运行时，可能漏记。自动账目需要和实际账单核对。

## 排查

- **待授权通知读取**：点击授权按钮，按系统提示授予轻记通知读取权限。
- **已授权，等待系统连接**：点击 **重新连接监听**；必要时重新进入系统设置授权。
- **提示受限设置**：侧载安装的应用可能需要先在系统的轻记应用详情页，按系统提示允许受限设置。如果设备管理策略禁止，请改为手动记账。入口随设备而异，可参照 [Android 官方说明](https://support.google.com/android/answer/12623953?hl=zh-Hans)。
- **连接正常但漏记**：核对付款是否实际产生了含金额的通知；查看轻记显示的最近通知及处理结果。部分手机还需要允许应用自启动或后台运行。
- **不想继续使用**：关闭总开关。若要撤销系统授权，点击 **查看／撤销通知授权** 后在系统设置关闭轻记。

## 隐私与权限

安卓通知读取授权范围较广。轻记在回调中先筛选应用，再筛选支持的付款标题；不解析其他应用内容，不保存原始通知，不上传数据。应用不申请网络、短信、通讯录或无障碍权限。被识别后的金额、日期、来源和商户信息会成为本地账目，通知去重标识以 SHA-256 摘要保存。

使用的是安卓官方的 [NotificationListenerService](https://developer.android.com/reference/android/service/notification/NotificationListenerService)。通知内容也可能受到系统隐私保护限制；例如 [Android 15 对敏感通知的保护](https://developer.android.com/about/versions/15/behavior-changes-all)。

## 1.1.3 修复说明与验证步骤

此版修复缺失通知时间戳、只有普通正文或多行正文包含金额时的漏记，并修复“最近收到通知”出现但处理结果空白的问题。升级保留账目和预算，使用同一开发签名，可覆盖安装，无需卸载。

1. 升级前从“我的”导出 JSON 备份，然后覆盖安装新版 APK。
2. 确认“我的”显示版本 **1.1.3**，自动记录开关已开启、通知读取已授权、监听已连接。
3. 等待下一笔真实付款通知，查看“最近保存成功”和“已保存自动账目”数量；到对应月份、清除分类及搜索筛选后核对支出。
4. 若仍未保存，界面会说明标题不支持、金额缺失或歧义、时间异常、重复通知或本地处理失败。请提供状态文字及隐去个人信息后的付款通知标题与正文，便于继续排查。普通聊天和仅有“新消息”的隐藏正文不会自动记账。

升级不会补录旧版漏记的历史付款，请核对微信／支付宝账单后手动补记。已通过回归检查与构建，仍需你在手机上验证真实通知是否匹配。

## 1.1.3 支付宝实际通知适配

新增支持支付宝标题「交易提醒」、正文「你有一筆15.00元的支出，點此查看詳…」及对应简体文案。识别出明确金额后直接保存，无需手动确认；不会从你发来的截图创建账目。

系统只回调汇总时，检查同一应用和同组中、自动记账开启后发布的单笔子通知，按其原始标识与时间去重。汇总本身的消息条数和合计不作为支出金额。不同正文重复展示同一笔时取完整正文校验。

覆盖安装后，确认显示版本 1.1.3，自动记账开关开启、系统通知读取授权有效、监听已连接。等待下一次正常付款通知，查看自动账目数量与「已自动保存支出」提示；仍需与支付宝账单核对。若旧系统监听未重新连接，可在“我的”请求重新连接。收入、退款、转账或多笔歧义通知仍不记为普通支出。