# 练习

**Repository Path**: lei-ya-dong/practice

## Basic Information

- **Project Name**: 练习
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 💰 记账

一个运行在 **Windows** 上的个人记账桌面应用。帮你记录每一笔花销，按两级分类管理，随时回顾消费情况。

## ✨ 功能特性

- **记一笔**：输入金额、选择一级/二级分类、填写备注（可选）、选择日期，一键保存
- **两级分类**：10 个预置一级大类，每类下带常用小类；也可自定义自己的分类
- **账单列表**：按日期倒序展示所有消费记录，支持随时编辑、删除
- **筛选与统计**：按时间范围、分类筛选账单，自动统计合计支出、消费笔数、日均支出
- **分类管理**：新增/改名/删除自建分类；系统预置分类锁定不可改；删除分类时其下账单自动归入「其他 > 未分类」，账单不会丢失
- **数据本地保存**：所有数据存放在本机 SQLite 数据库，关闭应用不丢失

## 📦 技术栈

| 技术 | 用途 |
|------|------|
| Python 3 | 开发语言 |
| PySide6（Qt 6） | 图形界面框架 |
| SQLite | 本地数据库（Python 内置，无需额外安装） |

## 🚀 安装与运行

### 环境要求

- Windows 10 / 11
- Python **3.10 或更高版本**（安装时勾选"Add Python to PATH"）

### 安装依赖

在项目目录下打开终端（PowerShell 或 CMD），执行：

```bash
pip install -r requirements.txt
```

### 启动应用

任选一种方式：

- **方式一（推荐）**：双击项目里的 `启动记账.lnk` 快捷方式，无命令行窗口
- **方式二**：在终端执行 `python main.py`

首次启动会自动创建数据库并写入预置分类，无需任何配置。

## 🗂 消费分类体系

| 一级大类 | 二级小类 |
|----------|----------|
| 🍽️ 餐饮 | 早餐、午餐、晚餐、零食饮料、食材、聚餐请客 |
| 🚗 交通 | 公交地铁、出租车、网约车、加油充电、停车费、火车飞机 |
| 🛒 购物 | 日用品、数码产品、家居用品、书籍、礼物 |
| 🏠 居住 | 房租、水电费、燃气费、物业费、维修维护 |
| 🎮 娱乐 | 电影、游戏、旅游度假、运动健身、演出展览 |
| 💊 医疗 | 门诊挂号、药品、体检、住院 |
| 📚 教育 | 学费、培训课程、书本资料、考试报名 |
| 📱 通讯 | 话费、上网费、快递邮寄 |
| 👗 服饰 | 衣服、鞋帽、配饰、护肤化妆品 |
| 💰 其他 | 未分类、杂项 |

> 除了以上预置分类，你还可以在应用内「分类管理」里创建自己的分类。

## 💾 数据存储

- 数据库文件位置：`C:\Users\<你的用户名>\.jizhang\jizhang.db`
- 想备份账单数据时，直接复制这个文件即可；换电脑后把它放回同样位置就能找回全部账单

## 📁 项目结构

```
记账app/
├── CLAUDE.md           # 产品文档与项目说明
├── README.md           # 项目说明（本文件）
├── requirements.txt    # Python 依赖清单
├── database.py         # 数据库层（SQLite 增删改查）
├── main.py             # 主程序（图形界面）
├── 启动记账.lnk         # 一键启动快捷方式
└── .gitignore          # git 忽略规则
```

## 🔒 代码安全与备份

- 项目使用 **git** 进行版本管理，每次改动都会保存"存档点"，误删误改可随时回退
- 代码已同步备份到 **Gitee 远程仓库**：<https://gitee.com/lei-ya-dong/practice>，电脑硬盘损坏也能找回代码

## 📝 未来计划

- 月度预算设置与提醒
- 数据导出为 Excel / CSV
- 图表可视化（饼图、折线图）
- 多账户支持（现金、银行卡、微信、支付宝等）
- 收入记录