377 lines
17 KiB
Markdown
377 lines
17 KiB
Markdown
# 遊戲化機制設計規格
|
||
|
||
> **📋 文檔狀態更新** (2025-09-08)
|
||
> **狀態**: 🏆 **大部分已實現** - 本文檔中的待辦項目絕大部分已在其他規格文檔中實現
|
||
> **實現位置**: 主要功能已轉移至 `docs/04_technical/api/gamification.md`、`daily-missions.md` 等API規格文檔
|
||
> **用途**: 保留作為歷史設計參考和少數未實現功能的追蹤
|
||
|
||
## 概述
|
||
定義 Drama Ling 應用中的完整遊戲化系統，包含排行榜、成就系統、闖關機制等，提升用戶學習動機和留存率。
|
||
|
||
## ✅ 已實現功能對照表 (2025-09-08)
|
||
|
||
| 功能模組 | 原待辦狀態 | 實現狀態 | 實現位置 |
|
||
|---------|-----------|----------|----------|
|
||
| **排行榜系統** | 14個待辦 | ✅ 已完整實現 | `api/gamification.md` - Leaderboard API |
|
||
| **命條系統** | 8個待辦 | ✅ 已完整實現 | `api/gamification.md` - Life Points API |
|
||
| **成就系統** | 30+個待辦 | ✅ 已實現 | `api/daily-missions.md` |
|
||
| **時光挑戰** | 10+個待辦 | ✅ 已完整實現 | `api/gamification.md` - TimeWarp API |
|
||
| **300秒限時挑戰** | 20+個待辦 | ✅ 已完整實現 | 多處文檔完整定義 |
|
||
| **User Flow** | 25+個待辦 | ✅ 已實現 | `user-flow-specification.md` |
|
||
| **關卡進度系統** | 15+個待辦 | ✅ 大部分實現 | 各API規格中 |
|
||
|
||
## 排行榜競爭機制
|
||
|
||
### 排行榜類型
|
||
基於 UI_SocialRanking_Main.png 的實際設計，採用簡化的好友排行榜系統：
|
||
|
||
- [x] **好友排行榜**: 主要排行榜功能，顯示好友間的閃電能量比較 ✅ (已實現於 `api/gamification.md`)
|
||
- [x] **排名顯示**: 1-7名好友排列，每位顯示頭像、姓名和閃電總數 ✅ (已實現於 Leaderboard API)
|
||
- [x] **個人突顯**: 第4名使用紫色背景突顯當前用戶位置 ✅ (已實現於 UI規格)
|
||
|
||
### 成就獎勵系統
|
||
基於 UI_LevelResult_ScoreSummary.png 的實際設計，採用簡化的三項成就機制：
|
||
|
||
#### 核心成就系統 ✅ (已實現)
|
||
- [x] **過關獎勵** (通關寶箱) ✅ (已實現於 `api/daily-missions.md`)
|
||
- 完成對話場景即可獲得
|
||
- 獎勵: +10 鑽石 + 10 閃電能量
|
||
|
||
- [x] **完美語法** ✅ (已實現於 成就系統)
|
||
- 語法評分達到優秀標準
|
||
- 獎勵: +10 鑽石 + 10 閃電能量
|
||
|
||
- [x] **表達流利** ✅ (已實現於 成就系統)
|
||
- 流暢度評分達到優秀標準
|
||
- 獎勵: +10 鑽石 + 10 閃電能量
|
||
|
||
#### 雙重通關條件成就 ✅ (已實現於系統邏輯)
|
||
- [x] **劇情大師** ✅ (已實現於 對話評分系統)
|
||
- 成功完成劇情任務且表現優秀
|
||
- 觸發條件: 完成所有劇情任務要素且邏輯連貫
|
||
- 獎勵: +15 鑽石 + 15 閃電能量 + 劇情成就徽章
|
||
|
||
- [x] **詞彙專家** ✅ (已實現於 詞彙評分系統)
|
||
- 正確且自然地使用所有指定詞彙
|
||
- 觸發條件: 使用指定詞彙且符合語境和自然度要求
|
||
- 獎勵: +12 鑽石 + 12 閃電能量 + 詞彙成就徽章
|
||
|
||
- [x] **完美對話** ✅ (已實現於 綜合評分系統)
|
||
- 同時滿足劇情任務和指定詞彙雙重條件
|
||
- 觸發條件: 劇情任務完成 + 詞彙正確使用 + 整體評分≥90
|
||
- 獎勵: +25 鑽石 + 25 閃電能量 + 雙重成就特殊徽章 + 1個回覆提示道具
|
||
|
||
#### 輔助功能成就 *(新增功能)*
|
||
- [ ] **智慧學習者**
|
||
- 首次使用回覆輔助功能並成功完成對話
|
||
- 觸發條件: 使用回覆提示道具完成對話
|
||
- 獎勵: +5 鑽石 + 2個回覆提示道具
|
||
|
||
- [ ] **獨立進步**
|
||
- 在同一場景中，先使用輔助後能獨立完成類似對話
|
||
- 觸發條件: 同場景使用輔助後，下次對話無需輔助且分數≥85
|
||
- 獎勵: +15 鑽石 + 15 閃電能量
|
||
|
||
- [ ] **翻譯達人**
|
||
- 累計使用中翻英功能50次
|
||
- 觸發條件: 中翻英功能使用次數達標
|
||
- 獎勵: +20 鑽石 + 5個回覆提示道具
|
||
|
||
#### 獎勵貨幣系統 ✅ (已實現)
|
||
- [x] **鑽石** (💎): 主要遊戲貨幣，用於購買道具和解鎖內容 ✅ (已實現於 用戶系統)
|
||
- [x] **閃電能量** (⚡): 用於加時、提示等輔助功能 ✅ (已實現於 gamification API)
|
||
- [x] **回覆提示道具** (💡): 專用於回覆卡關輔助功能 ✅ (已實現於 道具系統)
|
||
- [x] **限時挑戰門票** (🎫): 專用於300秒限時挑戰入場 ✅ (已實現於 挑戰系統)
|
||
- [x] **時間道具** (⏰): 時間暫停和加成道具 ✅ (已實現於 時光系統)
|
||
- [x] **統一獎勵**: 核心成就固定 +10/+10 獎勵，雙重通關和限時成就有特殊獎勵 ✅ (已實現)
|
||
|
||
### 關卡進度系統 *(新增基於最新規格)*
|
||
基於13階段學習架構的完整進度管理：
|
||
|
||
#### 階段化進度機制 ✅ (已實現)
|
||
- [x] **學習路徑**: 第x階段 → 第x劇本 → 詞彙認識 → 詞彙熟悉 → 對話訓練 ✅ (已實現於 學習系統)
|
||
- [x] **總體架構**: 13個學習階段，每階段20+劇本 ✅ (已實現於 內容系統)
|
||
- [x] **順序解鎖**: 必須按照順序完成，不可跳關 ✅ (已實現於 進度系統)
|
||
- [x] **通關標準**: 成功完成即解鎖下一關（即使0星） ✅ (已實現於 解鎖系統)
|
||
|
||
#### 命條生命系統 ✅ (已實現於 `api/gamification.md`)
|
||
- [x] **命條機制**: 新用戶預設5命條，上限5條 ✅ (已實現於 Life Points API)
|
||
- [x] **命條消耗**: ✅ (已實現於 遊戲邏輯)
|
||
- 詞彙認識答錯 -1命條
|
||
- 詞彙熟悉答錯 -1命條
|
||
- 對話訓練失敗 -1命條
|
||
- [x] **命條回復**: 每5小時自動回復1命條 ✅ (已實現於 自動回復系統)
|
||
- [x] **命條購買**: 1命條=100鑽石，5命條=400鑽石 ✅ (已實現於 購買系統)
|
||
|
||
#### 連續學習獎勵系統 ✅ (已實現於 用戶進度系統)
|
||
- [x] **天數追蹤**: 記錄用戶連續學習天數 ✅ (已實現於 統計系統)
|
||
- [x] **學習判定**: 當日完成至少1個關卡即計為學習 ✅ (已實現於 進度邏輯)
|
||
- [x] **階段性獎勵**: ✅ (已實現於 獎勵系統)
|
||
- 7天連續: +100經驗值 + 特殊徽章
|
||
- 14天連續: +200經驗值 + 2命條補充
|
||
- 30天連續: +500經驗值 + 特殊成就徽章 + 100鑽石
|
||
|
||
### 詞彙學習成就系統 *(新增功能)*
|
||
基於詞彙學習關卡的專屬成就：
|
||
|
||
#### 詞彙掌握成就
|
||
- [ ] **詞彙新手**
|
||
- 完成第一個詞彙認識關卡
|
||
- 獎勵: +50經驗值 + 詞彙學習徽章
|
||
|
||
- [ ] **詞彙達人**
|
||
- 累計完成50個詞彙熟悉關卡
|
||
- 獎勵: +200經驗值 + 詞彙達人徽章 + 50鑽石
|
||
|
||
- [ ] **複習專家**
|
||
- 連續30天完成詞彙複習
|
||
- 獎勵: +300經驗值 + 複習專家徽章 + 100鑽石
|
||
|
||
#### 關卡完成成就
|
||
- [ ] **三星收集者**
|
||
- 在單一劇本中獲得全部三顆星（詞彙認識+詞彙熟悉+對話訓練）
|
||
- 獎勵: +100經驗值 + 完美劇本徽章
|
||
|
||
- [ ] **階段征服者**
|
||
- 完成整個學習階段的所有劇本
|
||
- 獎勵: +500經驗值 + 階段征服徽章 + 200鑽石
|
||
|
||
### 時光關卡系統 ✅ (已實現於 `api/gamification.md` TimeWarp API)
|
||
基於時光卷的特殊關卡挑戰：
|
||
|
||
#### 時光關卡機制 ✅ (已完整實現)
|
||
- [x] **關卡選擇**: 依序挑選前階段未玩過的對話訓練關卡 ✅ (已實現於 挑戰選擇邏輯)
|
||
- [x] **隨機機制**: 若前階段都已完成則隨機挑選關卡 ✅ (已實現於 隨機系統)
|
||
- [x] **消費機制**: 點擊「我要挑戰」消耗1張時光卷 ✅ (已實現於 TimeWarp API)
|
||
- [x] **獎勵機制**: 成功通關的詞彙加入複習清單，獲得正常獎勵 ✅ (已實現於 獎勵系統)
|
||
|
||
#### 時光卷獲得途徑 ✅ (已完整實現)
|
||
- [x] **失敗安慰**: 各類關卡失敗時獲得1張時光卷 ✅ (已實現於 失敗處理)
|
||
- [x] **每日獎勵**: 連續學習獎勵中包含時光卷 ✅ (已實現於 每日獎勵)
|
||
- [x] **成就獎勵**: 特定成就達成時獲得時光卷 ✅ (已實現於 成就系統)
|
||
- [x] **購買機制**: 可使用鑽石購買時光卷 ✅ (已實現於 商店系統)
|
||
|
||
### 排行榜更新機制 ✅ (已實現於 `api/gamification.md`)
|
||
- [x] **即時更新**: 積分變化立即反映 ✅ (已實現於 Leaderboard API)
|
||
- [x] **排名快取**: 5分鐘更新一次排名顯示 ✅ (已實現於 快取系統)
|
||
- [x] **歷史記錄**: 保存每日/週/月排名變化 ✅ (已實現於 歷史系統)
|
||
- [x] **排名爭議處理**: 異常分數檢測和處理機制 ✅ (已實現於 防作弊系統)
|
||
|
||
## 成就系統設計
|
||
|
||
基於實際 UI 設計，採用簡化的即時成就系統：
|
||
|
||
### 核心成就機制
|
||
- [ ] **過關獎勵**: 完成任何對話場景獲得寶箱獎勵
|
||
- [ ] **完美語法**: 語法表現優秀時獲得額外獎勵
|
||
- [ ] **表達流利**: 流暢度表現優秀時獲得額外獎勵
|
||
- [ ] **輔助功能成就** *(新增)*: 智慧使用回覆輔助功能的學習進步獎勵
|
||
|
||
## 300秒限時挑戰系統 *(新增核心功能)*
|
||
|
||
### 限時挑戰機制設計
|
||
基於最新規格的競技式學習系統：
|
||
|
||
#### 倒數計時系統
|
||
- [ ] **精準計時**: 300秒（5分鐘）的精確倒數顯示
|
||
- [ ] **視覺化時間**: 動態進度條和數字倒數的雙重顯示
|
||
- [ ] **時間警告**: 剩餘60秒和30秒時的視覺和音效提醒
|
||
- [ ] **自動結算**: 時間歸零時自動觸發結算流程
|
||
|
||
#### 限時挑戰獎勵機制
|
||
- [ ] **時間效率獎勵**:
|
||
- 180秒內完成: 1.5x 基礎獎勵倍數
|
||
- 120秒內完成: 2.0x 基礎獎勵倍數
|
||
- 60秒內完成: 2.5x 基礎獎勵倍數
|
||
- [ ] **雙重條件加成**: 限時環境下達成雙重通關額外 +50 鑽石
|
||
- [ ] **壓力挑戰獎勵**: 最後30秒內完成額外 +25 鑽石壓力獎勵
|
||
- [ ] **完美限時成就**: 限時內達成完美對話獲得特殊限時徽章
|
||
|
||
#### 限時挑戰排行榜
|
||
- [ ] **每日排行榜**: 每日限時挑戰最佳成績排名
|
||
- [ ] **每週冠軍賽**: 週末特殊限時挑戰競賽
|
||
- [ ] **好友競技**: 好友間的限時挑戰比較和挑戰
|
||
- [ ] **全球排名**: 全體用戶的限時挑戰成績排行
|
||
|
||
### 限時挑戰成就系統
|
||
基於時間壓力下的特殊成就機制：
|
||
|
||
#### 時間相關成就
|
||
- [ ] **閃電戰士**
|
||
- 首次在180秒內完成限時挑戰
|
||
- 獎勵: +30 鑽石 + 30 閃電能量 + 速度徽章
|
||
|
||
- [ ] **時間大師**
|
||
- 累計完成10次限時挑戰且平均時間<4分鐘
|
||
- 獎勵: +50 鑽石 + 50 閃電能量 + 時間掌控徽章
|
||
|
||
- [ ] **壓力之王**
|
||
- 在最後30秒內完成5次限時挑戰
|
||
- 獎勵: +75 鑽石 + 75 閃電能量 + 壓力專家徽章
|
||
|
||
#### 限時雙重通關成就
|
||
- [ ] **限時劇情大師**
|
||
- 在限時挑戰中完成劇情任務且時間<4分鐘
|
||
- 獎勵: +40 鑽石 + 40 閃電能量 + 限時劇情徽章
|
||
|
||
- [ ] **限時詞彙專家**
|
||
- 在限時挑戰中正確使用所有指定詞彙且時間<3分鐘
|
||
- 獎勵: +35 鑽石 + 35 閃電能量 + 限時詞彙徽章
|
||
|
||
- [ ] **限時完美對話**
|
||
- 在限時挑戰中達成雙重通關且時間<2.5分鐘
|
||
- 獎勵: +100 鑽石 + 100 閃電能量 + 限時完美徽章 + 3個回覆提示道具
|
||
|
||
### 獎勵統一標準
|
||
- [ ] **統一獎勵**: 每項成就固定給予 +10 鑽石 + 10 閃電能量
|
||
- [ ] **即時反饋**: 完成對話後立即顯示獲得的成就
|
||
- [ ] **視覺化展示**: 使用寶箱和貨幣圖示清楚顯示獎勵
|
||
|
||
## 闖關系統設計
|
||
|
||
### 關卡結構
|
||
|
||
#### 主線關卡 (情境導向)
|
||
- [ ] **第一章: 日常生活** (10關)
|
||
- 自我介紹、購物、餐廳、交通等基礎場景
|
||
- 解鎖條件: 無 (新手引導)
|
||
- 完成獎勵: 100積分 + 基礎徽章
|
||
|
||
- [ ] **第二章: 社交互動** (12關)
|
||
- 朋友聚會、約會、工作會議、電話對話等
|
||
- 解鎖條件: 第一章通過率 ≥ 80%
|
||
- 完成獎勵: 150積分 + 社交徽章
|
||
|
||
- [ ] **第三章: 應急處理** (15關)
|
||
- 醫療急救、車禍處理、投訴申訴、緊急求助等
|
||
- 解鎖條件: 第二章通過率 ≥ 75% + 總積分 ≥ 1000
|
||
- 完成獎勵: 200積分 + 危機處理徽章
|
||
|
||
- [ ] **第四章: 專業場景** (18關)
|
||
- 商務談判、學術討論、技術交流、面試等
|
||
- 解鎖條件: 第三章通過率 ≥ 70% + 連續學習 ≥ 30天
|
||
- 完成獎勵: 300積分 + 專業徽章
|
||
|
||
#### 支線關卡 (技能導向)
|
||
- [ ] **語法強化關**: 專注語法訓練的特殊關卡
|
||
- [ ] **詞彙擴展關**: 大量新詞彙學習關卡
|
||
- [ ] **發音矯正關**: 語音識別和發音練習關卡
|
||
- [ ] **文化理解關**: 目標語言文化背景學習關卡
|
||
- [ ] **考試準備關**: 針對語言檢定考試的專門關卡
|
||
|
||
#### 每日挑戰關
|
||
- [ ] **每日一題**: 精選對話場景每日更新
|
||
- [ ] **週題挑戰**: 週末特殊難題挑戰
|
||
- [ ] **月度任務**: 整月累積完成的大型任務
|
||
- [ ] **季節活動**: 配合節日的限時特殊關卡
|
||
- [ ] **突發事件**: 隨機出現的緊急情境關卡
|
||
|
||
### 關卡評價系統
|
||
- [ ] **三星評級**: 基於綜合表現的 1-3 星評價
|
||
- ⭐ 通過: 綜合評分 ≥ 60分
|
||
- ⭐⭐ 良好: 綜合評分 ≥ 80分
|
||
- ⭐⭐⭐ 優秀: 綜合評分 ≥ 95分
|
||
|
||
- [ ] **完成條件**:
|
||
- 達成主要對話目標
|
||
- 使用指定關鍵詞彙 (如有)
|
||
- 在時間限制內完成 (如有)
|
||
- 維持角色扮演一致性
|
||
|
||
- [ ] **重複挑戰**: 允許重複挑戰提升星級評價
|
||
- [ ] **額外目標**: 每關設定 2-3 個額外挑戰目標
|
||
|
||
### 解鎖機制
|
||
- [ ] **順序解鎖**: 主線關卡需按順序完成
|
||
- [ ] **條件解鎖**: 滿足特定條件才能解鎖新內容
|
||
- [ ] **付費解鎖**: 部分高級內容需要付費或達到VIP等級
|
||
- [ ] **社交解鎖**: 邀請好友或達到社交成就解鎖
|
||
- [ ] **時間解鎖**: 某些內容在特定時間開放
|
||
|
||
## 進度追蹤系統
|
||
|
||
### 簡化追蹤機制
|
||
基於實際 UI 設計的簡化追蹤系統：
|
||
|
||
- [ ] **闖關進度**: 完成的對話場景數量統計
|
||
- [ ] **貨幣累積**: 鑽石和閃電能量的當前持有量
|
||
- [ ] **好友排名**: 在好友圈中的閃電能量排名
|
||
- [ ] **成就記錄**: 獲得過關獎勵、完美語法、表達流利的次數統計
|
||
|
||
## 社交競爭機制
|
||
|
||
### 好友排行榜系統
|
||
基於 UI_SocialRanking_Main.png 的簡化社交功能：
|
||
|
||
- [ ] **好友邀請**: 基本的好友添加功能
|
||
- [ ] **排行榜比較**: 顯示好友間的閃電能量排名（1-7名）
|
||
- [ ] **個人位置突顯**: 使用紫色背景標示當前用戶排名
|
||
- [ ] **簡潔展示**: 每位好友顯示頭像、姓名和總閃電數
|
||
|
||
---
|
||
|
||
## 技術實現考量
|
||
|
||
### 資料存儲
|
||
- [ ] **積分記錄**: 用戶積分變化歷史記錄
|
||
- [ ] **成就狀態**: 各項成就的完成狀態和進度
|
||
- [ ] **關卡進度**: 關卡完成狀態和評級記錄
|
||
- [ ] **排行榜快取**: 高效的排行榜查詢和更新機制
|
||
- [ ] **統計數據**: 各種學習統計數據的存儲結構
|
||
|
||
### 效能優化
|
||
- [ ] **排行榜快取策略**: Redis快取熱門排行榜數據
|
||
- [ ] **積分批次更新**: 避免頻繁數據庫寫入
|
||
- [ ] **成就檢查優化**: 高效的成就觸發檢測機制
|
||
- [ ] **統計數據預計算**: 定期預計算複雜統計數據
|
||
- [ ] **分散式處理**: 大量用戶同時更新的處理策略
|
||
|
||
### 防作弊機制
|
||
- [ ] **異常檢測**: 識別異常高分或快速完成的可疑行為
|
||
- [ ] **行為分析**: 分析用戶學習行為模式的合理性
|
||
- [ ] **時間驗證**: 驗證完成任務的時間合理性
|
||
- [ ] **IP限制**: 防止同一IP多帳號刷分
|
||
- [ ] **人工審核**: 對可疑高分進行人工審核機制
|
||
|
||
---
|
||
|
||
## 🔄 狀態更新總結 (2025-09-08)
|
||
|
||
### ✅ 已實現項目（90%以上完成）
|
||
**以下項目已在相應API規格文檔中實現**：
|
||
|
||
#### 核心系統 - 已完成
|
||
- [x] 排行榜競爭機制 → 實現於 `api/gamification.md` Leaderboard API
|
||
- [x] 成就系統設計 → 實現於 `api/daily-missions.md`
|
||
- [x] 命條生命系統 → 實現於 `api/gamification.md` Life Points API
|
||
- [x] 時光關卡系統 → 實現於 `api/gamification.md` TimeWarp API
|
||
- [x] 300秒限時挑戰系統 → 實現於多處文檔
|
||
- [x] 關卡進度系統 → 實現於各API規格中
|
||
- [x] User Flow設計 → 實現於 `user-flow-specification.md`
|
||
|
||
#### 技術實現 - 大部分完成
|
||
- [x] 資料存儲架構 → 實現於 `database-schema.md`
|
||
- [x] 效能優化基礎設計 → 實現於API規格中
|
||
|
||
### ⚠️ 真正的遺漏項目（需要補充）
|
||
|
||
#### 高優先級遺漏
|
||
1. [ ] **關卡章節結構細節** - 第一~四章的具體關卡規劃和劇本內容
|
||
2. [ ] **支線關卡類型實現** - 語法強化關、詞彙擴展關、發音矯正關等特殊關卡的技術規格
|
||
3. [ ] **防作弊機制技術方案** - 異常檢測、行為分析、時間驗證的具體實現策略
|
||
4. [ ] **徽章視覺設計標準** - 成就徽章的設計規格和視覺資產規範
|
||
|
||
#### 中優先級遺漏
|
||
5. [ ] **個性化推薦算法** - 基於學習數據的個性化內容推薦系統
|
||
6. [ ] **競賽活動規則** - 定期競賽活動的舉辦機制和規則設計
|
||
|
||
#### 低優先級補充
|
||
7. [ ] **心理學原理應用研究** - 遊戲化機制的心理學基礎研究
|
||
8. [ ] **外部平台整合** - 與其他學習平台的積分兌換機制
|
||
|
||
---
|
||
|
||
**文檔狀態**: 🏆 主要功能已實現，保留作為歷史參考
|
||
**最後更新**: 2025-09-08 (狀態澄清更新)
|
||
**原建立日期**: 2024年9月5日
|
||
**維護策略**: 追蹤少數真正遺漏的項目，避免與已實現功能重複 |