# trae-study

**Repository Path**: kimodi/trae-study

## Basic Information

- **Project Name**: trae-study
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学习英雄 - AI 问答引导式学习

一个基于微信小程序的 AI 问答学习应用，用户可以自主设置学习主题，由 AI 生成有趣的知识问答卡片，通过闯关答题的形式轻松愉快地掌握知识。

## 功能特点

- 🎯 **自定义主题**：用户可以自由输入想学习的任何主题
- 🤖 **AI 生成问答**：基于 OpenAI GPT 模型智能生成高质量问答
- 🏆 **闯关答题**：游戏化的答题体验，激发学习兴趣
- 📊 **成绩统计**：详细的答题结果分析和错题回顾
- 💾 **历史记录**：保存学习历史，方便回顾和复习
- 🎨 **精美界面**：现代化的 UI 设计，流畅的交互体验

## 项目结构

```
trae-study/
├── pages/                  # 小程序页面
│   ├── index/             # 首页
│   ├── topic/             # 主题选择页
│   ├── quiz/              # 答题页
│   └── result/            # 结果页
├── utils/                 # 工具函数
│   ├── api.js            # API 接口封装
│   └── storage.js        # 本地存储封装
├── server/                # 后端服务
│   ├── routes/           # 路由
│   ├── services/         # 业务逻辑
│   └── server.js         # 服务器入口
├── app.js                 # 小程序入口
├── app.json               # 小程序配置
├── app.wxss               # 全局样式
└── project.config.json    # 项目配置
```

## 快速开始

### 前置要求

- 微信开发者工具
- Node.js (v14 或更高版本)
- OpenAI API Key

### 后端服务设置

1. 进入 server 目录：
```bash
cd server
```

2. 安装依赖：
```bash
npm install
```

3. 配置环境变量：
```bash
cp .env.example .env
```

编辑 `.env` 文件，填入你的 OpenAI API Key：
```
PORT=3000
AI_API_KEY=your_openai_api_key_here
AI_API_URL=https://api.openai.com/v1/chat/completions
```

4. 启动服务：
```bash
npm start
```

### 小程序设置

1. 使用微信开发者工具打开项目根目录
2. 在 `pages/topic/topic.js` 中修改 API 地址：
```javascript
// 将 API_BASE_URL 改为你的服务器地址
const API_BASE_URL = 'http://your-server-domain.com/api'
```

3. 编译并运行小程序

## 使用说明

### 开始学习

1. 打开小程序，点击"开始学习"
2. 输入你想学习的主题（如：Python编程、历史知识等）
3. 选择难度级别（入门/进阶/挑战）
4. 设置题目数量（3-10题）
5. 点击"开始闯关"

### 答题流程

1. 阅读题目，选择你认为正确的答案
2. 系统会立即显示答案是否正确
3. 查看详细解析，了解知识点
4. 点击"下一题"继续答题

### 查看结果

1. 完成所有题目后查看总分和正确率
2. 根据表现获得不同的成就徽章
3. 回顾错题，巩固薄弱知识点
4. 选择"再来一次"或"选择新主题"继续学习

## API 接口

### 生成问答

**POST** `/api/generate-quiz`

请求参数：
```json
{
  "topic": "Python编程",
  "difficulty": "medium",
  "questionCount": 5
}
```

响应示例：
```json
{
  "success": true,
  "questions": [
    {
      "question": "Python 中用于定义函数的关键字是？",
      "options": [
        {"text": "function", "isCorrect": false},
        {"text": "def", "isCorrect": true},
        {"text": "func", "isCorrect": false},
        {"text": "define", "isCorrect": false}
      ],
      "explanation": "Python 使用 'def' 关键字来定义函数..."
    }
  ]
}
```

## 技术栈

### 前端
- 微信小程序原生框架
- WXML / WXSS / JavaScript

### 后端
- Node.js
- Express.js
- OpenAI API

## 开发计划

- [ ] 添加用户登录和个人中心
- [ ] 实现学习进度追踪
- [ ] 添加排行榜功能
- [ ] 支持更多题型（填空、判断等）
- [ ] 添加学习提醒功能
- [ ] 优化 AI 生成质量

## 注意事项

1. 需要配置有效的 OpenAI API Key
2. 确保后端服务正常运行
3. 小程序需要配置合法域名
4. 建议使用 HTTPS 部署后端服务

## 许可证

MIT License

## 联系方式

如有问题或建议，欢迎提 Issue。