Pomodoro

一个轻量化番茄钟项目，目标是只保留两件事：纯粹的番茄钟，以及把本地专注记录导出成文件。

当前仓库处于第一版设计阶段。第一版计划做成 Android 优先的 PWA，先保证能快速使用、离线打开、记录可靠、可导出，后续再考虑打包成 APK 或接入真正的数据上传服务。

第一版目标

• 固定 25 分钟专注 + 5 分钟休息。
• 移动端优先，适配 Android 浏览器和 PWA 添加到桌面。
• 首页采用轻统计单屏布局：倒计时、状态、开始/暂停/继续按钮、今日完成数、当前番茄数。
• 专注完成后保存一条本地记录。
• 支持导出 CSV 和 JSON 文件。
• 不做账号、不做任务列表、不做复杂统计、不做云同步。
• 第一版不做系统通知、震动、铃声或后台提醒。

计划技术栈

• Vite
• React
• TypeScript
• PWA manifest
• 基础 service worker 离线缓存
• localStorage 本地保存完成记录

第一版会优先保持工程简单。计时、存储、导出和 UI 会分成独立模块，方便以后迁移到 Capacitor Android 壳。

数据导出

每次完成一个 25 分钟专注后，生成一条记录：

type PomodoroRecord = {
  id: string;
  startedAt: string;
  endedAt: string;
  durationMinutes: 25;
  type: "focus";
};

CSV 字段：

id,startedAt,endedAt,durationMinutes,type

JSON 导出结构：

type PomodoroExport = {
  exportedAt: string;
  records: PomodoroRecord[];
};

设计文档

完整的第一版设计见：

docs/superpowers/specs/2026-05-10-lightweight-pomodoro-pwa-design.md

路线图

• 搭建 Vite + React + TypeScript PWA 工程。
• 实现固定 25/5 番茄钟状态机。
• 实现本地记录存储。
• 实现 CSV/JSON 文件导出。
• 完成移动端 UI。
• 验证离线打开和 Android 添加到桌面。
• 后续评估 Capacitor Android 打包。
• 后续评估通知提醒、可配置时长和后端上传。

License

MIT