# Tomato Clock

**Repository Path**: smellydumpling/tomato-clock

## Basic Information

- **Project Name**: Tomato Clock
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-26
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🍅 番茄钟 (Pomodoro Timer)

一个简洁优雅的番茄钟应用，基于 **React + Vite** 构建，帮助你专注于工作与学习。

## ✨ 功能特性

- ⏱️ **25 分钟倒计时** — 标准的番茄工作法时间周期
- ☕ **休息提醒** — 工作完成后自动切换休息（5 分钟短休 / 15 分钟长休，每 4 个番茄一次长休）
- 📊 **完成计数** — 记录今日完成番茄数量，直观显示会话进度
- 🔊 **音效提示** — 使用 Web Audio API 生成提示音，无需外部音频文件
- ⏸️ **暂停/继续** — 随时暂停与恢复倒计时
- 🎨 **双主题配色** — 工作模式番茄红 🍅 / 休息模式清新绿 🌿
- 📱 **响应式设计** — 完美适配桌面与移动端
- 🔄 **实时浏览器标题** — 切后台也能看到剩余时间

## 🚀 快速开始

```bash
# 克隆仓库
git clone https://gitee.com/smellydumpling/tomato-clock.git
cd tomato-clock

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 生产构建
npm run build
```

## 🛠️ 技术栈

| 技术 | 用途 |
|------|------|
| [React](https://react.dev) | UI 框架 |
| [Vite](https://vite.dev) | 构建工具 |
| [Web Audio API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API) | 音效生成 |

## 📁 项目结构

```
src/
├── main.jsx                # 应用入口
├── App.jsx                 # 主组件
├── index.css               # 全局样式
├── hooks/
│   └── useTimer.js         # 核心计时逻辑 Hook
├── components/
│   ├── TimerDisplay.jsx    # 倒计时数字显示
│   ├── StatusLabel.jsx     # 状态标签
│   ├── ProgressIndicator.jsx # SVG 环形进度条
│   ├── ControlButtons.jsx  # 控制按钮
│   └── CounterDisplay.jsx  # 完成计数显示
└── utils/
    └── sound.js            # Web Audio API 音效
```

## 📄 许可证

[MIT](LICENSE) © 2025 smellydumpling