DrinkWater

A minimal VSCode extension that helps you track daily water intake — right from the status bar.

一个极简的 VSCode 喝水追踪扩展，记录、提醒、可视化你的每日饮水量。

English

Features

• One-click tracking: Click the status bar icon to log a cup. Default 350ml per cup.
• Smart hover tooltip: Shows each drink time, intervals, total volume, daily progress bar, and goal status.
• Threshold indicators: Visual feedback when you reach 1500ml / 2000ml / 4000ml.
• Daily / Weekly / Monthly charts: Bar and line charts powered by Chart.js.
• Local persistence: Data stored at ~/.drinkwater-data/data.json. No network, no telemetry.
• Customizable cup size: 1–2000ml.
• History management: Delete records by day with multi-select.
• Auto-reset: New day starts fresh automatically.

Usage

After installation you'll see 🥤 0 in the bottom-right status bar.

• Single click → +1 cup, with green confirmation animation.
• Double click → open menu (Day / Week / Month chart, Settings, Delete history).
• Hover → see today's full timeline with intervals, totals, and threshold status.

Status icons

Settings

Open the menu (double-click the icon) → Settings → enter a value between 1 and 2000 to change cup volume.

Data location

All records live in:

~/.drinkwater-data/data.json

Plain JSON — feel free to back up or sync via cloud drive.

中文

功能特性

• 一键记录：点击状态栏图标记一杯水，默认 350ml/杯
• 智能悬浮提示：鼠标悬停查看每次喝水时间、间隔、累计量、进度条和达标状态
• 阈值指示：到达 1500ml / 2000ml / 4000ml 时有视觉反馈
• 日 / 周 / 月统计图：基于 Chart.js 的柱状图和折线图
• 本地存储：数据保存在 ~/.drinkwater-data/data.json，不联网、不收集任何信息
• 自定义杯量：支持 1–2000ml
• 历史管理：支持多选按天删除历史记录
• 每日自动重置：新的一天自动从 0 开始

使用方法

安装后右下角状态栏会出现 🥤 0。

• 单击 → 记一杯水（+1），绿色高亮反馈
• 双击 → 打开菜单（按日查看 / 按周查看 / 按月查看 / 设置 / 删除历史）
• 悬停 → 查看今日完整记录、时间间隔、累计量和达标状态

状态图标

修改杯量

双击状态栏图标 → 设置 → 输入 1–2000 之间的数值。

数据存储位置

所有记录保存在：

~/.drinkwater-data/data.json

纯 JSON 格式，可自由备份或通过云盘同步到其他设备。

License

MIT