[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82109":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":15,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":14,"starSnapshotCount":14,"syncStatus":12,"lastSyncTime":24,"discoverSource":25},82109,"exam-porridge-assistant","zjuhechao\u002Fexam-porridge-assistant","zjuhechao","考试粥助手 - AI驱动的学习与考试辅助工具（调用API）",null,"TypeScript",25,2,21,0,4,1.43,false,"main",true,[],"2026-06-12 02:04:23","# 考试粥助手\n\n一款基于 AI 的本地化学习与考试辅助工具。上传学习资料，AI 自动生成复习纲要、学习笔记和练习题，支持刷题、错题追踪和针对性训练。\n\n所有数据完全存储在本地浏览器中，不依赖任何云端服务。\n\n---\n\n## 功能一览\n\n- 上传学习资料（PDF、DOCX、TXT、图片等），自动提取文本或 OCR 识别\n- AI 智能生成复习纲要和学习笔记\n- 自动生成练习题（选择题、填空题、判断题、简答题）\n- 刷题器模式：导入已有题目文件或试卷图片，AI 自动识别题目\n- 错题追踪与针对性训练\n- 按课程隔离管理所有学习数据\n\n---\n\n## 在你的电脑上运行本项目\n\n下面的教程面向**完全零基础**的用户，请按顺序操作。根据你的操作系统选择对应的方法。\n\n### 第一步：安装 Git\n\nGit 是一个代码管理工具，用来把项目从 GitHub 下载到你的电脑上。\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Windows\u003C\u002Fb>（点击展开）\u003C\u002Fsummary>\n\n1. 打开浏览器，访问 https:\u002F\u002Fgit-scm.com\u002Fdownloads\n2. 点击 **Windows** 版本下载（会自动下载一个 `.exe` 安装文件）\n3. 双击安装文件，**一路点 Next**，所有选项保持默认即可\n4. 安装完成后点击 **Finish**\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>macOS\u003C\u002Fb>（点击展开）\u003C\u002Fsummary>\n\n1. 打开终端（在\"启动台\" → \"其他\" → \"终端\"，或按 `Cmd + 空格` 搜索\"终端\"）\n2. 安装 [Homebrew](https:\u002F\u002Fbrew.sh\u002F)（若已安装可跳过）：\n\n   ```\n   \u002Fbin\u002Fbash -c \"$(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FHomebrew\u002Finstall\u002FHEAD\u002Finstall.sh)\"\n   ```\n\n3. 通过 Homebrew 安装 Git：\n\n   ```\n   brew install git\n   ```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Linux（以 Ubuntu 为例）\u003C\u002Fb>（点击展开）\u003C\u002Fsummary>\n\n1. 打开终端（`Ctrl + Alt + T`）\n2. 更新软件包列表并安装 Git：\n\n   ```\n   sudo apt update\n   sudo apt install git -y\n   ```\n\n   其他发行版（如 Fedora 使用 `sudo dnf install git`，Arch Linux 使用 `sudo pacman -S git`）。\n\n\u003C\u002Fdetails>\n\n**验证安装：** 在终端中输入：\n\n```\ngit --version\n```\n\n看到类似 `git version 2.xx.x` 的输出就说明安装成功。\n\n> Windows 用户如果提示\"不是内部或外部命令\"，请重启电脑后重试。\n\n### 第二步：安装 Node.js\n\nNode.js 是运行本项目所必需的 JavaScript 运行时。\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Windows\u003C\u002Fb>（点击展开）\u003C\u002Fsummary>\n\n1. 打开浏览器，访问 https:\u002F\u002Fnodejs.org\u002Fzh-cn\n2. 点击 **LTS（长期支持版）** 下载按钮\n3. 双击下载好的 `.msi` 安装文件\n4. 一路点 **Next**，保持默认设置\n5. 如果看到 \"Automatically install the necessary tools\" 选项，**勾选它**\n6. 点击 **Install**，等待安装完成，点击 **Finish**\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>macOS\u003C\u002Fb>（点击展开）\u003C\u002Fsummary>\n\n**方法一（推荐）：使用 Homebrew**\n\n```\nbrew install node\n```\n\n**方法二：从官网下载**\n\n1. 打开浏览器，访问 https:\u002F\u002Fnodejs.org\u002Fzh-cn\n2. 点击 **LTS（长期支持版）** 下载按钮\n3. 双击下载好的 `.pkg` 安装文件，按提示完成安装\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Linux（以 Ubuntu 为例）\u003C\u002Fb>（点击展开）\u003C\u002Fsummary>\n\n```\nsudo apt update\nsudo apt install nodejs npm -y\n```\n\n> 注意：系统自带的 Node.js 版本可能较旧，如需最新版本，建议使用 [nvm](https:\u002F\u002Fgithub.com\u002Fnvm-sh\u002Fnvm) 安装：\n> ```\n> curl -o- https:\u002F\u002Fraw.githubusercontent.com\u002Fnvm-sh\u002Fnvm\u002Fv0.40.1\u002Finstall.sh | bash\n> # 重启终端后\n> nvm install --lts\n> ```\n\n\u003C\u002Fdetails>\n\n**验证安装：** 打开终端输入：\n\n```\nnode --version\n```\n\n看到类似 `v20.11.0` 的版本号即成功。再输入：\n\n```\nnpm --version\n```\n\n看到类似 `10.2.4` 的版本号即成功。\n\n> Windows 用户如果提示\"不是内部或外部命令\"，请重启电脑后重试。\n\n### 第三步：下载项目代码\n\n1. 打开**终端**（见下方说明），进入你希望存放项目的目录（如桌面）：\n\n   - **Windows 11：** 在桌面文件夹中 **右键** → **\"在终端中打开\"**\n   - **Windows 旧版：** 按 `Win + R`，输入 `cmd`，回车，然后输入 `cd %USERPROFILE%\\Desktop`\n   - **macOS：** 打开\"终端\"（`Cmd + 空格` 搜索\"终端\"），输入 `cd ~\u002FDesktop`\n   - **Linux：** `Ctrl + Alt + T` 打开终端，输入 `cd ~\u002FDesktop`\n\n2. 克隆项目到本地：\n\n   ```\n   git clone https:\u002F\u002Fgithub.com\u002Fzjuhechao\u002Fexam-porridge-assistant.git\n   ```\n\n3. 进入项目文件夹：\n\n   ```\n   cd exam-porridge-assistant\n   ```\n\n### 第四步：安装项目依赖\n\n在终端中输入：\n\n```\nnpm install\n```\n\n**等待说明：**\n- 首次安装需要下载约 200MB 的依赖包，耗时 2-5 分钟\n- 屏幕上会不断滚动下载进度，这是正常的\n- 出现黄色的 `WARN` 警告是正常的，不影响使用\n- 看到 `added xxx packages` 就表示安装完成\n\n**如果安装很慢或失败：** 切换到国内镜像源后重试：\n\n```\nnpm config set registry https:\u002F\u002Fregistry.npmmirror.com\nnpm install\n```\n\n### 第五步：启动项目\n\n```\nnpm run dev\n```\n\n等待几秒钟，当终端显示类似以下内容时，说明启动成功：\n\n```\nwebpack compiled successfully\n```\n\n> **重要：** 启动后这个终端窗口不要关闭！关闭终端 = 关闭应用。\n\n### 第六步：打开应用\n\n打开浏览器（推荐 Chrome 或 Edge），在地址栏输入：\n\n```\nhttp:\u002F\u002Flocalhost:3015\n```\n\n按回车，你应该能看到考试粥助手的首页。\n\n---\n\n## 配置 AI 功能\n\n应用的核心功能（生成题目、纲要、笔记、OCR 识别）需要 AI API 支持。首次使用请按以下步骤配置。\n\n### 获取 API Key\n\n你需要从 AI 服务商获取一个 API Key。推荐选择（任选其一）：\n\n| 服务商 | 注册地址 | 费用 | 说明 |\n|--------|----------|------|------|\n| DeepSeek | https:\u002F\u002Fplatform.deepseek.com | 按量付费，价格低 | 国内直连，无需翻墙 |\n| 通义千问 | https:\u002F\u002Fdashscope.console.aliyun.com | 有免费额度 | 阿里云旗下 |\n| OpenAI | https:\u002F\u002Fplatform.openai.com | 按量付费 | 需要海外网络 |\n\n**以 DeepSeek 为例：**\n\n1. 访问 https:\u002F\u002Fplatform.deepseek.com ，注册并登录\n2. 进入控制台，点击左侧 **\"API Keys\"**\n3. 点击 **\"创建 API Key\"**，复制生成的密钥（以 `sk-` 开头）\n4. 在 **\"充值\"** 页面充入少量余额（如 10 元）\n\n> 请妥善保管 API Key，不要分享给他人。\n\n### 在应用中配置\n\n1. 打开应用后，点击导航栏 **\"设置\"**\n2. 在 \"API 配置\" 区域点击 **\"添加 API 配置\"**\n3. 填写信息：\n\n| 字段 | DeepSeek 示例 |\n|------|--------------|\n| 配置名称 | `DeepSeek` |\n| API Key | `sk-xxxxxxxxxx`（你的密钥） |\n| API Base URL | `https:\u002F\u002Fapi.deepseek.com` |\n| 模型名称 | `deepseek-chat` |\n| Temperature | `0.7` |\n| Max Tokens | `2048` |\n\n4. 点击 **\"保存\"**\n5. 在 **\"功能 API 分配\"** 中为各功能选择对应的 API 配置\n6. 点击页面底部 **\"保存设置\"**\n\n> 如果需要图片 OCR 识别功能，OCR 配置需要使用支持视觉的多模态模型（如 `gpt-4o`），普通文本模型不支持图片识别。\n\n---\n\n## 日常使用\n\n以后每次使用只需要两步：\n\n```bash\n# 1. 打开终端，进入项目文件夹\ncd 你的项目路径\u002Fexam-porridge-assistant\n\n# 2. 启动服务\nnpm run dev\n```\n\n然后打开浏览器访问 `http:\u002F\u002Flocalhost:3015` 即可。\n\n不需要每次都运行 `npm install`，只有首次或更新项目后才需要。\n\n**停止服务：** 在终端按 `Ctrl + C`，输入 `Y` 确认（macOS\u002FLinux 按 `Ctrl + C` 即可）。\n\n---\n\n## 常见问题\n\n**Q: 终端提示 `git` \u002F `node` \u002F `npm` 找不到或不是内部命令？**\nA: Windows 用户安装后需要**重启电脑**；macOS\u002FLinux 用户请确认已打开**新的终端窗口**再试。\n\n**Q: `npm install` 卡住或报错？**\nA: 大概率是网络问题，运行以下命令切换到国内镜像源后重试：\n```\nnpm config set registry https:\u002F\u002Fregistry.npmmirror.com\nnpm install\n```\n\n**Q: `npm run dev` 启动失败？**\nA: 确认你已经在项目文件夹内运行命令。终端中的路径应该以 `exam-porridge-assistant` 结尾。\n\n**Q: 打开 `localhost:3015` 显示无法访问？**\nA: 确认终端中显示了 `compiled successfully`，且终端窗口没有关闭。\n\n**Q: AI 功能不工作？**\nA: 在设置页面检查 API Key、Base URL 和模型名称是否正确填写，并确保点击了\"保存设置\"。同时可按 `F12` 查看控制台是否有具体的错误信息（如网络错误、CORS 错误、API 鉴权失败等）。\n\n**Q: 数据存在哪里？会丢失吗？**\nA: 所有数据存储在浏览器本地（IndexedDB）。清除浏览器缓存\u002F数据会丢失所有记录，不同浏览器之间数据不共享。建议用导出功能定期备份重要内容。\n\n**Q: 想更新到最新版本？**\nA: 在项目文件夹中运行：\n\n**Q: 数据存在哪里？会丢失吗？**\nA: 所有数据存储在浏览器本地（IndexedDB）。清除浏览器缓存\u002F数据会丢失所有记录，不同浏览器之间数据不共享。建议用导出功能定期备份重要内容。\n\n**Q: 想更新到最新版本？**\nA: 在项目文件夹中运行：\n```\ngit pull\nnpm install\nnpm run dev\n```\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|----|------|\n| 前端框架 | React 18 + TypeScript |\n| 路由 | react-router-dom v6 |\n| 样式 | Tailwind CSS 3 |\n| 动画 | framer-motion |\n| 本地数据库 | Dexie (IndexedDB) |\n| PDF 解析 | pdfjs-dist |\n| DOCX 解析 | mammoth |\n| Markdown 渲染 | react-markdown + KaTeX |\n| 构建工具 | Webpack 5 |\n| AI 接口 | OpenAI 兼容格式（支持多模态） |\n\n---\n\n## 作者\n\n**阿刀**\n- 主页：https:\u002F\u002Fzjuhechao.github.io\u002F\n- GitHub：zjuhechao\n- 邮箱：3230101238@zju.edu.cn\n","考试粥助手是一款基于AI的本地化学习与考试辅助工具，通过调用API帮助用户生成复习纲要、学习笔记和练习题。其核心功能包括上传多种格式的学习资料并自动提取文本或进行OCR识别，智能生成复习材料及练习题目，并支持刷题、错题追踪等针对性训练方式。所有数据均存储于本地浏览器中，不依赖任何云端服务，确保了用户信息的安全性和隐私保护。该工具非常适合学生备考、教师准备课程资料以及个人自学时使用，尤其是在需要对特定教材或文档内容进行深入理解和记忆加强的情况下尤为适用。","2026-06-11 04:07:46","CREATED_QUERY"]