# keep_accounts

**Repository Path**: cendaifeng/keep_accounts

## Basic Information

- **Project Name**: keep_accounts
- **Description**: 利用微信、支付宝账单记账小脚本
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 1
- **Created**: 2021-12-24
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# keep_accounts
能够实现微信、支付宝官方导出账单的读取合并，为每笔帐标记类型。不用消费一笔记一笔，每月仅需20分钟，记好所有的帐。

# 如何使用

### 第一步 下载账单

**微信账单**
1. 进入手机版微信，选择 “我”，进入用户中心界面，然后点击 “支付” 选项；
2. 点击 “钱包”，进入钱包界面后，点击右上角的 “账单” 按钮；
3. 点击右上角“常见问题”，点击“下载账单”->“用于个人对账”；
4. 自定义账单时间，然后点击 “下一步”；
5. 填写要导出的邮箱（微信会把账单发送到你填写的邮箱），点击 “下一步”；
6. 输入支付密码，提示申请已提交，微信官方会给你发送一条消息，里面有账单的解压码；
8. 前往你的邮箱下载得到压缩包，用解压码解压得到 .csv 格式微信账单，导出成功。

**支付宝账单**
1. 电脑浏览器中打开支付宝官网 https://www.alipay.com/
2. 点击右上角“客户服务”->“自助服务”；
3. 在“交易服务”中点击“交易记录”一项；
4. 扫码登录；
5. 选择交易时间，并选择下载 excel 格式，得到 .zip 压缩包（其实是 .csv 格式，这是一种更轻便的文本格式）；
6. 解压压缩包得到 .csv 格式的支付宝账单，导出成功。

**备注：**
商家用户请勿从商家中心导出，否则数据格式不同无法使用本程序导入账单。请按以上步骤或切换至个人版页面导出。

### 第二步 运行分类脚本合并账单
1. 运行 keep_accounts 目录下的 **classify_csv.py**
2. 该脚本会自动将微信和支付宝账单合并输出到 **merge.xlsx** 中，并半自动地分好类
3. 分类逻辑是检测支付记录是否包含 **关键字** ，用户可以在 classify 函数的每一项分类的 join() 列表中自定义
4. 分类通常不能够将所有的记录识别，打开 **merge.xlsx** 将末尾未分类的记录手动分类，保存

### 第三步 运行聚合脚本聚类分析账单
1. 运行 keep_accounts 目录下的 **aggregation_xl.py**
2. 该脚本会自动将上一步骤分类好的数据进行聚合，输出每项分类总额、最大值等信息
3. 生成 **result.xlsx**

# 测试用例

```python
DIDI-C02FL3F1Q05D:keep_accounts didi$ python3 ./classify_csv.py ./test_wx.csv ./test_alipay.csv
成功读取 142 条「微信」账单数据
成功读取 49 条「支付宝」账单数据
总计合并数据 191 条

分类 [简餐] 数据 61 条
分类 [饕餮 & 社交] 数据 4 条
分类 [零食] 数据 26 条
分类 [交通] 数据 69 条
分类 [通信 & 月付产品] 数据 5 条
## 未分类数据 27 条
write successfully!
```

```python
DIDI-C02FL3F1Q05D:keep_accounts didi$ python3 ./aggregation_xl.py 
        总支出       分类  金额_max   金额_sum
0       NaN       交通   55.44   987.27
1       NaN       其他    7.50     7.50
2       NaN    学习&文具   63.00   115.80
3       NaN     日用起居   68.00   253.90
4       NaN       简餐   38.00  1035.13
5       NaN       衣物  890.00  1946.43
6       NaN      购物欲   88.00    88.00
7       NaN  通信&月付产品  178.00   314.00
8       NaN       零食   45.00   551.93
9       NaN    饕餮&社交  218.00   513.92
10  5813.88      NaN     NaN      NaN
write successfully!
```