exam-porridge-assistant
考试粥助手 - AI驱动的学习与考试辅助工具（调用API）
A browser-based study tool that turns your uploaded notes, PDFs, and images into AI-generated outlines, flashcards, and practice questions, with a drill mode that tracks your wrong answers so you focus on what you actually need to review.
Exam Porridge Assistant is a study and exam preparation tool that runs locally in your browser. You upload learning materials such as PDFs, Word documents, text files, or images, and it uses an AI language model to generate review outlines, study notes, and practice questions from the content. Practice questions can be multiple choice, fill-in-the-blank, true or false, or short answer. The README is written in Chinese and the tool appears to target Chinese-language learners and students.
The tool also includes a drill mode where you work through a question set and have wrong answers tracked automatically. Those tracked errors feed into targeted follow-up practice, so you spend more time on material you got wrong. Study data is organized by course and stored entirely in your browser's local storage, with nothing sent to any external server. Clearing your browser data would delete all stored records.
To use the AI features, you supply your own API key from a supported provider, such as DeepSeek, Alibaba's Tongyi Qianwen, or OpenAI. The application calls that API directly from your browser on demand. OCR (converting images of text into editable text) requires a key from a provider whose model supports image input. The README walks through getting a DeepSeek key as the primary example.
The application is built with TypeScript, React 18, and Tailwind CSS. Local data is stored using IndexedDB through a library called Dexie. It runs on a local development server you start with a Node.js command and then access in your browser at a local address. The README includes detailed setup instructions aimed at users with no prior coding experience, covering Windows, macOS, and Linux.
Where it fits
- Upload lecture slides or textbook PDFs and instantly get a study outline and practice questions without manual summarizing.
- Run timed drill sessions before an exam and let the app automatically track which questions you got wrong for targeted follow-up.
- Import photos of handwritten notes or printed worksheets and have the AI convert and turn them into a quiz.
- Organize study materials by course and review everything offline with no data ever leaving your own computer.