一个AI实现的基于python的Web记账应用
Access rate limit exceeded. Please log in to continue.
📒 家庭记账本
基于 Python Streamlit + SQLite3 的个人记账 Web 应用,浏览器打开即用。
功能概览
- 添加记录 — 表单填写金额、分类、日期、备注,点按钮提交
- 查看记录 — 按月份和分类筛选,表格展示所有记录
- 删除记录 — 输入记录 ID 即可删除
- 分类统计 — 柱状图直观对比 + 统计表(含金额、笔数、占比)
环境要求
- Python 3.10 及以上(内置 SQLite3,无需额外安装数据库)
快速开始
# 1. 进入项目目录
cd finance-cli
# 2. 安装依赖
pip install -r requirements.txt
# 3. 启动应用
streamlit run app.py
启动后浏览器会自动打开 http://localhost:8501。如果没有自动打开,手动访问该地址即可。
使用说明
应用左侧有侧边栏导航,点击切换三个页面:
📝 添加记录
- 填写金额(必须大于零)
- 选择分类(餐饮/交通/购物/娱乐/居住/其他)
- 选择日期(默认为今天)
- 备注选填
- 点击「✅ 添加记录」提交
提交成功后会显示记录 ID,表单自动清空。
📋 查看记录
- 顶部两个下拉框:按月份、按分类筛选,默认"全部"
- 中间表格展示匹配记录(ID、金额、分类、日期、备注、创建时间)
- 底部删除区:输入要删除的记录 ID,点击删除即可
📊 分类统计
- 柱状图:各分类消费总额对比
- 统计明细表:每个分类的总金额、笔数、占比,最后一行是合计
数据存储
所有数据保存在 finance.db 文件中(SQLite 数据库),文件与代码同目录。该文件已加入 .gitignore,不会被提交到 Git。
如需备份数据,直接复制 finance.db 文件即可。
项目结构
finance-cli/
├── app.py # Streamlit 页面与入口
├── database.py # 数据库操作
├── config.py # 预设分类与配置
├── requirements.txt # Python 依赖
└── finance.db # 数据库(自动生成)