🍅 个性番茄钟 - macOS 菜单栏应用

一个简洁的 macOS 番茄钟应用，使用 Python + PyQt6 开发，专为提升专注力而设计。

Spotlight

✨ 核心功能

1. 🚀 5分钟快速专注模式

• 快捷键: ⌘ Command + ⇧ Shift + F
• 用途: 帮助快速摆脱短视频等干扰，进入专注状态
• 时长: 5分钟倒计时
• 提醒: 时间到达时系统通知提醒

2. 🍅 番茄钟计时功能

• 快捷键: ⌘ Command + ⇧ Shift + T (开始/停止)
• 标准番茄钟: 25分钟专注倒计时
• 正计时模式: 可以正向计时，不设限制
• 菜单控制: 点击菜单栏图标可以手动控制

3. � 学习记录功能（新功能！）

• 自动记录: 正计时模式下，停止并重置时自动触发记录
• 学习日记: 弹出对话框输入本次学习内容
• 时间统计: 自动记录学习时长和时间
• 日记文件: 所有记录保存在 diary.txt，格式优美易读

4. 🌙 AI 学习总结（新功能！）

• 智能总结: 点击"今天学习结束"，AI 自动总结今日学习
• 温柔御姐: DeepSeek AI 扮演成熟温柔的御姐，给予鼓励
• 个性化: 根据你今天的学习内容和时长生成定制总结
• 自动退出: 查看总结后程序自动退出

5. 🀽� 菜单栏显示

• 应用图标显示在 Mac 顶部菜单栏
• 实时显示计时状态
• 不占用 Dock 空间
• 始终可见，方便随时查看

🎯 快捷键说明

快捷键	功能	说明
⌘⇧F	5分钟专注	立即开始5分钟专注倒计时
⌘⇧T	番茄钟切换	开始/停止25分钟番茄钟

📦 快速开始

前置要求

• macOS 系统
• 已安装 Anaconda 或 Miniconda

一键启动

# 进入项目目录
cd /Users/yinzhitao/Desktop/个性番茄钟

# 激活环境并运行
conda activate pomodoro
python pomodoro.py

或者使用启动脚本：

chmod +x start.sh
./start.sh

📥 详细安装步骤

第一次使用

1. 创建 conda 环境（如果还没创建）

   conda create -n pomodoro python=3.9 -y

2. 安装依赖

   conda activate pomodoro
   pip install PyQt6 python-dotenv openai

3. 配置 DeepSeek API（用于 AI 总结功能）

   # 复制配置文件模板
   cp .env.example .env
   
   # 编辑 .env 文件，填入你的 API Key
   # DEEPSEEK_API_KEY=sk-your-actual-api-key
   # DEEPSEEK_BASE_URL=https://api.deepseek.com

4. 运行应用

   python pomodoro.py

🎨 界面说明

菜单栏状态

显示	含义
🍅	空闲状态
⚡ 05:00	5分钟专注模式（显示剩余时间）
🍅 25:00	番茄钟倒计时（显示剩余时间）
⏱️ 05:30	正计时模式（显示已用时间）

菜单选项

点击菜单栏的番茄图标，会显示以下选项：

• ⚡ 5分钟专注 (F) - 开始5分钟专注
• 🍅 番茄钟 25分钟 (T) - 开始标准番茄钟
• ⏱️ 正计时模式 (S) - 开始正向计时
• 📊 当前: xxx - 显示当前状态（不可点击）
• ⏹ 停止计时 - 停止当前计时
• 🔄 重置 - 重置到初始状态（正计时模式下会触发记录）
• 🌙 今天学习结束 - 生成 AI 总结并退出
• ❌ 退出 - 直接退出应用

💡 使用技巧

1. 快速专注：每当想刷短视频时，按 ⌘⇧F 开始5分钟专注，帮助自己克服冲动
2. 番茄工作法：使用 ⌘⇧T 开始25分钟专注工作，完成后休息5分钟
3. 记录学习：
   • 点击"正计时模式"开始学习
   • 学习结束后，点击"停止计时"
   • 再点击"重置"，会弹出对话框让你记录学习内容
   • 学习时长和内容会自动保存到 diary.txt
4. 每日总结：
   • 一天学习结束后，点击"今天学习结束"
   • AI 会读取今天的所有学习记录
   • 生成温柔御姐风格的总结和鼓励
   • 查看总结后程序自动退出

📊 学习日记格式

日记文件 diary.txt 会按以下格式记录：

============================================================
📅 日期: 2025-11-07
⏰ 时间: 14:30
⏱️  时长: 45分30秒
📝 内容: 学习了 Python 装饰器和生成器
============================================================

🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟
🌙 2025-11-07 每日总结 (23:00)
🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟🌟

（这里是 AI 生成的温柔御姐风格总结）

============================================================

🔧 系统要求

• macOS 10.14 或更高版本
• Python 3.9+
• Anaconda/Miniconda

📝 技术特性

• ✅ Python + PyQt6：简单易懂，易于修改
• ✅ 应用内快捷键：支持 ⌘⇧F 和 ⌘⇧T
• ✅ macOS 原生通知：使用 osascript 调用系统通知
• ✅ 菜单栏应用：显示在顶部状态栏
• ✅ 实时更新：每秒更新计时显示

🎓 应用场景

1. 对抗短视频成瘾：每次想看短视频时，先用5分钟专注模式
2. 工作学习：使用番茄钟保持专注
3. 时间管理：追踪和记录各项任务用时

🐛 故障排除

快捷键不响应

• 注意：应用窗口需要在前台才能响应快捷键
• 或者直接点击菜单栏图标使用菜单

没有通知

1. 检查终端是否有权限发送通知
2. 进入 系统偏好设置 > 通知与专注模式
3. 找到 Terminal 或 Python，确保通知已开启

图标不显示在菜单栏

• macOS 可能需要一点时间显示
• 尝试移动鼠标到菜单栏右上角
• 重启应用

📄 许可证

个人使用，自由修改。

🙏 反馈

如有问题或建议，欢迎反馈！

---

开始专注之旅吧！🚀