Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

🌱 学习使人强大

一个功能完整的学习管理Web应用,集成了番茄钟计时器、任务管理、每日任务打卡等功能,帮助您提高学习效率和专注力。

✨ 主要功能

🍅 番茄钟计时器

  • 工作模式: 25分钟专注工作时间
  • 短休息: 5分钟短暂休息
  • 长休息: 15分钟长时间休息
  • 自由模式: 不限时间的自由计时
  • 专注模式: 全屏专注界面,减少干扰
  • 进度追踪: 可视化番茄钟完成进度

📝 任务管理

  • 任务创建: 添加标题、描述、优先级、分类等
  • 优先级管理: 高、中、低三个优先级
  • 分类过滤: 按分类筛选任务
  • 截止日期: 设置任务截止时间
  • 时间估算: 预估任务完成时间
  • 完成状态: 标记任务完成状态

📅 每日任务

  • 每日打卡: 创建需要每天完成的任务
  • 完成追踪: 记录每日任务完成情况
  • 习惯养成: 帮助建立良好的学习习惯

📊 数据统计

  • 今日统计: 今日学习时间、完成任务数、番茄钟数
  • 总体统计: 总学习时间、总任务数、总番茄钟数
  • 连续天数: 当前连续学习天数和最佳记录

👤 用户系统

  • 多用户支持: 支持多个用户账号
  • 数据隔离: 每个用户的数据独立存储
  • 默认账号: admin/admin(用户名/密码)

⚙️ 设置功能

  • 时间自定义: 自定义工作时间、休息时间
  • 通知设置: 声音提醒和桌面通知
  • 数据管理: 导出/导入数据,数据备份

🚀 快速开始

在线使用

  1. 下载 index.html 文件
  2. 用浏览器打开文件
  3. 使用默认账号登录:
    • 用户名: admin
    • 密码: admin

本地部署

# 克隆或下载项目
git clone [项目地址]

# 进入项目目录
cd study-app-opensource

# 用浏览器打开 index.html
# 或者使用本地服务器
python -m http.server 8000
# 然后访问 http://localhost:8000

📱 使用说明

首次使用

  1. 打开应用后会看到登录界面
  2. 使用默认账号 admin/admin123 登录
  3. 或者点击"注册新账号"创建自己的账号

番茄钟使用

  1. 点击"🍅 番茄钟"标签
  2. 选择工作模式(工作/短休息/长休息/自由模式)
  3. 可选择输入当前任务
  4. 点击"开始"按钮开始计时
  5. 可以使用"专注模式"进入全屏专注界面

任务管理

  1. 点击"📝 任务管理"标签
  2. 填写任务信息并点击"添加任务"
  3. 在任务列表中可以完成、删除任务
  4. 使用分类标签过滤不同类型的任务

每日任务

  1. 点击"📅 每日任务"标签
  2. 添加需要每天完成的任务
  3. 每天可以打卡完成状态
  4. 在仪表盘查看今日每日任务完成情况

数据管理

  1. 点击"⚙️ 设置"标签
  2. 在"数据管理"部分可以:
    • 导出数据:下载JSON格式的数据备份
    • 导入数据:从备份文件恢复数据
    • 清空数据:删除所有数据(谨慎操作)

🛠️ 技术特性

前端技术

  • 纯HTML/CSS/JavaScript: 无需额外依赖
  • 响应式设计: 支持桌面和移动设备
  • 现代CSS: 使用渐变、阴影、动画等现代效果
  • 本地存储: 使用localStorage保存数据

功能特性

  • 离线使用: 完全本地运行,无需网络
  • 数据持久化: 数据保存在浏览器本地存储
  • 跨平台: 支持Windows、macOS、Linux
  • 多浏览器: 支持Chrome、Firefox、Safari、Edge

安全特性

  • 本地数据: 所有数据存储在本地,保护隐私
  • 无网络请求: 不会向外部发送任何数据
  • 开源透明: 代码完全开源,可审查

📋 系统要求

浏览器支持

  • Chrome 60+
  • Firefox 55+
  • Safari 12+
  • Edge 79+

功能要求

  • 支持localStorage的现代浏览器
  • 支持ES6语法的JavaScript引擎
  • 支持CSS Grid和Flexbox布局

🎨 界面特色

设计风格

  • 绿色主题: 使用绿色系配色,营造自然学习氛围
  • 毛玻璃效果: 现代化的毛玻璃背景效果
  • 动画交互: 流畅的悬停和点击动画
  • 渐变背景: 多层次渐变背景增强视觉效果

用户体验

  • 直观操作: 简洁明了的界面设计
  • 即时反馈: 操作后立即显示结果
  • 状态提示: 清晰的状态指示和通知
  • 快捷操作: 支持键盘快捷键

📊 数据格式

用户数据结构

{
  "username": "用户名",
  "password": "密码",
  "stats": {
    "totalTime": 0,
    "totalTasks": 0,
    "totalPomodoros": 0,
    "currentStreak": 0,
    "bestStreak": 0
  },
  "tasks": [],
  "dailyTasks": [],
  "dailyStats": {}
}

导出数据格式

{
  "user": "用户数据对象",
  "settings": "设置对象",
  "exportDate": "导出时间"
}

🔧 自定义配置

番茄钟时间设置

  • 工作时间:1-60分钟(默认25分钟)
  • 短休息:1-30分钟(默认5分钟)
  • 长休息:1-60分钟(默认15分钟)
  • 长休息间隔:2-10个番茄钟(默认4个)

通知设置

  • 声音提醒:开启/关闭
  • 桌面通知:开启/关闭(需要浏览器权限)

🤝 贡献指南

如何贡献

  1. Fork 本项目
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 创建 Pull Request

开发建议

  • 保持代码简洁和可读性
  • 添加适当的注释
  • 测试新功能的兼容性
  • 遵循现有的代码风格

📝 更新日志

v1.0.0 (2025-7-14)

  • ✨ 初始版本发布
  • 🍅 番茄钟计时器功能
  • 📝 任务管理系统
  • 📅 每日任务打卡
  • 📊 数据统计面板
  • 👤 多用户支持
  • ⚙️ 设置和数据管理

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

  • 感谢所有为开源社区做出贡献的开发者
  • 感谢番茄工作法的创始人Francesco Cirillo
  • 感谢所有使用和反馈的用户

📞 联系方式

如果您有任何问题或建议,欢迎通过以下方式联系:

  • 提交 Issue
  • 发起 Pull Request

🌱 让学习成为一种习惯,让专注成为一种力量!

About

tomatoclock

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages