# 口說評分系統規格 (Speaking Evaluation System)

## 概述
Drama Ling 應用中的口說評分系統，提供五維度的語音表達評估，適用於對話訓練、詞彙學習、發音練習等多個功能模組。

## 核心評分維度

### 五維度評分系統
- 🗣️ **發音評分 (Pronunciation)**: 音素準確度、尾音收口、鼻音共鳴
- ✅ **完整度評分 (Completeness)**: 句子完整性、遺漏詞彙檢測  
- 📈 **流暢度評分 (Fluency)**: 語速自然度、停頓合理性
- 🎶 **韻律評分 (Prosody)**: 語調變化、重音位置、節奏感
- 🎯 **準確度評分 (Accuracy)**: 整體表達精準度

### 分數標準
- **96~100**：完美
- **81~95**：優秀  
- **71~80**：尚可
- **0~70**：不合格

### 獎勵機制
- **96~100**：+3 鑽石 + 30 XP
- **81~95**：+2 鑽石 + 20 XP
- **71~80**：+1 鑽石 + 10 XP
- **0~70**：時光卷

## 評分顯示範例

```
📊 Speaking Score

【Sentence】91.9分：
Please make sure you have all the necessary documents before submitting your application.

🗣️ Pronunciation：91.9
📈 Fluency：97
🎶 Prosody：83.3
✅ Completeness：100
🎯 Accuracy：96

【單字需要加強❌】
application ⭐⭐：
🟡 n

【建議改善】
• 🔚 尾音收口明確（-m, -n, -l, -k, -t），避免吞音。
🎯 針對音素練習：n
🤧 鼻音（m/n/ŋ）：軟顎下放，確保鼻腔共鳴與口型到位。
```

## 技術實現

### 語音處理系統
- [ ] **語音轉文字**: 以語音輸入為主，文字輸入為輔的對話方式
- [ ] **中文檢測**: 當用戶講中文或輸入中文時，角色表示聽不懂
- [ ] **語音品質檢測**: 如果聽不到聲音，顯示「抱歉，好像沒有聲音，請重新錄製」
- [ ] **表達流暢度分析**: 使用Speakace等第三方平台分析精準度、流利度、韻律

### 核心技術需求
- [ ] **AI 服務選擇**: 確定主要 AI 模型供應商
- [ ] **評分算法**: 建立五維度評分的具體邏輯
- [ ] **即時反饋系統**: 目標響應時間 < 2秒
- [ ] **成就觸發機制**: 於遊戲結束時，自動檢測並發放對應獎勵
- [ ] **性能優化**: 確保響應時間穩定

### 品質控制
- [ ] **準確性測試**: 驗證評分結果的一致性
- [ ] **用戶體驗**: 確保獎勵系統運作順暢  
- [ ] **資料隱私**: 基本的用戶資料保護

## 應用場景

### 情境對話訓練
- 即時評分每句對話的口說表現
- 結算時提供詳細的改善建議

### 詞彙學習口說關卡
- 評估詞彙例句的發音準確度
- 消耗5鑽石進行口說評分訓練

### 發音練習功能
- 針對特定音素提供專項練習
- 追蹤發音改善進度

### AI訂正系統
- 表達不順的句子重錄和練習
- 透過重複練習提升表達流暢度

---

**最後更新**: 2025-09-11 - 獨立拆分口說評分系統規格  
**版本**: 1.0 - 初版：從AI算法規格中獨立模組化  
**維護者**: Drama Ling 開發團隊