dramaling-app/docs/02_design/content-management-specs.md

14 KiB
Raw Blame History

內容管理規格文件

概述

基於 05_views 實際設計,定義簡化的學習內容管理架構。

挑戰關卡系統

關卡結構設計

基於 UI_ChallengeLevel_Map.png 和相關介面,採用簡化的關卡進度系統:

劇本內容架構 (更新基於最新規格)

{
  "script_id": "S001",
  "script_name": "午餐吃什麼",
  "scene_description": {
    "english": "Two friends sit on a park bench under a shady tree...",
    "chinese": "兩位朋友坐在樹蔭下的公園長椅上..."
  },
  "plot_outline": "兩位朋友在公園長椅上討論午餐選擇...",
  "opening_dialogue": [
    {
      "character": "Alex",
      "english": "Jamie, I can't decide! What do you feel like eating?",
      "chinese": "Jamie我不知道該選什麼你想吃什麼",
      "user_role": true
    },
    {
      "character": "Jamie", 
      "english": "I'm not sure either. Maybe something light, like salad?",
      "chinese": "我也不確定,也許吃點清淡的,比如沙拉?",
      "user_role": false
    }
  ],
  "plot_tasks": [
    {
      "task_description": "說服 Jamie 吃自己喜歡的食物,並舉出理由",
      "example_english": "My friend recommended this place too, said it's the best [food name] they've ever had.",
      "example_chinese": "我朋友也超推薦這家,說是他吃過最好吃的 [食物名稱]。"
    }
  ],
  "required_vocabulary": [
    {
      "word": "Decide",
      "chinese": "決定",
      "variations": ["decide", "decided", "deciding", "decision"],
      "quiz_options": ["deceive", "besides", "decided", "disease"]
    },
    {
      "word": "Light", 
      "chinese": "清淡的",
      "variations": ["light", "lighter", "lightly"],
      "quiz_options": ["right", "fight", "sight", "slight"]
    }
  ],
  "time_limit": 300,
  "completion_criteria": {
    "tasks_required": true,
    "vocabulary_required": true,
    "scoring_thresholds": {
      "semantic_score": 60,
      "grammar_errors": 0,
      "fluency_score": 60
    }
  }
}

關卡設計原則

  • 簡潔目標: 每關卡有明確的對話練習目標
  • 鑽石消費: 統一關卡消費機制 (300鑽石/關)
  • 解鎖系統: 循序解鎖的關卡進度
  • 完成獎勵: 統一的三項成就獎勵系統

場景內容分類

簡化場景系統

基於實際 UI 設計的簡化分類:

  • 日常對話場景: 基本生活情境對話練習
  • 挑戰關卡: 進階的目標導向對話任務
  • 語法訂正: 專注語法改進的練習內容
  • 流暢度訓練: 專注表達流暢度的練習內容

詞彙學習內容管理系統 (新增功能模組)

詞彙關卡內容架構

基於最新規格的詞彙學習關卡設計:

詞彙內容數據結構

{
  "script_vocabulary": {
    "script_id": "S001",
    "script_name": "買菜小冒險",
    "vocabulary_set": [
      {
        "type": "word",
        "english": "market",
        "chinese": "市場",
        "pronunciation": "/ˈmɑːrkɪt/",
        "example_sentence": "I go to the market every Saturday.",
        "example_translation": "我每個星期六都去市場。",
        "image_url": "images/market.jpg",
        "quiz_options": ["market", "garden", "school", "hospital"]
      },
      {
        "type": "phrase", 
        "english": "ask for a discount",
        "chinese": "詢問折扣",
        "example_sentence": "Can I ask for a discount on this?",
        "example_translation": "我可以要求這個打折嗎?",
        "context_usage": "用於購物砍價的情境"
      },
      {
        "type": "slang",
        "english": "a steal",
        "chinese": "超便宜的好東西",
        "example_sentence": "This shirt is a steal at $10!",
        "example_translation": "這件襯衫10美元真是超值",
        "cultural_note": "美式英語中表示價格很划算"
      }
    ]
  }
}

詞彙認識關卡管理

  • 詞彙展示內容:
    • 詞彙本身、中文意思、音標
    • 例句和中文翻譯
    • 相關示意圖或插圖
    • 詞彙類型標識(單字/片語/俚語)
  • 選擇題設計:
    • 4選1的單選題形式
    • 根據示意圖選出正確英文詞彙
    • 選項設計避免過於明顯的錯誤答案
    • 錯誤答案在最後重新測試

詞彙熟悉關卡管理

  • 例句重組內容:
    • 提供示意圖作為提示
    • 將完整例句拆分為單字選取區
    • 用戶需重新組合出正確句子
    • 支援拖拽或點擊操作
  • 詞彙配對內容:
    • 左側顯示示意圖
    • 右側顯示多個詞彙選項
    • 支援一對一配對操作
    • 全部配對正確才算完成

