Hydration Tracker

这是一款命令行饮水追踪工具，核心功能涵盖：记录自定义、杯装或瓶装饮水量，设定每日饮水目标，查看当日、本周及历史饮水数据，检查进度达标情况，获取饮水小贴士。适合日常养成饮水习惯、午间核查进度补量、每周复盘饮水趋势等场景。通过命令行指令操作，输出简洁统计信息，所有数据本地存储，无需联网及账号，隐私性强。

bytesagain1

热度 66.32

最近更新 2026-05-11 17:31:50

分类：生活依赖：代码执行 / 读写文件应用场景：健康

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add hydration-tracker

Metadata

name: Hydration Tracker
description: Track daily water intake, set hydration goals, and get drink reminders. Use when logging water, setting targets, or reviewing weekly intake trends.
version: 2.0.0
author: BytesAgain
homepage: https://bytesagain.com
source: https://github.com/bytesagain/ai-skills
tags: ["health","hydration","water","reminder","wellness","utility","健康","饮水"]
categories: ["Health & Wellness","Utility","Personal Management"]
commands: [{"name":"drink","description":"记录一次饮水量。如不指定，默认为250ml。示例：`water-reminder drink 500`","usage":"hydration-tracker drink [ml]","parameters":[{"name":"ml","type":"number","description":"饮水量，单位毫升。","required":false}]},{"name":"cup","description":"快速记录一杯水（默认为250ml）。","usage":"hydration-tracker cup"},{"name":"bottle","description":"快速记录一瓶水（默认为500ml）。","usage":"hydration-tracker bottle"},{"name":"today","description":"查看今日总饮水量。","usage":"hydration-tracker today"},{"name":"goal","description":"设定每日饮水目标。如不指定，默认为2000ml。示例：`water-reminder goal 2500`","usage":"hydration-tracker goal [ml]","parameters":[{"name":"ml","type":"number","description":"每日饮水目标，单位毫升。","required":false}]},{"name":"check","description":"检查当前饮水进度是否达标。","usage":"hydration-tracker check"},{"name":"week","description":"查看本周饮水量的汇总摘要。","usage":"hydration-tracker week"},{"name":"history","description":"查看最近N天的饮水记录（默认为7天）。示例：`water-reminder history 30`","usage":"hydration-tracker history [n]","parameters":[{"name":"n","type":"number","description":"查看历史记录的天数。","required":false}]},{"name":"stats","description":"显示详细的水合统计数据和趋势。","usage":"hydration-tracker stats"},{"name":"remind","description":"获取水合小贴士和个性化提醒。","usage":"hydration-tracker remind"},{"name":"info","description":"显示Hydration Tracker的版本信息。","usage":"hydration-tracker info"}]
changelog: [{"version":"2.0.0","date":"2026-03-15","changes":["初始版本发布：提供每日饮水追踪、目标设定和进度检查功能。"]}]
pricing_model: free
license: MIT
docs_url: https://bytesagain.com/skills/hydration-tracker
support_url: https://bytesagain.com/feedback

Hydration Tracker

A daily water intake tracker that helps you build and maintain healthy hydration habits. Log every drink, set personalized daily goals, check your progress throughout the day, and review weekly summaries — all from the command line with local-only data storage.

Commands

Command	Description
`drink [ml]`	Log water intake in milliliters (default: 250ml). Shows running total and goal progress with celebration when goal is reached
`cup`	Quick-log a cup of water (250ml) — shortcut for `drink 250`
`bottle`	Quick-log a bottle of water (500ml) — shortcut for `drink 500`
`today`	Display today's total intake vs. daily goal, with remaining amount or goal-reached indicator
`goal [ml]`	Set your daily hydration goal in milliliters (default: 2000ml)
`check`	Check if you're on track — compares current intake against expected intake based on time of day
`week`	Show a 7-day hydration summary with daily breakdowns, weekly total, and daily average
`history [n]`	Show hydration history for the last N days (default: 7, max: 30)
`stats`	Display overall statistics — total days tracked, total intake, and average daily intake
`remind`	Get a random hydration tip (e.g., "Drink a glass of water before each meal")
`info`	Show version info (v1.0.0)
`help`	Show all available commands with usage examples

Data Storage

Data directory: ~/.water_reminder/
Intake data: data.json — JSON object mapping dates (YYYY-MM-DD) to cumulative daily intake in ml
Goal config: goal.json — stores your current daily goal (default: 2000ml)
Max history: 30 days of lookback for the history command
All data is stored locally in JSON format; no external services, accounts, or network access required

Requirements

Bash 4+
Python 3 (standard library only — used for JSON read/write)
Standard POSIX utilities (date, seq)
No API keys or external dependencies

When to Use

Building a daily hydration habit — log each drink throughout the day and let the progress tracker keep you motivated with goal-reached celebrations
Checking mid-day progress — use check to see if your intake is on track relative to the time of day, so you can catch up before evening
Reviewing weekly trends — run week to see a 7-day summary with emoji indicators showing which days you hit your goal
Adjusting your hydration goal — use goal to increase or decrease your daily target based on activity level, weather, or health needs
Getting gentle reminders — run remind for evidence-based hydration tips to keep healthy habits top of mind

Examples

# Log 300ml of water
hydration-tracker drink 300

# Quick-log a cup (250ml)
hydration-tracker cup

# Quick-log a bottle (500ml)
hydration-tracker bottle

# Check today's progress
hydration-tracker today

# Set a custom daily goal of 2500ml
hydration-tracker goal 2500

Example Output

$ hydration-tracker drink 300
Logged 300ml. Today's total: 1200ml / 2000ml.
Almost there! Keep going!

$ hydration-tracker today
Today's intake (2026-03-18): 1200ml / 2000ml
Remaining: 800ml

$ hydration-tracker week
--- Weekly Hydration Summary ---
2026-03-18: (1200ml / 2000ml) 💧
2026-03-17: (2100ml / 2000ml) 🎉
2026-03-16: (1800ml / 2000ml) 💧
...
Weekly total: 12300ml
Daily average: 1757ml (Goal: 2000ml)

$ hydration-tracker remind
💧 Hydration Tip: Drink a glass of water before each meal.