随口一句话就记入每日饮水量，按体重、活动和场景给出个性化补水目标。
52 次安装3 星标
数据分析
hydration-hero
试用Smart water intake tracking based on body weight, weather, and activity level. Calculates personalized hydration targets, adjusts for caffeine and alcohol consumption, tracks streaks with gamification, generates hourly drinking schedule, and provides hydration education with urine color chart reference.
它能做什么
Smart water intake tracking based on body weight, weather, and activity level. Calculates personalized hydration targets, adjusts for caffeine and alcohol consumption, tracks streaks with gamification, generates hourly drinking schedule, and provides hydration education with urine color chart reference.
技能文档
Hydration Hero
A standalone command-line tool for smart water intake tracking. Calculates your personalized hydration needs based on body weight, adjusts for weather and activity, tracks your intake with gamified streaks, and generates an optimal drinking schedule.
Quick Start
# Set up your profile
python3 scripts/hydration_hero.py init
# Log water intake throughout the day
python3 scripts/hydration_hero.py log 250
python3 scripts/hydration_hero.py log 500
# Check progress
python3 scripts/hydration_hero.py status
# Log factors that change your needs
python3 scripts/hydration_hero.py activity --exercise 30 --intensity moderate
python3 scripts/hydration_hero.py weather --temp 32 --humidity 70
python3 scripts/hydration_hero.py caffeine --cups 2
python3 scripts/hydration_hero.py alcohol --drinks 3
# See your drinking schedule
python3 scripts/hydration_hero.py schedule
# Weekly report
python3 scripts/hydration_hero.py report week
Commands
| Command | Description |
|---|---|
init | Create profile (weight, activity level, climate) |
log | Log water intake (milliliters) |
log --oz | Log in ounces instead |
status | Show today's progress vs target |
target | Show your calculated daily hydration target |
activity --exercise --intensity | Log exercise (adds water need) |
weather --temp --humidity | Log weather (adjusts target) |
caffeine --cups | Log caffeine intake (diuretic effect) |
alcohol --drinks | Log alcohol (strong diuretic) |
schedule | Generate hourly drinking schedule |
streak | Show hydration streak |
report [week|month] | Period summary with charts |
color-check | Urine color reference chart |
remind | Show next drinking reminder time |
How It Works
Personalized Hydration Formula
Base target is calculated from body weight:
Base = Weight(kg) × 35 ml/day (standard recommendation)
Dynamic Adjustments
- Exercise: +350-700ml per 30 min depending on intensity
- Hot weather (>25°C): +500ml per 5°C above baseline
- High humidity (>70%): +300ml (reduced evaporative cooling)
- Caffeine: +150ml compensatory water per cup
- Alcohol: +400ml compensatory water per drink
- Altitude (>2500m): +500ml (dry air, increased respiration)
- Pregnancy/nursing: +300-700ml
- Illness/fever: +200ml per 1°C above normal
Gamification
- Daily goal completion streak 🔥
- Weekly achievement levels: Bronze (5/7 days), Silver (6/7), Gold (7/7)
- Hydration score: based on consistency, not just volume
- Milestone badges: 7-day, 30-day, 100-day streaks
Urine Color Reference
Includes the standard 8-level urine color chart for self-assessment:
- Levels 1-3: Well hydrated ✅
- Level 4: Slightly dehydrated 🟡
- Levels 5-6: Dehydrated 🔴
- Levels 7-8: Severely dehydrated — drink immediately ⚠️
Data Storage
Data is stored in ~/.hydration_hero.json. Delete to reset.
References
- Hydration Science
- Hydration Schedule Guide
License
MIT © Denis Voronin
相关技能
以最后一次进食为起点记录间歇性与长时断食，估算当前阶段，并在 24 小时后给出电解质与复食建议。
47 次安装2 星标
拍照、文字或拍营养标签都能记录一餐,输出区间形式的热量与宏量营养素估算,并带安全护栏。
作者 Iván53 次安装3 星标
Log and track daily calorie intake, macronutrients, body weight, and waist measurements locally in a SQLite database. Provides granular statistics, weekly averages, and future calorie budgets.
5 次安装
Track sleep vs optimal, calculate accumulated sleep debt, and suggest evidence-based recovery schedules. Chronotype detection, quality-weighted sleep tracking, ASCII charts, and caffeine/alcohol impact monitoring.
1 次安装
Track symptoms over time and generate doctor-ready timelines. Correlates symptoms with food, weather, medication, activity, sleep, and stress. Detects patterns, flare-ups, and produces concise clinical reports.