StudyAssistance

一个简洁实用的学习助手应用，帮助用户管理题目、随机练习和学习。

功能特点

📝 题目管理

• 导入和添加题目
• 支持多种题型
• 支持题目标签分类

🎲 随机练习

• 按数量随机抽取题目
• 支持按标签筛选题目
• 题目答案验证

📱 友好界面

• 简洁直观的用户界面
• 响应式设计，适配各种屏幕尺寸
• 支持LaTeX公式渲染

技术栈

• 平台: Android
• 开发语言: Java
• 构建工具: Gradle
• 数据库: Room (SQLite)
• UI框架: Material Design Components
• 公式渲染: KaTeX

安装与运行

环境要求

• Android Studio Hedgehog (2023.1.1) 或更高版本
• JDK 8 或更高版本
• Android SDK 36 (API Level 36)
• Android Gradle Plugin 8.2.2

安装步骤

1. 克隆项目

   git clone <repository-url>
   cd StudyAssist

2. 打开项目 使用Android Studio打开项目目录

3. 构建项目

   ./gradlew assembleDebug

4. 运行应用

   • 连接Android设备或启动模拟器
   • 点击"Run"按钮或执行命令

   ./gradlew installDebug

使用说明

1. 主界面

• 随机题目: 进入随机练习模式
• 导入题目: 进入题目管理界面

2. 随机练习

1. 输入要练习的题目数量
2. （可选）输入标签筛选题目
3. 点击"开始练习"按钮
4. 在题目详情页面选择答案并提交

3. 题目管理

1. 点击"添加题目"按钮
2. 填写题目内容、选项、正确答案和标签
3. 点击"保存"按钮保存题目

项目结构

StudyAssist/
├── app/
│   ├── src/main/
│   │   ├── java/com/studyassist/
│   │   │   ├── MainActivity.java           # 主界面
│   │   │   ├── RandomQuestionActivity.java # 随机题目界面
│   │   │   ├── QuestionDetailActivity.java # 题目详情界面
│   │   │   ├── ImportQuestionActivity.java # 导入题目界面
│   │   │   ├── QuestionDialogFragment.java # 题目编辑对话框
│   │   │   └── database/                   # 数据库相关
│   │   ├── res/
│   │   │   ├── layout/                     # 布局文件
│   │   │   ├── mipmap-*/                   # 应用图标
│   │   │   └── values/                     # 资源文件
│   │   └── AndroidManifest.xml             # 应用配置
│   └── build.gradle                        # 模块配置
├── build.gradle                            # 项目配置
└── settings.gradle                         # 项目设置

LaTeX公式支持

应用支持使用LaTeX语法编写数学公式：

• 行内公式：$E = mc^2$
• 块级公式：$$\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}$$

贡献指南

欢迎对项目进行贡献！请遵循以下步骤：

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

联系方式

如有问题或建议，请通过以下方式联系：

• 作者: Iceky Prime
• 邮箱: icekyprime@sjtu.edu.cn

---

版本: 1.0 更新日期: 2025年12月