小遥账单助手
隐私优先的个人账单分析工具，数据完全本地处理，不上传任何服务器
English | 简体中文
简介
小遥账单助手是一个隐私优先的个人账单分析工具，支持支付宝和微信账单的自动解析和多维度数据可视化分析。
核心特点：
- 🔒 隐私安全 - 数据完全本地处理，不上传任何服务器
- 🔐 手动清除 - 随时手动清除账单数据，完全掌控您的财务隐私
- 📊 多维度分析 - 年度、月度、分类、时间、消费洞察
- 📁 多格式支持 - 支付宝 CSV、微信 CSV/XLSX 账单文件
- 🚀 快速部署 - Docker 一键启动，开箱即用
- 💻 前后端分离 - Vue 3 + Flask 架构，易于维护扩展
- 📱 响应式设计 - 支持桌面端和移动端访问
作者介绍
dtsola — IT解决方案架构师 | 一人公司实践者
🌐 个人站点 | 📺 B站 | 💬 微信：dtsola（技术交流 | 商务合作）
微信联系 开发者交流群 用户交流群
功能预览
上传账单 - 一键导入
 |
|
首页 - 功能入口
 |
|
年度总览 - 一目了然
 |
|
月度分析 - 精细对比
 |
|
分类分析 - 花费明细
 |
|
时间分析 - 消费规律
 |
|
消费洞察 - 智能分析
 |
 |
 |
|
交易记录 - 明细查询
 |
|
快速开始
方式一：Docker 一键安装（推荐给普通用户）
环境准备
安装 Docker Desktop（已包含 Docker Compose）：
- Windows：https://docs.docker.com/desktop/setup/install/windows-install/
- Mac：https://docs.docker.com/desktop/setup/install/mac-install/
- Linux：https://docs.docker.com/desktop/setup/install/linux/
启动步骤
# 1. 克隆项目
git clone https://github.com/dtsola/xiaoyaoprivatebill.git
cd xiaoyaoprivatebill
# 2. 一键启动
docker-compose up -d
# 3. 访问应用
# 浏览器打开: http://localhost:8888常用命令
# 查看日志
docker-compose logs -f
# 停止服务
docker-compose down
# 重启服务
docker-compose restart方式二：开发者本地开发
前置要求
- Python 3.10+
- Node.js 18+
- Git
后端设置
# 1. 进入后端目录
cd backend
# 2. 创建并激活虚拟环境（Windows）
py -3.10 -m venv venv
venv\Scripts\activate
# 3. 安装依赖
pip install -r requirements.txt
# 4. 启动后端服务
python app.py
# 后端运行在: http://localhost:5000前端设置
# 1. 进入前端目录（新终端窗口）
cd frontend
# 2. 安装依赖
npm install
# 3. 启动开发服务器
npm run dev
# 前端运行在: http://localhost:3000开发模式命令
# 前端构建生产版本
npm run build
# 预览生产构建
npm run preview
# 后端退出虚拟环境
deactivate使用说明
1. 获取账单文件
支付宝账单：
- 打开支付宝 APP → 账单
- 点击右上角「常见问题」→ 导出账单
- 选择「个人账单」→ 时间范围 → 选中 CSV 格式
- 输入邮箱，等待接收账单文件
微信账单：
- 打开微信 APP → 我 → 服务 → 钱包 → 右上角「账单」
- 点击「常见问题」→ 下载账单
- 选择时间范围 → 输入邮箱 → 选择 CSV/XLSX 格式
2. 上传分析
- 访问应用首页
- 点击「上传账单」按钮
- 选择下载好的账单文件（CSV/XLSX）
- 等待解析完成，自动跳转到分析页面
3. 数据导出
分析完成后，可以将结果导出为：
- PNG 图片（图表截图）
- CSV 数据（原始数据）
技术栈
后端
| 技术 | 版本 | 说明 |
|---|---|---|
| Python | 3.10+ | 后端开发语言 |
| Flask | 2.0+ | Web 框架 |
| Pandas | Latest | 数据处理核心 |
| NumPy | Latest | 数值计算 |
| OpenPyXL | Latest | Excel 文件处理 |
前端
| 技术 | 版本 | 说明 |
|---|---|---|
| Vue | 3.4+ | 前端框架 |
| Vite | 5.0+ | 构建工具 |
| Vue Router | 4.2+ | 路由管理 |
| Pinia | 2.1+ | 状态管理 |
| ECharts | 5.4+ | 数据可视化 |
部署
| 技术 | 说明 |
|---|---|
| Docker | 容器化部署 |
| Docker Compose | 服务编排 |
| Nginx | Web 服务器 |
项目结构
xiaoyaoprivatebill/
├── backend/ # 后端项目（Flask + Pandas）
│ ├── api/ # API 路由层
│ ├── services/ # 业务逻辑层
│ ├── parsers/ # 文件解析模块
│ ├── utils/ # 工具函数
│ ├── data/ # 临时数据目录
│ ├── app.py # 应用入口
│ ├── config.py # 配置管理
│ ├── Dockerfile # 后端镜像构建
│ └── requirements.txt # Python 依赖
│
├── frontend/ # 前端项目（Vue 3 + Vite）
│ ├── src/
│ │ ├── api/ # API 客户端
│ │ ├── views/ # 页面组件
│ │ ├── components/ # 公共组件
│ │ ├── stores/ # 状态管理（Pinia）
│ │ └── utils/ # 工具函数
│ ├── nginx.conf # Nginx 配置
│ ├── Dockerfile # 前端镜像构建
│ ├── package.json # 依赖配置
│ └── vite.config.js # Vite 配置
│
├── docs/ # 设计文档目录
├── docker-compose.yml # Docker 编排配置
└── README.md # 本文档文档
致谢
本项目的前端和后端完全重构自优秀开源项目 alipay_record_analysis，感谢原作者 Hessel2333 提供的灵感和基础代码。
在原项目的基础上，本项目进行了以下改进：
- 前端从 Jinja2 模板重构为 Vue 3 + Vite 现代化架构
- 后端从单体应用重构为模块化蓝图架构
- 优化前端、后端性能
- 优化数据可视化展示
- 添加 Docker 一键部署能力
贡献指南
欢迎贡献代码、报告问题或提出建议！
开发流程
- Fork 本仓库
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'feat: 添加某个功能') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
代码规范
- 后端遵循 PEP 8 规范
- 前端遵循 ESLint 推荐规范
- 提交信息遵循 Conventional Commits 规范
详细规范请参阅 CLAUDE.md
常见问题
Q: 支持哪些账单格式？
A: 目前支持：
- 支付宝 CSV 账单
- 微信 CSV 账单
- 微信 XLSX 账单
Q: 数据会上传到服务器吗？
A: 不会。所有数据处理完全在本地进行，不上传任何服务器。
Q: 支持移动端吗？
A: 支持。前端采用响应式设计，可在手机浏览器上正常使用。
Q: 如何修改默认端口？
A:
- Docker 部署：修改
docker-compose.yml中的端口映射 - 后端：修改
backend/config.py中的PORT配置 - 前端开发：修改
frontend/vite.config.js中的server.port配置
许可证
本项目采用 MIT 许可证
联系方式
Made with ❤️ by Xiaoyao Team