# WaterReminderApp

**Repository Path**: Jason218/water-reminder-app

## Basic Information

- **Project Name**: WaterReminderApp
- **Description**: Windows喝水提醒工具，一款简约的WPF桌面喝水提醒应用，帮助您养成健康的饮水习惯。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 💧 喝水提醒助手

一款简约的WPF桌面喝水提醒应用，帮助您养成健康的饮水习惯。
![输入图片说明](https://foruda.gitee.com/images/1767064494739063171/c5ab1e12_1865362.png "1767064455620.png")
## 功能特色

### 🎯 核心功能
- **每日饮水记录** - 准确记录每次饮水量，本地存储数据不丢失
- **智能提醒** - 可自定义提醒间隔，在设定时间内定时提醒
- **进度追踪** - 实时显示今日饮水进度和完成百分比
- **快速记录** - 预设常用水量(250ml/500ml/1000ml)，一键添加
- **自定义设置** - 可设置每日目标水量和提醒间隔

### ✨ 贴心设计
- **每日美句** - 每天显示不同的励志美句，治愈心灵
- **进度可视化** - 直观的进度条显示当日完成情况
- **鼓励反馈** - 达到不同进度时给予鼓励提示
- **系统托盘** - 最小化到系统托盘，右键菜单快速操作
- **托盘提醒** - 气泡提示，不打扰正常工作
- **简约界面** - 清新简洁的UI设计，使用体验舒适

## 快速开始

### 下载&安装
下载 **喝水提醒.exe** 就可以了

免安装，双击可运行

#### !!! 如果你双击的时候提示：You must install .NET Desktop Runtime to run this application，点击 Download it now 就行了(会安装微软官方.NET环境)


### 运行要求
- Windows 操作系统
- .NET 8.0 或更高版本

### 运行应用
双击运行exe即可

## 使用说明

### 基本操作
1. **记录饮水** - 点击快速按钮(250ml/500ml/1000ml)或输入自定义水量
2. **查看进度** - 主界面显示今日饮水总量和目标完成百分比
3. **管理记录** - 在今日记录列表中可以删除错误记录
4. **清空记录** - 点击"清空"按钮可清除当日所有记录
5. **系统托盘** - 关闭或最小化窗口时程序保持在系统托盘运行
6. **托盘操作** - 右键托盘图标可快速添加饮水记录或显示主窗口

### 设置配置
1. **每日目标** - 设置每日饮水目标(默认2000ml)
2. **提醒间隔** - 设置提醒间隔时间(默认60分钟)
3. **开启提醒** - 点击"开启提醒"按钮启动定时提醒功能

### 数据存储
- 所有数据自动保存到本地 `%AppData%\WaterReminder` 目录
- `records.json` - 存储所有饮水记录
- `settings.json` - 存储用户设置


## 技术栈

- **框架**: WPF (.NET 8.0)
- **UI**: XAML + 自定义样式
- **数据存储**: JSON文件 (Newtonsoft.Json)
- **定时器**: DispatcherTimer

## 特色亮点

- 🎨 **现代化UI** - 采用卡片式设计，渐变色彩，界面美观现代
- 💾 **本地存储** - 数据完全本地化，隐私安全有保障
- ⏰ **智能提醒** - 只在设定的活跃时间内提醒，不打扰休息
- 📊 **数据可视化** - 进度条和百分比直观显示完成情况
- 🎯 **目标导向** - 设定目标并给予达成反馈，增强动力
- 🔔 **系统托盘** - 后台运行，托盘提醒，不占用桌面空间
- 🚀 **快速操作** - 托盘右键菜单支持快速添加饮水记录

开始使用，让每一天都充满活力！💪