utility

Utility OS 是一个面向大学生的单色学术工作空间，基于 Next.js、Firebase 和 Google Drive 同步构建。它将课程资料、规划功能和 AI 驱动的学习工具整合到一个可安装的 PWA 中。 核心功能： - 文档智能（混合 RAG）：基于幻灯片级别的分块检索，结合 BM25 关键词搜索与向量嵌入，引用特定幻灯片和文件的来源标注，并按分支和学期限定结果范围。 - Drive 同步运行时：Node 脚本将共享的 Google Drive 文件夹镜像到 Firestore，为搜索索引文档文本，并维护实时资源目录。 - 资源库：按分支、学期和科目组织的笔记、演示文稿、题库和往年试卷仓库。 - 学习计划器：支持自然语言输入的协作式周/月规划界面。 - GPA 计算器：自动填充科目列表，计算 SGPA/CGPA。 - SRS 闪卡：基于莱特纳间隔重复系统，用于备考。 - 专注计时器：番茄钟会话，支持活动追踪。 - PWA：可安装且支持离线使用的客户端。 技术栈包括 Next.js 16（App Router）、Tailwind CSS、Firebase（Firestore 和 Auth）、Google Drive API、Groq（用于聊天/摘要）、Gemini（用于嵌入）、Lucide React（用于图标）和 Framer Motion（用于动画）。 设置需要 .env.local 文件，包含 Firebase 凭据、Google Drive 文件夹 ID、Groq 和 Gemini API 密钥，以及可选的 Upstash Redis（用于生产环境限流）。项目支持通过 npm run dev 进行本地开发，并通过 GitHub Actions 在 UTC 00:00 定时执行每日 Drive 同步。