Skip to content

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

专注时光 - 待办与番茄钟 (PomoReward)

一款结合番茄钟、任务管理和积分奖励机制的专注工具,帮助你高效专注、完成任务并实现心愿。

版本:v1.1.0 技术栈:HTML | TailwindCSS | JavaScript 授权协议:MIT

核心功能

专注番茄钟

  • 自定义专注时长(1-120分钟)和休息时长(1-30分钟)
  • 🆕 自由模式:支持正计时模式,不受固定时长限制,进度条始终100%
  • 🆕 双模式切换:可随时在番茄钟倒计时模式和自由正计时模式之间切换
  • 多专注模块支持(默认、阅读、编程等),可自定义模块名称和每分钟积分奖励
  • 实时进度环展示,专注完成自动获得对应积分
  • 🆕 智能状态切换:一键在专注和休息状态间切换,操作更便捷
  • 专注结束自动提示,清晰的状态切换(待开始/专注中/休息中)

任务管理

  • 支持添加普通任务和习惯任务
  • 习惯任务可设置:
    • 每日重复(永久)
    • 限时完成(自定义持续天数)
  • 任务完成自动获得积分奖励
  • 习惯任务每日自动重置状态

心愿清单

  • 添加心愿并设置所需积分
  • 用完成任务和专注获得的积分兑换心愿
  • 心愿兑换记录追踪

模块管理

  • 自定义专注模块,设置不同模块的积分奖励
  • 编辑/删除现有模块,适配不同专注场景

积分系统

  • 专注时长积分(按分钟计算,番茄钟和自由模式均支持)
  • 任务完成积分奖励
  • 心愿兑换积分扣除
  • 积分数据本地持久化存储

界面特色

  • 清新的纸质纹理设计风格
  • 响应式布局,适配PC和移动端
  • 玻璃拟态效果,提升视觉体验
  • 流畅的过渡动画和交互反馈
  • 🆕 更简洁的控制界面:单按钮智能切换,减少视觉干扰
  • 中文友好的界面设计

快速开始

在线使用

直接打开 "index.html" 文件即可使用,无需安装任何依赖。

本地部署

  1. 克隆仓库:
git clone https://github.com/freytesla/PomoReward.git
cd PomoReward
  1. 直接打开HTML文件:

    • 双击 "index.html"
    • 或使用浏览器打开该文件
  2. 开始使用:

    • 无需配置,直接使用所有功能
    • 数据存储在浏览器本地存储中

使用指南

基础操作

  1. 设置专注时长:在番茄钟设置区域调整专注/休息时长
  2. 选择计时模式:
    • 默认番茄钟模式:倒计时,时间到自动切换
    • 自由模式:勾选"自由模式"复选框,正计时,无时间限制
  3. 选择专注模块:从模块列表中选择,或自定义新模块
  4. 开始专注:点击"开始专注"按钮,进入专注状态
  5. 切换状态:再次点击按钮在专注和休息状态间切换
  6. 添加任务:填写任务名称、积分奖励、任务类型
  7. 完成任务:勾选任务复选框,自动获得积分
  8. 添加心愿:填写心愿名称、所需积分、描述
  9. 兑换心愿:积分足够时点击"兑换心愿"按钮

高级功能

  • 管理专注模块:点击"管理模块"按钮,自定义模块设置
  • 全局重置:点击右上角"重置"按钮,恢复初始状态
  • 查看说明:点击左上角"说明"按钮,查看详细使用说明
  • 灵活切换模式:根据任务需求随时在番茄钟和自由模式间切换

模式选择建议

番茄钟模式适用场景:

  • 需要严格时间管理
  • 养成固定工作节奏
  • 短时间高强度任务
  • 需要定时休息提醒

自由模式适用场景:

  • 深度工作需要长时间专注
  • 任务时间不确定
  • 想要灵活控制休息时长
  • 创意工作或心流状态

适配说明

  • 移动端:上下布局(番茄钟在上,任务/心愿在下)
  • PC端:左右布局(番茄钟在左,任务/心愿在右)
  • 适配主流浏览器(Chrome、Firefox、Safari、Edge)

数据存储

所有数据(任务、心愿、积分、模块设置等)均存储在浏览器的 localStorage 中:

  • 数据持久化,关闭页面后不会丢失
  • 支持全局重置功能,一键恢复初始状态
  • 数据格式:JSON

技术栈

  • HTML5(语义化标签)
  • Tailwind CSS(样式框架)
  • Font Awesome(图标库)
  • JavaScript(原生,无框架)
  • 本地存储(localStorage)

许可证

本项目采用 MIT 许可证,详见 LICENSE 文件

作者信息

更新日志

✨v1.1.0 (2025-02-21)

新增功能:

  • 新增自由模式:支持正计时,不受固定时长限制
  • 专注/休息自由模式独立切换:可分别为专注和休息设置计时方式

功能优化:

  • 简化控制按钮:将"开始"、"暂停"、"重置"整合为一个智能切换按钮
  • 一键状态切换:在专注和休息状态间快速切换

Bug修复:

  • 修复代码结尾不完整导致的功能异常
  • 补全JavaScript闭合代码和初始化逻辑

v1.0.1 (2025-02-16)

  • 每分钟实时累积积分功能
  • 优化积分计算逻辑

v1.0.0 (2025-02-16)

  • 初始版本发布
  • 核心功能:番茄钟、任务管理、心愿清单
  • 基础积分系统
  • 响应式界面设计

温馨提示

  • 建议定期备份重要数据(可手动导出localStorage数据)
  • 清理浏览器缓存会导致本地数据丢失
  • 不同浏览器的数据不互通
  • 自由模式下依然按分钟累积积分
  • 切换计时模式不会影响当前计时状态

常见问题

Q: 自由模式和番茄钟模式有什么区别? A: 番茄钟模式是倒计时,时间到自动切换;自由模式是正计时,进度条始终100%,适合不想被时间限制的场景。

Q: 如何在两种模式间切换? A: 勾选或取消"自由模式"复选框即可,专注和休息可分别设置。

Q: 自由模式下还能获得积分吗? A: 可以!自由模式下专注状态依然按分钟累积积分。

Q: 按钮文字为什么会变化? A: 按钮文字反映下一步操作,如当前在专注中,按钮显示"开始休息";当前在休息中,按钮显示"开始专注"。

About

Pomodoro focus app with task list, points and reward system.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages