考试粥助手

一款基于 AI 的本地化学习与考试辅助工具。

上传资料，AI 自动生成复习纲要、学习笔记和练习题，支持刷题、错题追踪和针对性训练。

所有数据完全存储在本地浏览器中，不依赖任何云端服务。

📋 功能一览

Git 是一个代码管理工具，用来把项目从 GitHub 下载到你的电脑上。

Windows（点击展开）

macOS（点击展开）

安装 Homebrew（若已安装可跳过）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux（以 Ubuntu 为例）（点击展开）

更新软件包列表并安装 Git：

sudo apt update
sudo apt install git -y

其他发行版：Fedora 使用 sudo dnf install git，Arch Linux 使用 sudo pacman -S git。

验证安装： 在终端中输入：

git --version

看到类似 git version 2.xx.x 的输出即安装成功。

Node.js 是运行本项目所必需的 JavaScript 运行时。

Windows（点击展开）

macOS（点击展开）

方法一（推荐）：使用 Homebrew

brew install node

方法二：从官网下载

Linux（以 Ubuntu 为例）（点击展开）

sudo apt update
sudo apt install nodejs npm -y

如需最新版本，建议使用 nvm 安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 重启终端后
nvm install --lts

验证安装： 在终端中输入：

node --version
npm --version

看到类似 v20.11.0 和 10.2.4 的版本号即成功。

打开终端，进入你希望存放项目的目录，然后运行：

git clone https://github.com/zjuhechao/exam-porridge-assistant.git
cd exam-porridge-assistant

npm install

首次安装需要下载约 200MB 的依赖包，耗时 2-5 分钟。出现黄色的 WARN 警告是正常的。

如果安装很慢或失败： 切换到国内镜像源后重试：
npm config set registry https://registry.npmmirror.com
npm install

npm run dev

等待几秒钟，当终端显示 webpack compiled successfully 时，说明启动成功。

启动后这个终端窗口不要关闭，关闭终端即关闭应用。

打开浏览器，在地址栏输入：

http://localhost:3015

按回车，即可看到考试粥助手的首页。