zuhairhalawa/studyai

如果你手头正好是 PowerPoint 讲座课件，想要一套自己掌控的学习流程，值得看看；如果你期待开箱即用的在线服务或零配置的 AI 辅导，则不合适。

解决什么问题

手里攒着一堆讲座 PPT 的学生，通常要在 PDF 阅读器、笔记应用和单独的闪卡工具之间来回切换，再把重点手动抄一遍。StudyAI 改变的正是这一步：导入 .pptx 文件后，它把幻灯片画在提取出的文字和表格旁边，你可以在同一屏里阅读、跨全部讲座搜索，并直接把定义做成闪卡或练习题的评分点，而不是先复制到另一个应用。需要备份时，可以从设置里导出包含全部内容的 ZIP。

有什么不同

它的特点是把尽量忠实的课件提取和本地存储结合起来。文字、表格、图表、SmartArt、演讲者备注和公式都会被读出（公式用 KaTeX 渲染），无法提取文字图片会被标出，让你手动补录；提取报告会说明哪些内容被理解、哪些没有。所有数据存放在浏览器的 IndexedDB 中，README 称有测试确保学习应用不发起第三方请求。

AI 辅导是第二个有意的设计选择：它完全可选，运行在你自己部署的 Cloudflare Worker 上，用自己的 Google Gemini 免费额度密钥，回答基于你的幻灯片并注明来自哪一页。这让你不必把课件交给别人的托管服务，但代价是 AI 部分不能随手打开——部署、密钥和额度都由你负责。本地优先同样有代价：资料库绑定在某个浏览器地址下，迁移或恢复只能靠导出备份，而不是一个中心账号。

谁值得试

适合拿到 .pptx 课件、主要在一台笔记本和一个浏览器配置上学习、希望把间隔复习、练习题和搜索放在一起又不注册账号的大学生。也适合愿意部署一个小型 Cloudflare Worker、让 AI 回答能指回具体幻灯片的人。不太适合需要在多台设备或多个浏览器之间学习的人，也不适合希望有现成托管服务、由别人维护后端的人；地址绑定的资料库和自托管 AI 都与这两种期待冲突。只想用阅读、闪卡和考试这些核心功能的话，README 明确给出了不启用 AI 的快速开始方式，并不需要 Gemini 或 Cloudflare。

使用条件与边界

不用 AI 的路径需要 Node 22 或更高版本和 pnpm 11，并且从源码本地运行，没有提供打包好的安装程序。开发服务器在 5173 端口被占用时会直接报错，而不是换端口，因为换端口就等于换成一个空资料库；生产安全响应头只有在 pnpm build 后再 pnpm preview 才会带上。旧的 .ppt 必须先在 PowerPoint 里另存为 .pptx，混合格式的课件可能需要先转换。

启用 AI 辅导则多出持续维护成本：需要在 Google AI Studio 里创建一个显示免费额度、没有绑定账单的项目的密钥，把本地密钥放进被 git 忽略的 .dev.vars，再部署自己的 Worker 并配置允许的主机。项目按 Gemini 免费额度设计为零花费运行，README 说在你确认没有绑定账单之前会拒绝启用 AI；依赖免费额度前，先确认你自己的项目确实处于这种状态。

HotRepo 点评

在 2026-10-25 的 TypeScript 新项目榜上，该项目显示 212 个总 star、排名第 25——这是榜单位置，不是单日增长，而且目前只有这一个带日期的观测。项目仅 6 天、只有单次快照，暂时无法判断关注度能否持续。投入学习时间之前，建议先确认文档中的备份与恢复流程，以及地址绑定的资料库是否真的匹配你的设备和浏览器使用习惯。

项目源码与说明