間隔複習內容管理系統

基於遺忘曲線的智慧複習機制:

複習數據結構

{
  "vocabulary_review": {
    "user_id": "U001",
    "vocabulary_id": "V001", 
    "first_learned_date": "2024-03-04",
    "review_count": 2,
    "next_review_date": "2024-03-10",
    "last_review_result": "correct",
    "retention_strength": 0.85,
    "review_history": [
      {
        "review_date": "2024-03-04",
        "result": "correct", 
        "response_time": 3.2
      },
      {
        "review_date": "2024-03-06",
        "result": "correct",
        "response_time": 2.8
      }
    ]
  }
}

複習排程算法

  • 間隔計算公式: 下次複習時間 = 當前日期 + (2^複習次數)天
  • 複習觸發條件:
    • 詞彙認識、詞彙熟悉、對話訓練通關後自動加入
    • 避免重複加入相同詞彙
    • 當日即為第一次複習時間
  • 延遲複習處理:
    • 過期未複習的詞彙持續標記為待複習
    • 延遲複習時以實際複習日期重新計算間隔
    • 例如應3/10複習但3/11才複習下次時間為3/11+2³=3/19

複習進度管理

  • 中途離開保存:
    • 記錄當前複習位置和已完成題數
    • 保存答題結果和錯誤記錄
    • 給予已完成部分的經驗值
  • 複習完成機制:
    • 所有待複習詞彙都答對才算完成
    • 答錯題目複製到最後重新測試
    • 完成後給予完整經驗值獎勵
    • 更新複習次數和下次複習時間

情境對話內容管理系統 (新增功能)

劇情任務管理系統

基於最新規格的結構化任務內容管理:

任務定義架構

  • 任務層級管理:
    • 主要任務目標 (如:預約餐廳、購買商品)
    • 子任務要素 (如:時間確認、數量說明、付款方式)
    • 隱藏任務線索 (如:禮貌用語、文化適應性)
  • 任務完成檢測:
    • 關鍵對話元素的識別規則
    • 任務邏輯性和完整性的驗證機制
    • 情節一致性的品質控制標準
  • 任務進度追蹤:
    • 即時完成狀態的更新機制
    • 部分完成vs完整達成的差異化記錄
    • 任務完成品質的評分系統

任務內容品質標準

  • 情境真實性: 確保任務反映真實生活場景
  • 難度適配性: 根據用戶語言水平調整任務複雜度
  • 文化適應性: 考量目標語言的文化背景和表達習慣
  • 學習目標性: 每項任務都對應明確的語言學習目標

指定詞彙庫管理系統

基於最新規格的智慧詞彙檢測和管理:

詞彙庫架構設計

{
  "vocab_entry": {
    "primary_word": "reservation",
    "word_forms": {
      "noun": ["reservation", "reservations"],
      "verb": ["reserve", "reserved", "reserving"],
      "adjective": ["reserved"]
    },
    "synonyms": ["booking", "appointment", "arrangement"],
    "context_patterns": [
      "make a reservation",
      "book a table", 
      "reserve a spot"
    ],
    "difficulty_level": "A2",
    "usage_frequency": "high",
    "cultural_notes": "常用於餐廳和飯店場景"
  }
}

詞彙檢測機制

  • 形式變化識別: 支援詞彙的各種語法形式變化
  • 同義詞檢測: 識別語意相近的替代詞彙
  • 語境相關性: 確保詞彙使用符合對話情境
  • 自然度評估: 評估詞彙使用的自然性和適切性

詞彙學習進度管理

  • 掌握度追蹤: 記錄用戶對各詞彙的掌握程度
  • 使用品質分析: 分析詞彙使用的準確性和自然度
  • 重複學習機制: 基於遺忘曲線的詞彙複習排程
  • 情境應用記錄: 追蹤詞彙在不同情境下的使用經驗

300秒限時挑戰內容管理 (新增功能)

基於最新規格的限時挑戰內容設計:

限時挑戰內容架構

  • 快節奏對話設計: 適合時間壓力下的對話節奏和內容複雜度
  • 即時反饋機制: 時間緊迫情況下的簡潔有效反饋系統
  • 壓力測試內容: 測試用戶在時間壓力下的語言表現能力
  • 效率優化提示: 針對限時環境的對話策略和技巧指導

限時內容管理標準

  • 時間分配設計: 確保300秒內可以完成有意義的對話練習
  • 難度平衡控制: 避免時間壓力下的過度困難或過度簡單
  • 成就感設計: 在限制時間內創造明確的成就感和進步感
  • 競技性內容: 適合排行榜競爭的對話挑戰設計

