# 米多计时

**Repository Path**: moonwei/mido-timer

## Basic Information

- **Project Name**: 米多计时
- **Description**: 为儿子做一个没有广告的番茄计时工具，主打简洁和美观，现在主要是web和桌面应用，下一步要做成安卓的app。
- **Primary Language**: Rust
- **License**: LGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-16
- **Last Updated**: 2025-10-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 米多计时 (Mido Timer)

[![Rust](https://img.shields.io/badge/rust-2021-blue.svg)](https://www.rust-lang.org/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

米多计时是一款专为提高专注力而设计的番茄工作法计时器，采用Rust语言和egui框架开发，界面简洁美观，功能实用。

## 项目进度

- [x] 2025-10-15: 完成基础计时功能开发
- [x] 2025-10-15: 实现基础UI界面
- [x] 2025-10-15: 添加主题切换功能
- [x] 2025-10-15: 优化发布版本构建，去除命令行窗口
- [x] 2025-10-15: 修改应用名称为"米多计时"
- [x] 2025-10-15: 修改应用标识
- [x] 2025-10-15: 实现时段结束暂停计时功能
- [x] 2025-10-15: 添加声音提示功能
- [x] 2025-10-15: 实现弹出窗口提示功能
- [x] 2025-10-15: 调节界面组件尺寸和样式
- [ ] 添加设置和退出菜单
- [ ] 实现Material Design 3主题

## 功能特性

- 🍅 经典番茄工作法计时（专注/休息时段）
- 🔔 时段结束声音提示和弹窗提醒
- 🎨 多种主题颜色可选
- 🖥️ 跨平台支持（Windows/macOS/Linux）
- 📱 简洁直观的用户界面
- ⚡ 使用Rust语言，性能优异

## 开发计划

### 第一阶段：已完成
- [x] 将应用名称从"儿童专注计时器"修改为"米多计时"
- [x] 修改应用标识
- [x] 调整界面组件尺寸和样式
- [x] 实现专注和休息时段结束时暂停计时
- [x] 添加声音提示功能
- [x] 实现弹出窗口提示，支持用户选择操作

### 第二阶段：界面与主题优化（进行中）
- [ ] 添加设置和退出菜单
  - 实现顶部菜单栏
  - 添加设置选项（主题、音量等）
  - 添加退出应用功能
- [ ] 实现Material Design 3色彩体系的亮暗主题
  - 参考Android的Material Design 3色彩规范
  - 实现亮色和暗色两种主题模式
  - 保留现有的字体颜色方案
- [ ] 增强状态管理，正确显示专注和休息时段状态

## 技术栈

- **语言**: Rust 2021
- **框架**: egui + eframe
- **音频**: rodio
- **构建工具**: Cargo
- **字体支持**: egui_zhcn_fonts

## 快速开始

### 克隆项目

```bash
git clone <repository-url>
cd pomodoro-app
```

### 构建运行

开发模式运行：
```bash
cargo run
```

构建发布版本：
```bash
cargo build --release
```

发布版本位于 `target/release/pomodoro-app.exe` (Windows) 或 `target/release/pomodoro-app` (macOS/Linux)

## 使用说明

1. 选择预设的计时模式（25/5 或 45/15）或自定义专注和休息时间
2. 点击"开始"按钮开始计时
3. 点击"暂停"按钮暂停计时
4. 点击"重置"按钮重置计时器
5. 当专注或休息时段结束时，应用会播放提示音并弹出提示窗口
6. 在提示窗口中可以选择开始休息、继续专注或延长当前时段

## 主题设置

应用支持多种主题颜色：
- 蓝色主题
- 绿色主题
- 橙色主题
- 紫色主题

未来将支持Material Design 3的亮暗主题模式。

## 贡献

欢迎提交Issue和Pull Request来改进这个项目。

## 许可证

本项目采用MIT许可证，详情请见[LICENSE](LICENSE)文件。