Skip to content

Repository files navigation

StudyFlow

把学习的计划、开始、记录和复盘,放在同一条路上。

立即体验

打开 StudyFlow

无需下载,无需注册。用浏览器打开后,创建一件今天真实要做的事即可开始;觉得顺手时,也可以把它安装到手机或桌面,像普通 App 一样使用。

它解决什么问题

学习工具通常不缺:待办、日历、番茄钟、笔记各有一个。难的是把“想做”“开始做”“实际做了多少”和“下次怎么调整”接起来。

StudyFlow 是一个本地优先的个人学习工具。它不替你决定人生计划,只把一次学习从安排到复盘的过程留下来:

目标与任务 → 今天先做什么 → 专注执行 → 如实记录 → 回看与调整

30 秒开始

  1. 目标树计划中心Today 新建一件真实任务,例如“高数第 3 章习题 30 分钟”。
  2. Today 选定下一件要做的事。
  3. 点击开始,使用正计时或番茄钟进入 Focus
  4. 结束时如实选择完成、部分完成或未完成,并留下必要的原因或备注。
  5. History 与每日复盘中查看今天实际投入了什么。

主要功能

计划,不只是列清单

  • 用月度目标、周里程碑和今日行动组织学习事项。
  • 通过四象限、任务列表、分类、状态和日期筛选理清优先级。
  • 在 Today 同时看到今天的任务、预计时长、实际专注和完成情况。

专注,记录真实发生的学习

  • 支持正计时与番茄钟,以及暂停、恢复、休息和结束。
  • 番茄钟可设置专注时长、休息时长与轮数;实际专注时间单独记录。
  • 进行中的会话会在页面刷新和多标签页间恢复,方便从中断处回来。

记录与复盘,方便下次做得更贴近现实

  • 记录完成结果、部分完成或未完成的原因、总结与备注。
  • 在 History 按日期、分类、任务和结果回看学习与冥想记录。
  • 支持带原因的记录修正,保留修改前后的时间线。

为持续投入留一点看得见的反馈

  • 学习会话驱动成长树与 Today 花园,今天的投入会留下生长记录。
  • 内置定时或自由 Meditation、呼吸引导与冥想复盘;冥想和学习分别计时、统一回看。

数据与隐私

StudyFlow 当前没有账号和云同步。数据默认保存在你正在使用的浏览器中(IndexedDB):

  • 同一浏览器内刷新或关闭后,任务与进行中的会话会尝试恢复。
  • 不同设备、浏览器和网址之间不会自动同步。
  • 清除浏览器站点数据可能删除记录;请定期在“数据管理”中导出 JSON 备份。
  • 覆盖导入前,应用会先为当前数据创建一份安全备份。

安装为 PWA(可选)

打开上方体验链接后:

  • iPhone / iPad:使用 Safari 的“分享” → “添加到主屏幕”。
  • Android:使用 Chrome 菜单中的“安装应用”或“添加到主屏幕”。
  • Windows / macOS:使用 Chrome 或 Edge 地址栏附近的安装按钮;没有按钮时,继续用网页即可。

安装不等于云同步。首次在线打开后,已缓存的页面可在离线时使用;本地数据仍只保存在当前浏览器中。

本地运行

需要 Node.js 24 或更高版本。

git clone https://github.com/MingLeeEatPy/studyflow.git
cd studyflow
npm install
npm run dev

随后访问终端显示的本地地址(默认是 http://127.0.0.1:5173)。

常用检查命令:

npm run typecheck
npm run lint
npm run test
npm run build

反馈与参与

遇到“看不懂、找不到入口、点了没反应,或不知道下一步该做什么”的时刻,都欢迎提交反馈。请尽量附上:

  • 截图或录屏;
  • 你原本想完成的事;
  • 设备与浏览器信息。

可以通过 Issues 提交问题或建议,也欢迎 Fork 后提交 Pull Request。

License

MIT License

About

StudyFlow — Web-first personal study planning and execution assistant

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages