# Klear

**Repository Path**: xuzongmin/klear

## Basic Information

- **Project Name**: Klear
- **Description**: 这是一个基于Avalonia的记账软件
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-11-13
- **Last Updated**: 2025-11-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Klear 个人财务管理软件

## 项目简介
Klear 是一个基于 Avalonia UI 框架开发的个人财务管理应用程序，提供预算管理、收支记录、类别管理和全局搜索等核心功能。该项目采用模块化设计，包含清晰的 MVVM 架构，便于维护和扩展。

## 功能特性
- **预算管理**：设置预算范围并跟踪实际支出
- **收支记录**：添加、编辑和删除收入与支出记录
- **类别管理**：自定义收入和支出类别
- **全局搜索**：根据标题、金额、备注等条件筛选记录
- **数据持久化**：使用 SQLite 数据库存储和管理数据
- **农历查询**：集成黄历信息查询功能

## 技术架构
项目采用分层架构设计：
- **Model**：定义数据模型，如 `IncomeAndExpensesModel`、`BudgetModel` 和 `CategoryModel`
- **Service**：封装数据访问逻辑，通过 `IDatabaseService` 和其他接口实现解耦
- **ViewModel**：实现业务逻辑和数据绑定，继承自 `ViewModelBase`
- **View**：使用 Avalonia UI 实现的用户界面组件

## 开发环境
- **开发框架**：.NET 8
- **UI 框架**：Avalonia
- **数据库**：SQLite
- **测试框架**：xUnit

## 使用说明
1. **启动应用**：运行 `Klear.exe` 启动程序
2. **初始化数据库**：首次启动时会自动创建数据库结构
3. **主界面导航**：
   - 点击左侧菜单切换不同功能模块
   - 支持预算管理、收支记录、类别管理和全局搜索
4. **添加记录**：
   - 在收支记录界面点击添加按钮
   - 输入金额、类别和备注信息
5. **查看统计**：
   - 在预算管理界面查看当前预算和实际支出对比
   - 设置预警阈值以监控支出情况

## 贡献指南
欢迎贡献代码！请遵循以下步骤：
1. Fork 项目
2. 创建新分支 (`git checkout -b feature/new-feature`)
3. 提交更改 (`git commit -m 'Add new feature'`)
4. 推送分支 (`git push origin feature/new-feature`)
5. 提交 Pull Request

## 许可证
本项目采用 MIT 许可证。详情请查看项目中的 LICENSE 文件。

## 联系方式
如有任何问题或建议，请通过 Gitee 平台联系项目维护者。