回覆卡關輔助內容管理

引導內容結構設計

基於手寫規格的三層輔助架構:

意圖分析內容庫

  • 情境意圖模板: 預建不同情境下的常見對話意圖
  • 情感識別標籤: 友好、正式、急迫、詢問等情感色彩分類
  • 文化背景考量: 針對中文使用者的文化理解差異調整
  • 更新機制: 基於用戶互動數據優化意圖識別準確度

回應思維引導庫

  • 思考路徑模板: 不同情境下的標準思考流程
  • 多元回應策略: 積極、中性、詢問、說明等多種回應風格
  • 難度分級: A1-C2不同等級的思維複雜度調整
  • 情境適配: 根據對話場景提供相應的思維引導

回覆範例內容庫

  • 分級範例庫: 按語言水平提供適當複雜度的回覆範例
  • 風格多樣性: 正式、非正式、友善、專業等不同風格選項
  • 情境相關性: 確保範例符合具體對話情境和角色設定
  • 學習漸進性: 從模仿到自主表達的學習路徑設計

中翻英輔助功能管理

基於Google翻譯整合的智慧翻譯系統

翻譯品質優化

  • 情境調整: 根據對話場景調整翻譯的正式度和用詞選擇
  • 語言等級適配: 將翻譯結果調整至使用者的目標語言水平
  • 文化適應: 考量中英文化差異,提供更自然的表達方式
  • 學習引導: 在翻譯結果中標註重要語法點和詞彙選擇

翻譯內容管理

  • 常用片語庫: 預建中英對照的常用對話片語
  • 情境詞彙庫: 不同場景下的專業詞彙中英對照
  • 語法模式庫: 常見中文思維模式的英文表達建議
  • 錯誤修正庫: 針對中文使用者常見的英文表達錯誤進行預防性修正

對話內容管理

簡化內容標準

基於實際應用需求的精簡內容管理:

基本內容要求

  • 對話目標: 每個場景有明確的溝通目標
  • 評分整合: 內容配合三維度評分系統 (語法/語意/流暢度)
  • 獎勵觸發: 內容設計配合成就系統觸發機制
  • 成本設定: 統一的鑽石消費標準

品質控制機制

  • 基本準確性: 確保對話內容語言正確性
  • 適用性驗證: 驗證內容符合學習目標
  • 測試驗證: 確保評分系統正常運作

技術實現要點

內容管理需求

基於實際應用的簡化管理需求:

核心功能 (更新)

  • 關卡內容: 對話場景的基本內容管理
  • 劇情任務管理: 結構化任務目標和完成檢測的內容架構 (新增)
  • 指定詞彙庫: 智慧詞彙檢測和形式變化識別的內容管理 (新增)
  • 限時挑戰內容: 300秒限時對話的專門內容設計和管理 (新增)
  • 評分配置: 配合 AI 評分系統的內容標註
  • 回覆輔助內容: 意圖分析、思維引導、範例回覆的內容庫管理
  • 翻譯內容庫: 中翻英輔助的詞彙和片語管理
  • 雙重獎勵設定: 配合劇情任務和詞彙使用的複合獎勵機制 (新增)
  • 消費設定: 關卡鑽石消費、輔助道具和限時挑戰門票的統一管理

基本品質控制

  • 內容準確性: 確保對話內容的語言正確性
  • 系統整合: 確保與評分和獎勵系統的正確整合
  • 用戶測試: 基本的用戶體驗驗證

待完成任務

高優先級 (更新)

  1. 建立劇情任務管理系統的結構化內容架構 (新增)
  2. 建立指定詞彙庫的智慧檢測和形式變化管理 (新增)
  3. 設計300秒限時挑戰的專門內容管理系統 (新增)
  4. 建立雙重通關條件的複合獎勵內容配置 (新增)
  5. 建立基本的對話場景內容
  6. 建立回覆輔助的三層內容庫(意圖分析、思維引導、範例回覆)
  7. 配置關卡鑽石消費系統和回覆提示道具管理
  8. 整合Google翻譯API和中翻英輔助內容庫
  9. 整合 AI 評分與成就獎勵機制
  10. 設定關卡解鎖條件

中優先級

  1. 建立回覆輔助內容的品質測試流程
  2. 優化翻譯結果的情境適應性
  3. 建立內容品質測試流程
  4. 驗證系統整合的正確性

新增功能優先級

  1. 設計輔助內容的動態更新機制
  2. 建立用戶使用輔助功能的學習效果追蹤
  3. 優化多語言文化差異的內容適配
  4. 建立輔助功能使用數據的分析機制

最後更新: 2024年9月5日
負責人: 待分配
審查週期: 每兩週檢討一次