ShuaForge

项目概述

ShuaForge 是一个用 Rust + egui 开发的轻量桌面刷题助手。目标是像背单词一样刷题：导入题库后逐题作答，答对就从本轮题库移除，答错就重新加入队列，并显示本地或 AI 错题解析。项目采用 MIT 协议。

主要功能

• 导入 JSON 或 CSV 题库，并保存为本地 SQLite 题库卡片
• 随机出题、顺序或乱序刷题切换
• 答对：题目从本轮队列移除；答错：题目重新加入队尾
• 错题解析：优先显示题库自带解析，可选调用 AI 接口
• AI 配置：支持自定义 endpoint、model、API key 与超时时间
• 轻量桌面 UI：使用 eframe/egui，不嵌浏览器、不走 Electron
• 题库卡片管理与题组文件夹，可把多个题库拖入题组组合练习
• 导出题库或题组为可再次导入的 ZIP 或 JSON
• 答题历史与题型控件：单选题用 Radio、多选题用 Checkbox、文本题用 TextBox
• 内置只读题库导出油猴脚本，可从已完成答题结果页提取题目

适用人群

• 需要大量刷题与错题复习的备考学生
• 希望从学习通等平台导入题库的用户
• 喜欢背单词式循环记忆法的用户

快速上手

1. 安装 Rust 工具链
2. 在项目根目录运行 cargo run
3. 点击导入题库，选择 examples/problems.sample.json 或 examples/problems.sample.csv
4. 在题库主页点击单个题库卡片，或点击全部题库开始练习
5. 可选：载入 examples/ai-config.sample.json 配置 AI 错题解析

核心优势

• 纯 Rust，跨平台友好
• UI 与业务逻辑在同一 Rust 工程，迭代快
• 相比 WebView 或 Electron 路线更轻
• 先做桌面端 MVP，核心逻辑便于后续复用到 CLI、移动端或 Web

系统要求

• 操作系统：Windows、Linux、macOS
• 支持架构：Windows x64、Linux x64 与 arm64、macOS x64 与 arm64
• 额外依赖：Rust 工具链；开发油猴脚本需 Node.js

注意事项

• 目前处于 MVP 阶段
• AI 错题解析需自行配置接口并消耗相应额度，未启用时显示题库自带解析或本地提示
• 题库导入后保存在本机 SQLite 数据库，重复导入同一路径会合并更新
• 油猴脚本只提取已完成页面的题目数据，不自动答题、不提交表单、不修改页面数据