Skip to content

WRCoding/FinBot

Repository files navigation

FinBot - 个人财务管理助手

FinBot是一个基于WeChatFerry + DeepSeek 打造的微信个人记账管理助手,能够通过 微信自动捕获、记录个人交易数据,并提供汇总和AI对话分析数据功能。

开发这个Bot的目的是在于有记账的需求,以前会采用手动记账的形式,但时间久了手动记有点麻烦而且容易忘了要记账,虽然微信支付里 微信记账本,但有时候不通过微信进行的花销就没法进行记录了。某天发现银行卡有微信提醒的功能,每一笔交易都会通过对应的公众号进行 通知,那这样的就有完整的交易记录获取了,毕竟钱都是从银行卡进出(至少本人是)。于是找到了开源的WeChatFerry来获 取微信银行公众号的交易信息并使用DeepSeek来对交易信息进行解析写入飞书文档。并通过DeepSeek用自然语言的方式来分析和获取交易数据。有这类需求的可以看看

所有数据都不会上传,包括写入的飞书文档都是你自己控制

使用前提:最好有个微信小号,闲置的电脑或者买个服务器(需要是Windows),使用的银行卡支持微信通知。如何使用WeChatFerry 以及注意事项可点击链接查看

核心功能

1. 交易信息捕获与处理

  • 识别并解析微信中的银行交易提醒消息 使用WeChatFerry来识别微信里银行公众号的交易信息,交给DS进行解析写入飞书文档
  • 智能识别交易类型、金额、时间等关键信息
image

2. 数据存储与管理

  • 本地SQLite数据库存储交易记录
  • 自动同步数据至飞书电子表格,便于远程访问和共享 image

3. 交易数据分析

  • 提供日常交易数据汇总与分析
  • 支持按日期查询交易记录
  • 生成每日收支汇总报告
  • 通过AI对话辅助分析交易数据及趋势
image image

4. 多平台集成

  • 微信机器人实时接收并处理消息
  • 飞书数据同步与展示
  • 支持通过简单指令查询财务信息

项目结构

FinBot/
├── ai/                 # AI服务集成模块
├── analysis/           # 财务数据分析模块
├── db/                 # 数据库模型和服务
│   ├── models/         # 数据模型
│   └── services/       # 数据库服务
├── feishu/             # 飞书API集成
├── scheduler/          # 定时任务管理
│   └── jobs/           # 具体任务实现
├── util/               # 通用工具函数
├── config.py           # 配置文件
├── finbot.py           # 机器人核心实现
├── main.py             # 程序入口
├── parse_msg.py        # 消息解析模块
└── requirements.txt    # 项目依赖

使用指南

安装依赖

pip install -r requirements.txt

配置项目

  1. 修改config.py,填入相应Key

启动服务

python main.py

支持的指令

  • #今日数据 - 查询今日交易记录
  • #昨日数据 - 查询昨日交易记录
  • #汇总@日期 - 指定日期的收支汇总(如:#汇总@2023-01-01
  • @DS - 与AI助手对话,分析财务数据

FinBot让个人财务管理变得简单高效,通过自动化的数据捕获和智能分析,帮助用户更好地了解自己的财务状况,实现财务目标。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages