Skip to content

vaxicy/daily-tracker

Repository files navigation

🍽️ 吃喝拉撒 - Daily Habit Tracker 健康习惯追踪

记录饮食、饮水、排便、排尿,全方位健康习惯追踪器。Track diet, water, bowel, bladder daily.

Manifest V3 Version License

一个功能丰富的 Chrome 浏览器扩展,帮助你全方位记录和管理日常生活中的饮食、饮水、排便和排尿情况,培养健康的生活习惯。

当前仅支持本地安装使用,未上架 Chrome 应用商店。


✨ 功能特性

🍜 饮食记录

  • 多功能记录:支持早餐、午餐、晚餐、加餐分类记录
  • 智能标签:内置 16 种快捷标签(中式、西式、日式、清淡、油腻等),支持自定义标签和 emoji
  • 评价系统:5 级评分(极差→很棒),记录每餐满意度
  • 饱腹感追踪:记录饥饿/刚好/撑三种状态
  • 日历视图:直观查看历史饮食记录,支持点击日期补录或编辑
  • 统计分析:平均评分、连续记录天数、餐次分布等

💧 喝水提醒

  • 智能提醒:自定义提醒间隔(15/30/45/60 分钟或自定义)
  • 实时倒计时:直观显示距离下次喝水的时间
  • 浏览器通知:到时弹出通知提醒(支持按钮交互)
  • 数据统计:今日/本周/本月喝水次数统计
  • 灵活调整:支持增加或减少今日喝水记录

💩 排便打卡

  • 一键打卡:快速记录排便时间和备注
  • Bristol 量表:7 级分类(从硬块到水样),科学评估排便状态
  • 排便量记录:少/中/多三档
  • 日历视图:标记打卡日期,支持历史补录
  • 健康统计:Bristol 分型分布(理想型 / 偏硬型 / 偏软型)、连续理想天数、周/月合计等

💦 排尿打卡

  • 快速记录:一键记录排尿情况
  • 多维度记录:尿量(少/中/多)、尿液颜色(透明/淡黄/黄色/深黄/茶色/异常色)
  • 间隔分析:日均次数、最大/最小间隔统计
  • 日历视图:直观展示排尿频率

⏰ 自定义提醒(侧边栏)

  • 多功能提醒:支持添加自定义提醒事项(如:吃降压药)
  • 灵活配置:自定义提醒名称、图标、时间
  • 多时间提醒:支持为同一事项设置多个提醒时间
  • 开关控制:可随时启用/禁用提醒

🎨 个性化设置

  • 多主题:默认、少女粉、暗色、森林绿四种主题风格
  • 主题切换动画:平滑的过渡动画
  • 双语支持:中文/English 一键切换
  • 默认首页:可设置喜欢的页面作为默认打开页

📦 安装方法(本地加载)

  1. 下载/克隆本仓库代码到本地
    git clone https://github.com/vaxicy/daily-tracker.git
  2. 打开 Chrome 浏览器,在地址栏输入 chrome://extensions/ 并回车
  3. 开启右上角的 「开发者模式」
  4. 点击 「加载已解压的扩展程序」
  5. 选择项目所在的 daily-tracker 文件夹即可完成安装
  6. 安装成功后,点击浏览器工具栏的扩展图标即可使用

🚀 使用指南

  1. 点击浏览器工具栏的扩展图标打开主界面
  2. 使用底部导航切换不同功能页面:
    • 🍽️ - 饮食记录(支持标签、评价、饱腹感)
    • 🥤 - 喝水提醒(倒计时、通知、统计)
    • 💩 - 排便打卡(Bristol 量表、健康统计)
    • 💧 - 排尿打卡(尿量、颜色、间隔分析)
  3. 点击日历日期可查看或编辑历史记录
  4. 点击右上角 ⚙️ 设置 可自定义主题、语言、默认首页等
  5. 点击侧边栏 📋 提醒 可管理自定义提醒事项
  6. 所有数据保存在本地,保护隐私安全

🛠️ 技术栈

  • Manifest V3 - Chrome 扩展最新标准
  • 原生 JavaScript - 无框架依赖,轻量高效
  • Chrome Storage API - 本地数据持久化
  • Chrome Alarms API - 定时提醒功能
  • Chrome Notifications API - 浏览器通知
  • CSS3 - 现代化 UI 设计,支持主题切换动画
  • Service Worker - 后台持久化运行

📁 项目结构

daily-tracker/
├── manifest.json      # 扩展配置文件 (Manifest V3)
├── popup.html         # 主界面 HTML
├── popup.js           # 主界面逻辑 (150KB+)
├── background.js      # 后台服务脚本 (Service Worker)
├── i18n.js           # 国际化语言包 (中/英)
├── modules/          # 功能模块目录
├── icon16.png        # 扩展图标 (16x16)
├── icon48.png        # 扩展图标 (48x48)
├── icon128.png       # 扩展图标 (128x128)
└── plate-new.svg     # SVG 图标资源

🔄 版本历史

v3.0 (最新)

  • ✨ 侧边栏增加自定义提醒功能
  • 🎨 优化饮食记录布局和交互
  • 🏷️ 增加饮食记录快捷标签选项,支持自定义标签
  • 🐛 修复暗色主题下显示问题
  • 📊 调整统计布局,修复排便量按钮显示问题

v2.x

  • 🌙 增加暗色主题和森林绿主题
  • 🌐 增加中英双语切换功能
  • ⚙️ 增加设置默认首页功能
  • 📝 饮食记录增加备注和评价功能
  • 💧 优化喝水提醒,增加调整今日喝水数量功能
  • 📅 增加日历可补签、可追加记录功能
  • 💩 升级排便记录(Bristol 量表、排便状态)
  • 💦 优化排尿记录功能

v1.x

  • 🎉 初始版本发布
  • 🍽️ 基础饮食记录功能
  • 💧 基础喝水提醒功能
  • 💩 基础排便打卡功能
  • 💦 基础排尿打卡功能

查看完整提交历史:.git 目录或 GitHub Commits


🔒 隐私说明

  • ✅ 所有数据仅存储在本地浏览器中(chrome.storage.local
  • ✅ 不会上传任何数据到服务器
  • ✅ 无需注册账号即可使用
  • ✅ 无需联网即可正常使用
  • ✅ 尊重用户隐私,数据完全由用户掌控

🤝 贡献指南

欢迎提交 Issue 和 Pull Request!

  1. Fork 本仓库
  2. 创建你的功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开 Pull Request

📄 开源协议

本项目基于 MIT 协议开源。


💖 支持项目

如果这个项目对你有帮助,欢迎给个 Star ⭐️

你也可以请我喝杯奶茶 ☕️

你的支持是我持续更新的动力!🙏


📧 联系作者

  • GitHub: @vaxicy
  • 欢迎通过 Issue 反馈问题或提出建议

Made with ❤️ by vaxicy

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors