Skip to content

Lin20505/Smart-Final-Planner

Repository files navigation

Run and deploy your AI Studio app

This contains everything you need to run your app locally.

View your app in AI Studio: https://ai.studio/apps/drive/1ikYCDdFKpH60L1AMyC10mr0hfUBxXTNA

Run Locally

Prerequisites: Node.js

  1. Install dependencies: npm install
  2. Set the GEMINI_API_KEY in .env.local to your Gemini API key
  3. Run the app: npm run dev

🎓 智能复习计划助手:功能亮点

智能复习计划助手 是一款基于人工智能的学习规划应用,旨在将模糊的学习目标转化为具体、可执行且灵活的复习时间表。与传统的日历应用不同,它专注于学习策略、高 ROI(投入产出比)活动以及应对现实生活中各种变数的灵活性。

🚀 核心功能

1. 🧠 AI 驱动的深度规划 (Gemini 3 Pro)

本应用由 Google Gemini 3 Pro (Thinking Model) 驱动,它不仅仅是列出任务,更像是一位专业的私人辅导员:

策略分析: AI 会分析您提供的空闲时间段,生成一份 策略表 (Strategy Table),明确建议每个时间段的“High ROI(高价值)”活动和应避免的“Low ROI(低效)”行为。 智能分配: 根据学习规律(学习 → 复习 → 模考),自动将科目内容、截止日期(DDL)合理分配到数周的计划中。

2. ⚡ 动态 "Plan B" 与自适应调整

计划赶不上变化?没关系,本应用专为灵活性而生:

Plan B / 额外任务:

突然有了额外时间?或者完成了计划外作业?点击任意一天的 "+ Plan B / Extra" 按钮,即可快速添加新任务。这些任务会被标记为紫色,作为对您额外努力的奖励。 行内编辑: 发现任务标题有误?或者想修改具体复习内容?点击 铅笔图标 即可在列表页直接修改任务名称和所属的时间段分类,无需繁琐跳转。

一键顺延:

今天的任务没做完?点击 "Postpone" (顺延) 按钮,任务会自动移动到第二天,确保不会被遗忘。

3. 📊 可视化进度追踪

通过清晰的视觉反馈,保持您的学习动力:

实时进度条: 顶部常驻悬浮栏显示总体完成率和当前周的进度,让您对整体状况一目了然。 状态颜色编码: 🟢 绿色: 按计划完成的任务。 🟣 紫色: "Plan B"(额外/计划外)完成的任务——鼓励您的每一次额外付出。 🟠 橙色: 已顺延的任务。 撤销功能: 手滑点错了?完善的 Undo (撤销) 机制允许您随时回退任务状态。

4. 📑 专业报告与数据迁移

您的数据完全掌握在自己手中,易于分享和备份:

可视化进度报告 (HTML): 一键生成精美的 周报总结 (Progress Report)。报告以周视图网格形式展示,高亮显示已完成 vs 计划中的任务,并包含详细的统计数据,非常适合打印或归档。 JSON 数据备份: 支持导出完整的计划数据为 JSON 文件。您可以在不同设备间迁移数据,或通过“导入 JSON”功能随时恢复之前的进度。

5. 🔄 迭代式工作流

修改需求与重生成: 发现原本设定的 4 周不够用?或者想增加一个新科目?点击顶部的 "Edit Requirements" (修改需求) 按钮,即可返回向导界面修改输入条件,并在保留当前计划上下文的基础上重新生成时间表。 本地持久化: 所有操作自动保存至浏览器本地存储 (Local Storage),刷新页面也不会丢失进度。

🛠 用户体验 (UX)

极简无干扰界面: 采用 Tailwind CSS 设计,清爽整洁,专注于内容本身。 可折叠周视图: 支持折叠过去或未来的周次,让您专注于当下的任务。 移动端适配: 完美适配手机屏幕,随时随地查看和管理您的复习进度。

🤖 技术栈

前端框架: React 19, TypeScript, Tailwind CSS AI 引擎: Google Gemini API (gemini-3-pro-preview) - 配置了高思维预算 (Thinking Budget) 以确保规划质量。 图标库: Lucide React - 提供直观的视觉引导。

About

可以分配各种期末复习任务和琐碎ddl的计划表!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors