今日页面
今日页面是应用的主入口，展示当日饮水进度、快速记录入口和今日饮水记录。
页面概览
| 区域 | 说明 |
|---|---|
| 顶部状态栏 | 显示当前日期、星期，以及实时饮水状态和进度百分比 |
| 饮水进度 | 以圆环或角色形式展示今日饮水完成度 |
| 今日节奏卡片 | 显示今日已饮水量和每日目标 |
| 提醒卡片 | 显示下一次喝水提醒的时间 |
| 快速记录区 | 选择饮品类型，使用快捷量按钮或自定义添加 |
| 今日记录 | 展示今日所有饮水记录，支持编辑和删除 |
| 本周进度 | 以环形图表展示最近7天的每日饮水完成情况 |
进度展示
今日页面提供多种进度展示方式，可在设置中切换：
| 展示类型 | 说明 |
|---|---|
| 开口圆环 | 底部开口的圆环进度条，带有渐变光效 |
| 闭合圆环 | 完整的圆环进度条，带刻度装饰 |
| 角色填充 | 可爱角色（杯子、熊猫、猫咪、人像、机器人等）的水位填充动画 PRO |
水平衡线
开启后会在圆环中间显示一条虚线，标记50%进度位置，帮助直观判断饮水进度。
快速记录
快速记录区由两部分组成：饮品类型选择和快捷量按钮。
饮品类型
应用支持多种饮品类型，其中 💧 白水为免费类型，其余类型需要 Pro 会员解锁。
| 类型 | 说明 |
|---|---|
| 💧 白水 | 纯净水（免费） |
| 🫧 气泡水 | 含二氧化碳的饮用水 PRO |
| 🥤 碳酸饮料 | 可乐、雪碧等含糖汽水 PRO |
| 🥥 椰子水 | 天然椰子水 PRO |
| ⚡️ 电解质水 | 含电解质的运动补水饮料 PRO |
| 🍵 茶 | 绿茶、红茶等各类茶饮 PRO |
| ☕️ 咖啡 | 美式、拿铁等咖啡饮品 PRO |
| 🧊 冰茶 | 冰镇茶类饮料 PRO |
| 🧋 热巧克力 | 可可粉调制的热饮 PRO |
| 🧃 果汁 | 橙汁、苹果汁等纯果汁 PRO |
| 🥕 蔬菜汁 | 胡萝卜汁、番茄汁等 PRO |
| 🍋 柠檬水 | 柠檬调制的清爽饮品 PRO |
| 🍓 奶昔 | 水果与酸奶/牛奶混合饮品 PRO |
| 🥛 牛奶 | 全脂牛奶 PRO |
| 🥛 脱脂牛奶 | 脱脂牛奶 PRO |
| 🍫 巧克力牛奶 | 巧克力味牛奶饮品 PRO |
| 🍹 蛋白奶昔 | 蛋白质补充饮料 PRO |
| 🏃 运动饮料 | 功能性运动补水饮料 PRO |
| 🔋 能量饮料 | 含咖啡因的功能饮料 PRO |
| 🍲 汤 | 各类汤品 PRO |
| 🍺 啤酒 | 低度酒精饮品 PRO |
| 🍷 葡萄酒 | 红酒、白酒等 PRO |
| 🥃 烈酒 | 威士忌、伏特加等蒸馏酒 PRO |
🔒 解锁饮品
除 💧 白水外，其他所有饮品类型都需要开通 Pro 会员才能选择。在添加饮水页面，只有 💧 白水可免费使用。
快捷量按钮
选择饮品后，点击快捷量按钮（如 100ml、200ml、300ml）即可快速记录。点击 + 按钮可自定义饮水量。
今日记录
今日记录列表展示当天的所有饮水记录，每条记录包含：
- 饮品类型图标和名称
- 饮水量（显示原始量和有效量）
- 记录时间
- 添加时的进度百分比
- 小进度圆环
记录操作
长按记录项可呼出菜单，选择编辑修改记录，或选择删除移除记录。删除后今日进度会自动重新计算。
添加饮水
点击快捷记录区的 + 按钮或导航栏的加号，进入添加饮水页面：
选择饮品类型
在网格中选择对应的饮品图标（带皇冠标记的需要 Pro 会员）
输入饮水量
使用数字键盘输入具体数值，或使用快捷量按钮快速选择
调整时间（可选）
点击日期/时间芯片，可修改记录的时间（用于补记之前的饮水）
确认添加
点击确认按钮保存记录，页面自动返回并更新进度
📝 补记功能
添加饮水时可修改日期和时间，方便补记之前的饮水记录。支持补记到过去任意日期。
习惯页面
习惯页面提供详细的饮水数据分析和健康评分，帮助用户了解自己的饮水习惯。
功能说明
| 功能 | 说明 |
|---|---|
| 健康小贴士 | 根据用户饮水数据提供个性化健康建议和改善方向 |
| 习惯评分 | 满分100分，综合完成度、一致性、连续打卡三项指标评估 |
| 趋势图表 | 可视化展示最近7天饮水变化，直观看到进步轨迹 |
| 习惯洞察 | 最佳饮水时间、峰值时段、连续打卡天数等深度分析 |
| 饮品分布 | 环形图展示各类饮品的占比情况 |
评分规则
| 维度 | 分值 | 计算方式 |
|---|---|---|
| 完成度 | 40分 | 近7天达标天数 ÷ 7 × 40 |
| 一致性 | 30分 | 近7天日均饮水量 ÷ 每日目标 × 30 |
| 连续打卡 | 30分 | min(当前连续达标天数 ÷ 7, 1.0) × 30 |
🎯 提高分数的小窍门
- 尽量每天都完成目标，完成度占40分比重最大
- 保持稳定的饮水量，不要一天喝太多一天又不喝
- 连续打卡7天以上，那30分就稳稳到手
历史页面
历史页面提供完整的饮水记录查询和数据分析功能。
功能说明
| 功能 | 说明 |
|---|---|
| 时间筛选 | 支持按日、周、月、年查看历史数据（周/月/年需 Pro） |
| 图表卡片 | 根据所选时间段展示对应的饮水图表 |
| 数据分析 | 平均饮水量、总饮水量、达标天数、连续打卡天数等统计 |
| 饮品统计 | 展示各类饮品的饮用情况 |
| 咖啡因统计 | 统计咖啡因摄入量 PRO |
全部记录
点击"查看全部"进入全部记录页面，支持以下功能：
- 按日期分组：记录按日期分组展示，每天显示总饮水量
- 快速添加：页面右上角有 + 按钮，可直接添加新记录
查看技巧
筛选记录
使用顶部筛选器按饮品类型过滤，只查看关心的记录
切换周期
使用时间段选择器切换日/周/月/年，从不同角度分析
查看全部
点击"查看全部"查看完整的记录列表
成就页面
成就页面展示用户的成就收集进度和奖励积分系统。
功能说明
| 功能 | 说明 |
|---|---|
| 统计卡片 | 显示已解锁成就数量和总积分 |
| 分类筛选 | 按成就类型筛选（目标达成、累计饮水、单日挑战、时间成就、饮品多样、季节限定、里程碑） |
| 成就网格 | 以网格形式展示所有成就，已解锁显示彩色，未解锁显示灰色 |
| 成就详情 | 点击成就查看详细信息、进度和奖励 |
成就类型
| 类型 | 说明 |
|---|---|
| 🎯 目标达成 | 完成每日饮水目标相关成就 |
| 💧 累计饮水 | 累计饮水总量相关成就 |
| 🔥 单日挑战 | 单日饮水量挑战成就 |
| ⏰ 时间成就 | 特定时间段饮水成就 |
| 🍹 饮品多样 | 尝试不同饮品类型成就 |
| 🌿 季节限定 | 季节性限时成就 |
| 🏆 里程碑 | 重要里程碑纪念成就 |
🎉 成就解锁
解锁成就时会弹出庆祝动画和积分奖励。部分高级成就需要 Pro 会员才能解锁。
设置页面
设置页面包含个人档案、通知、数据、支持和关于等多个功能模块。
功能总览
| 功能 | 说明 |
|---|---|
| 个人档案 | 设置用户名、头像、性别、体重、活动量、每日目标 |
| 单位设置 | 公制（ml/L）/ 英制（fl oz/cup）切换，自动同步到 Watch 和 Widget |
| 语言设置 | 支持多语言切换 |
| 主屏幕 | 主页展示类型、进度显示、记录显示设置 |
| 饮水提醒 | 提醒开关、铃声、目标达成后停止、模式、间隔、时间范围、休息日 |
| 喝水音效 | 开启/关闭喝水时的音效反馈 |
| iCloud 同步 | 数据同步到 iCloud PRO |
| Apple Health | 与 Apple Health 同步饮水数据 PRO |
| 数据导出 | 导出饮水记录为 CSV/JSON PRO |
| 帮助与反馈 | 查看帮助文档和提交反馈 |
| 社交分享 | 分享应用给好友 |
个人档案
点击设置页面的个人档案卡片进入详情页，可设置以下内容：
- 用户名：显示在应用中的用户昵称
- 头像：点击头像区域，从系统相册选择照片作为头像；未设置头像时，若已填写用户名则显示姓名首字母，否则显示默认图标
- 性别：男 / 女 / 保密
- 体重：用于智能推荐每日饮水目标
- 活动量：久坐 / 轻度活动 / 中度活动 / 活跃 / 非常活跃
- 每日目标：默认
2000ml，可手动调整 - 智能推荐：根据体重和活动量自动计算推荐目标 PRO
💡 智能推荐
开启智能推荐后，系统会根据你的体重和活动量自动计算每日饮水目标。Pro 会员专享功能。
主屏幕设置
点击设置页面的主屏幕选项进入详情页，包含以下设置：
视图类型
选择主页进度展示的外观，横向滑动选择：
| 类型 | 说明 |
|---|---|
| 开口圆环 | 底部开口的圆环进度条，默认样式 |
| 闭合圆环 | 完整的圆环进度条，带刻度装饰 |
| 可爱杯子 | 杯子形状的角色水位填充 PRO |
| 水滴 | 水滴形状的角色水位填充 PRO |
| 熊猫 | 熊猫形状的角色水位填充 PRO |
| 猫咪 | 猫咪形状的角色水位填充 PRO |
| 狗狗 | 狗狗形状的角色水位填充 PRO |
| 兔子 | 兔子形状的角色水位填充 PRO |
| 小熊 | 小熊形状的角色水位填充 PRO |
| 企鹅 | 企鹅形状的角色水位填充 PRO |
| 章鱼 | 章鱼形状的角色水位填充 PRO |
| 恐龙 | 恐龙形状的角色水位填充 PRO |
| 青蛙 | 青蛙形状的角色水位填充 PRO |
| 云朵 | 云朵形状的角色水位填充 PRO |
| 星星 | 星星形状的角色水位填充 PRO |
| 爱心 | 爱心形状的角色水位填充 PRO |
| 太阳 | 太阳形状的角色水位填充 PRO |
| 👤 人像 1 | 人像形状的角色水位填充 PRO |
| 👩 人像 2 | 人像形状的角色水位填充 PRO |
| 🧑 人像 3 | 人像形状的角色水位填充 PRO |
| 🤖 机器人 1 | 机器人形状的角色水位填充 PRO |
| 🦾 机器人 2 | 机器人形状的角色水位填充 PRO |
| 🤖 机器人 3 | 机器人形状的角色水位填充 PRO |
进度设置
- 水平衡线：在圆环中间显示50%进度标记线（开关）
- 彩色填充：按饮品类型显示不同颜色分段（开关）
- 按饮品合并：相同类型的记录合并显示（开关）
记录设置
- 显示今日记录：在主页显示今日饮水记录列表（开关）
- 显示本周进度：在主页显示本周7天进度图表（开关）
主题风格
选择应用的主题配色方案，共 14 种主题可选：
| 主题 | 说明 |
|---|---|
| 🍎 苹果浅色 | 默认主题，iOS 风格浅色（免费） |
| 🍏 苹果深色 | OLED 纯黑深色（免费） |
| 🌊 海洋深蓝 | 深邃海洋蓝（免费） |
| 🌲 森林绿意 | 清新自然绿 PRO |
| 🌅 落日橙霞 | 温暖落日橙 PRO |
| 💜 薰衣草紫 | 浪漫薰衣草紫 PRO |
| 🪸 珊瑚粉色 | 柔和珊瑚粉 PRO |
| 🌿 薄荷清新 | 清凉薄荷绿 PRO |
| ✨ 星空紫梦 | 梦幻星空紫 PRO |
| ☀️ 晴空万里 | 明亮天空蓝 PRO |
| 🌞 暖阳高照 | 温暖阳光黄 PRO |
| 🌌 极光幻彩 | 神秘极光青绿 PRO |
| 🍋 柠檬清新 | 活力柠檬黄 PRO |
| 🌹 玫瑰芬芳 | 优雅玫瑰红 PRO |
提醒设置
点击设置页面的提醒选项进入详情页，包含以下设置：
提醒总开关
开启/关闭所有喝水提醒。关闭后所有提醒通知将不再发送。
提醒铃声与目标达成
- 提醒铃声：选择提醒音效，共20种铃声可选。免费用户仅可使用系统默认、闹钟1、闹钟2；Pro 会员可使用全部铃声
- 目标达成后不再提醒：达到每日目标后自动停止发送提醒（开关）
提醒配置
- 推送语：选择提醒通知的文案风格（默认/励志/幽默/温馨/科学） PRO
- 智能场景：根据时间、位置等场景智能调整提醒 PRO
时间设置
- 提醒模式：固定间隔 / 智能模式 PRO
- 间隔时长：30分钟 / 45分钟 / 60分钟 / 90分钟 / 120分钟
- 开始提醒时间：默认 07:00
- 结束提醒时间：默认 22:00
休息日
选择一周中哪些日子不发送提醒。免费用户无法设置休息日，Pro 会员可自由选择 PRO
暂停补水
点击暂停补水按钮可一键关闭所有提醒。
⏰ 免费 vs Pro 提醒功能
- 免费：固定间隔模式、3种铃声、无休息日
- Pro：智能模式、20种铃声、推送语选择、智能场景、休息日设置
数据设置
iCloud 同步 PRO
将饮水数据同步到 iCloud，支持多设备共享。包含以下功能：
- 查看 iCloud 同步状态（未登录/同步中/已同步/失败/不可用）
- 开启/关闭 iCloud 同步开关
- 手动同步所有数据
- 验证同步状态
- 查看上次同步时间和记录总数
☁️ iCloud 同步说明
iCloud 同步基于 SwiftData + CloudKit 自动同步，需要登录同一 Apple ID 并开启网络。数据会在后台自动同步，也可手动点击"同步全部数据"立即同步。首次使用时，App 会自动将数据推送到 CloudKit。
Apple Health 同步 PRO
将饮水数据与 Apple Health 双向同步：
- 授权 HealthKit 访问（首次使用需点击"授权访问"）
- 水：读写同步（双向）
- 咖啡因：仅写入（从 WaterKit 同步到 Health）
- 活动能量：仅读取（从 Health 读取，自动更新活动量）
- 体重：仅读取（从 Health 读取，自动更新体重）
- 性别：仅读取（从 Health 读取，自动更新性别）
- 自动同步：开启后自动监听 Health 数据变化并同步
- 同步进度：同步时显示实时进度条和记录数
🏥 Apple Health 授权说明
首次使用 Apple Health 同步时，需要点击"授权访问"按钮进行授权。授权后，WaterKit 会自动将饮水记录写入 Health，并从 Health 读取体重、活动量等信息更新到个人档案。
📱 iOS 26 用户注意
在 iOS 26 上，由于系统限制，点击"授权访问"后会跳转到健康 App，您需要手动前往「共享 → App → WaterKit」开启权限。返回 WaterKit 后，App 会自动检测到权限变化并开始同步。
数据导出 PRO
将饮水记录导出为文件：
- 日期范围：选择导出的起始和结束日期
- 导出格式：CSV 或 JSON
- 内容预览：导出前预览记录数量
Apple Watch
WaterKit 的 Apple Watch 端完全免费，提供快捷记录、进度查看和数据同步功能。
功能概览
| 功能 | 说明 |
|---|---|
| 圆环界面 | 大圆环展示今日饮水进度，下方快捷按钮快速记录 |
| 简洁界面 | 数字进度 + 进度条 + 快捷按钮的紧凑布局 |
| 快捷记录 | 100ml / 200ml / 300ml / 400ml / 500ml 一键添加 |
| 饮品选择 | 支持白水、气泡水、咖啡、茶等多种饮品类型 |
| 7 天历史 | 柱状图展示近 7 天饮水记录 |
| 今日记录 | 查看和删除今日饮水记录 |
| 成就 | 查看已解锁的成就列表 |
🎉 完全免费
Apple Watch 端所有功能完全免费使用，无需 Pro 会员。包括所有饮品类型、Widget 和快捷记录功能。
Watch 设置
Watch 端的设置页面提供以下选项：
| 设置项 | 说明 |
|---|---|
| 档案 | 显示从 iPhone 同步的昵称、每日目标、体重、性别、活动量和单位（只读） |
| 通知 | 提醒开关、间隔、时间范围 |
| 主屏幕 | 选择圆环界面或简洁界面 |
| 其他饮料屏幕 | 选择快捷记录页显示的饮品类型 |
| 每日重置时间 | 设置每日数据重置的时间点 |
| 声音 | 开启/关闭喝水音效 |
📏 单位同步
Watch 端的单位设置（公制 ml / 英制 oz）自动从 iPhone 端同步，无需在 Watch 上单独设置。在 iPhone 端「设置 → 档案 → 单位」中切换后，Watch 端会自动更新。
数据同步
Watch 端与 iPhone 端通过以下方式同步数据：
- 实时同步：当 iPhone 与 Watch 蓝牙连接且 Watch App 可达时，数据实时推送
- 后台同步：Watch 不可达时，通过 Application Context 在下次连接时同步
- Widget 同步：通过 App Group 共享数据，Widget 自动读取最新数据
🔄 同步内容
iPhone → Watch 同步的内容包括：今日饮水量、每日目标、档案信息（昵称、体重、性别、活动量）、单位设置、提醒设置、7 天历史数据。Watch → iPhone 同步的内容包括：在 Watch 上添加或删除的饮水记录。
Pro 会员
开通 Pro 会员解锁更多高级功能，提升使用体验。
会员特权
| 特权 | 说明 |
|---|---|
| 全部饮品类型 | 解锁除白水外的所有饮品类型（气泡水、咖啡、茶、果汁、酒精等） |
| 角色皮肤 | 使用杯子、水滴、熊猫、猫咪等22+种可爱角色作为主页展示 |
| 14 种主题 | 解锁 3 种免费主题外的 11 种精美主题配色 |
| 历史周期筛选 | 查看周、月、年维度的历史数据 |
| 咖啡因统计 | 在历史页面查看咖啡因摄入分析 |
| 数据导出 | 导出完整数据报告 |
| 主题与成就 | 解锁高级主题和成就 |
| 智能提醒 | 使用智能提醒模式和更多铃声选项 |
| Watch 与 Widget | Apple Watch 和 Widget 功能完全免费，无需 Pro 会员 |
💎 订阅方案
提供月付、年付和永久三种方案。新用户可享受 3天免费试用，试用期内可随时取消。