# 快速開始指南

## 5 分鐘快速上手

### 第一步：登入系統
1. 打開 http://pake-exam.steps.tw
2. 點擊「登入」
3. 使用測試帳號：
   - 郵箱：demo@example.com
   - 密碼：password123

### 第二步：建立考試
1. 登入後，點擊「建立考試」
2. 輸入考試名稱，例如：「2024 年高考模擬試題」
3. 輸入考試描述（可選）
4. 點擊「建立考試」

### 第三步：添加題目

#### 方式 A：快速新增單個題目
1. 進入剛建立的考試
2. 點擊「新增題目」
3. 輸入題目：「什麼是光合作用？」
4. 選擇題目類型：「簡答題」
5. 勾選「使用 AI 自動生成答案和解釋」
6. 點擊「新增題目」
7. AI 會自動生成答案！

#### 方式 B：批量導入題目（快速大量新增）

##### 使用 CSV 文件
1. 建立 `questions.csv` 文件，內容如下：
```
question_text,question_type
求解方程 2x + 5 = 15,short_answer
請列舉 3 個可再生能源,short_answer
什麼是溫室效應？,essay
```

2. 回到系統，點擊「導入題目」
3. 選擇剛建立的考試
4. 上傳 `questions.csv`
5. 勾選「自動使用 AI 生成答案和解釋」
6. 點擊「上傳導入」
7. 等待 AI 生成所有答案！✨

### 第四步：讓學生練習

#### 以教師身份
1. 進入考試詳情
2. 複製考試連結或告知學生考試名稱

#### 以學生身份
1. 點擊「練習考試」
2. 選擇考試
3. 逐題作答
4. 點擊「提交答題」
5. 查看成績和 AI 詳解！

## 模板下載

### CSV 模板 (推薦)
下載：[questions_template.csv](./templates/questions_template.csv)

內容：
```csv
question_text,question_type
高中物理第一章選擇題,multiple_choice
求導數,short_answer
論述萬有引力,essay
```

### JSON 模板
```json
{
  "questions": [
    {
      "text": "高中物理第一章選擇題",
      "type": "multiple_choice"
    },
    {
      "text": "求導數",
      "type": "short_answer"
    },
    {
      "text": "論述萬有引力",
      "type": "essay"
    }
  ]
}
```

## 常用快捷操作

| 功能 | 快捷路徑 |
|------|--------|
| 建立考試 | 首頁 → 建立考試 |
| 導入題目 | 首頁 → 導入題目 |
| 練習考試 | 首頁 → 練習考試 |
| 登出 | 導航欄 → 登出 |

## 技巧和最佳實踐

### 📝 編寫好的題目
- 題目描述要清晰明確
- 提供必要的背景信息
- 避免歧義性表述

### 🤖 AI 生成最佳結果
- 題目越詳細，AI 答案越準確
- 可以手動編輯 AI 生成的答案
- 對於複雜題型，多次生成可能有不同答案

### 👥 管理練習
- 定期更新題目以保持新鮮
- 根據學生反饋調整題目難度
- 使用 AI 詳解幫助學生理解

## 需要幫助？

### 常見問題

**問：怎樣支援不同難度的題目？**
答：在建立考試時的描述中標註難度級別，學生可根據自身水平選擇

**問：AI 生成的答案不夠準確怎麼辦？**
答：進入題目編輯，手動修改 AI 生成的答案和解釋

**問：能刪除已建立的考試嗎？**
答：進入考試詳情，點擊「刪除」按鈕（只有創建者可刪除）

**問：學生作答後能改分嗎？**
答：目前系統自動評分，可根據 AI 和教師判斷進行手動調整

## 下一步

- 探索更多題目類型
- 設置更多考試
- 邀請更多學生使用
- 收集反饋並改進

祝您使用愉快！ 🎉