# clock

**Repository Path**: guangang/clock

## Basic Information

- **Project Name**: clock
- **Description**: 简洁版本的番茄闹钟
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-08
- **Last Updated**: 2026-02-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🍅 番茄钟 (Pomodoro Timer)

一个简单实用的番茄钟桌面应用，使用 Python + CustomTkinter 开发。

## 功能特点

- ✅ 三种计时模式：工作(25分钟) / 短休息(5分钟) / 长休息(15分钟)
- ✅ 现代化 UI 界面
- ✅ 进度条显示
- ✅ 强制提醒：全屏遮罩 + 窗口置顶 + 闪烁效果
- ✅ 音效提醒
- ✅ 开始/暂停/重置控制

## 运行方式

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 运行程序

```bash
python clock/main.py
```

或者：

```bash
cd clock
python main.py
```

## 打包成 .exe

### 使用 PyInstaller 打包

```bash
# 单文件打包
pyinstaller --onefile --windowed --icon=clock/assets/icon.ico clock/main.py

# 或者使用文件夹模式（启动更快）
pyinstaller --windowed --icon=clock/assets/icon.ico clock/main.py
```

打包完成后，.exe 文件在 `dist` 目录下。

## 自定义音效

将你喜欢的音效文件放到 `clock/assets/alarm.wav`，支持格式：
- .wav
- .mp3
- .ogg

如果没有音效文件，程序会使用系统默认的 beep 声。

## 技术栈

- **Python 3.8+**
- **CustomTkinter** - 现代化 UI 框架
- **Pygame** - 音效播放
- **PyInstaller** - 打包成 .exe

## 项目结构

```
clock/
├── main.py              # 主程序入口
├── timer_logic.py       # 计时器核心逻辑
├── ui/
│   └── main_window.py   # UI 界面
├── assets/
│   ├── alarm.wav        # 提示音效（可选）
│   └── icon.ico         # 应用图标（可选）
├── tests/
│   └── test_timer_logic.py  # 单元测试
└── requirements.txt     # 依赖列表
```

## 开发

### 运行测试

```bash
pytest clock/tests/
```

### TDD 开发流程

本项目采用测试驱动开发（TDD）：
1. 先编写测试
2. 实现功能
3. 运行测试确保通过

## License

MIT