@rookiestar/eng-lang-tutor 1.0.1

package/templates/prompts/shared_enums.md

@@ -0,0 +1,252 @@
+# 共享枚举定义
+
+> 本文件定义所有 prompt 模板共用的枚举值。其他模板应引用此文件而非重复定义。
+
+---
+
+## Topics 主题
+
+| ID | 中文名 | Emoji | 描述 |
+|----|--------|-------|------|
+| movies | 电影 | 🎬 | 电影、美剧相关表达 |
+| news | 新闻 | 📰 | 新闻报道、时事评论 |
+| gaming | 游戏 | 🎮 | 电子游戏、在线游戏 |
+| sports | 体育 | ⚽ | 体育运动、比赛 |
+| workplace | 职场 | 💼 | 工作、商务、职业 |
+| social | 社交 | 🍻 | 朋友聚会、社交活动 |
+| daily_life | 生活 | 🏠 | 日常生活、购物、出行 |
+
+---
+
+## CEFR Levels 能力等级
+
+> 基于 [Council of Europe](https://www.coe.int/lang-cefr) 官方 "Can-Do Statements" 标准
+
+### A1 - Breakthrough 入门级
+
+| 属性 | 值 |
+|------|-----|
+| **类别** | Basic User 基础使用者 |
+| **中文名** | 入门级 |
+| **词汇量** | ~500-1000 词 |
+| **对应考试** | IELTS 1.0-2.0 / 小学英语 |
+
+**Can-Do Statements**:
+- 能理解和使用熟悉的日常表达和非常基础的短语
+- 能介绍自己和他人，能就个人情况（居住地、认识的人、拥有的物品）提问和回答
+- 在对方说话缓慢、清晰且愿意帮助时，能进行简单交流
+
+**Keypoint 特征**:
+- Expression: 单词、简单短语
+- Example: 1-2 句简单对话
+- Chinglish: 直译错误非常明显
+- Extended Learning: 无
+
+**Quiz 特征**:
+- Multiple Choice: 4选项，干扰项明显错误
+- Chinglish Fix: 明显语法错误
+- Fill Blank: 词库 3 选 1，直接匹配
+
+---
+
+### A2 - Waystage 初级
+
+| 属性 | 值 |
+|------|-----|
+| **类别** | Basic User 基础使用者 |
+| **中文名** | 初级 |
+| **词汇量** | ~1000-2000 词 |
+| **对应考试** | IELTS 2.5-3.5 / Cambridge KET / 初中英语 |
+
+**Can-Do Statements**:
+- 能理解与自身直接相关领域的句子和常用表达（个人/家庭信息、购物、地理、工作）
+- 能就熟悉的日常事务进行简单直接的信息交流
+- 能用简单的语言描述自己的背景、周围环境和直接需求
+
+**Keypoint 特征**:
+- Expression: 常用短语、基础表达
+- Example: 2-3 句日常对话
+- Chinglish: 直译错误较明显
+- Extended Learning: 简单 cultural_note
+
+**Quiz 特征**:
+- Multiple Choice: 4选项，干扰项较明显
+- Chinglish Fix: 常见直译错误
+- Fill Blank: 词库 3 选 1，上下文匹配
+
+---
+
+### B1 - Threshold 中级
+
+| 属性 | 值 |
+|------|-----|
+| **类别** | Independent User 独立使用者 |
+| **中文名** | 中级 |
+| **词汇量** | ~2000-3500 词 |
+| **对应考试** | IELTS 4.0-5.0 / Cambridge PET / 高考英语 / 大学四级 |
+
+**Can-Do Statements**:
+- 能理解工作、学习、休闲等熟悉话题的主要内容
+- 能应对旅行中大多数可能出现的情况
+- 能就熟悉或感兴趣的话题进行简单连贯的表达
+- 能描述经历、事件、梦想和希望，简要说明理由和计划
+
+**Keypoint 特征**:
+- Expression: 习语、短语动词
+- Example: 3-4 句工作场景对话
+- Chinglish: 细微表达差异
+- Extended Learning: 完整 extended_learning
+
+**Quiz 特征**:
+- Multiple Choice: 4选项，需理解语境
+- Chinglish Fix: 细微表达差异
+- Fill Blank: 词库 3 选 1，需理解用法
+
+---
+
+### B2 - Vantage 中高级
+
+| 属性 | 值 |
+|------|-----|
+| **类别** | Independent User 独立使用者 |
+| **中文名** | 中高级 |
+| **词汇量** | ~3500-5000 词 |
+| **对应考试** | IELTS 5.5-6.5 / Cambridge FCE / 大学六级 (CET-6) |
+
+**Can-Do Statements**:
+- 能理解具体或抽象话题的复杂文本主旨，包括专业领域的技术讨论
+- 能与母语者进行流利自然的互动，双方都不感到紧张
+- 能就广泛话题产出清晰详细的文章，解释观点的利弊
+
+**Keypoint 特征**:
+- Expression: 习语变体、抽象表达
+- Example: 4-5 句复杂场景对话
+- Chinglish: 语境使用错误
+- Extended Learning: 深入 cultural_note
+
+**Quiz 特征**:
+- Multiple Choice: 4选项，干扰项隐蔽
+- Chinglish Fix: 语境/语体错误
+- Fill Blank: 词库 4 选 1，需深入理解
+
+---
+
+### C1 - Effective Operational Proficiency 高级
+
+| 属性 | 值 |
+|------|-----|
+| **类别** | Proficient User 熟练使用者 |
+| **中文名** | 高级 |
+| **词汇量** | ~5000-8000 词 |
+| **对应考试** | IELTS 7.0-8.0 / Cambridge CAE / 英语专业八级 (TEM-8) |
+
+**Can-Do Statements**:
+- 能理解各种长篇、高难度文本，识别隐含含义
+- 能流利自然地表达，几乎不需要搜寻词汇
+- 能在社交、学术和职业场合灵活有效地使用语言
+- 能就复杂话题产出结构清晰、细节丰富的文章
+
+**Keypoint 特征**:
+- Expression: 高级习语、俚语
+- Example: 5+ 句专业场景对话
+- Chinglish: 文化隐含意义
+- Extended Learning: 俚语背景、多种使用场景
+
+**Quiz 特征**:
+- Multiple Choice: 4选项，含文化细微差别
+- Chinglish Fix: 隐含文化错误
+- Fill Blank: 词库 4 选 1，需文化理解
+
+---
+
+### C2 - Mastery 精通级
+
+| 属性 | 值 |
+|------|-----|
+| **类别** | Proficient User 熟练使用者 |
+| **中文名** | 精通级 |
+| **词汇量** | ~8000+ 词 |
+| **对应考试** | IELTS 8.5-9.0 / Cambridge CPE / 接近母语水平 |
+
+**Can-Do Statements**:
+- 能毫不费力地理解几乎所有听到或读到的内容
+- 能综合不同来源的信息，进行摘要和重述
+- 能自然、流利、精准地表达，区分意义的细微差别
+
+**Keypoint 特征**:
+- Expression: 地道表达、文化梗
+- Example: 复杂专业场景对话 + 多层含义
+- Chinglish: 深层文化差异
+- Extended Learning: 深入文化分析、历史背景
+
+**Quiz 特征**:
+- Multiple Choice: 4选项，极隐蔽的文化差异
+- Chinglish Fix: 深层文化错误
+- Dialogue Completion: 开放式，需综合理解
+
+---
+
+## Tutor Styles 导师风格
+
+| Style | 中文名 | 语气特点 | 示例 |
+|-------|--------|----------|------|
+| humorous | 幽默 | 轻松愉快，带梗和调侃 | "这个表达老外听了会笑死" |
+| rigorous | 严谨 | 专业分析，深入讲解 | "从语法角度分析..." |
+| casual | 随意 | 自然口语，朋友间聊天 | "平时老美就这么说" |
+| professional | 专业 | 正式商务，职场场景 | "在商务邮件中建议使用..." |
+
+---
+
+## Quiz Question Types 题型
+
+| Type | 中文名 | XP | 描述 | 每日数量 |
+|------|--------|-----|------|----------|
+| multiple_choice | 选择题 | 10 | 四选一，测试表达识别 | 1 (必选) |
+| chinglish_fix | Chinglish修正 | 15 | 识别并修正中式英语 | 1 (必选) |
+| fill_blank | 填空题 | 12 | 完成对话中的空白 | 0-1 (随机) |
+| dialogue_completion | 对话补全 | 15 | 选择合适的对话回应 | 0-1 (随机) |
+
+**每日 Quiz 结构:** 3 题，约 37 XP，答对 2 题即过关
+
+---
+
+## Category Types 类别
+
+| Category | 中文名 | 描述 |
+|----------|--------|------|
+| oral | 口语 | 日常口语表达，非正式场合 |
+| written | 书面 | 正式书面表达，商务邮件、报告 |
+
+---
+
+## Formality Levels 正式程度
+
+| Level | 中文名 | Emoji | 场景示例 |
+|-------|--------|-------|----------|
+| casual | 随意 | 👕 | 朋友聊天、社交媒体 |
+| neutral | 中性 | 👔 | 同事交流、日常沟通 |
+| formal | 正式 | 🤵 | 商务会议、正式邮件 |
+
+---
+
+## Badge Types 徽章
+
+| Badge ID | 中文名 | 触发条件 | 宝石奖励 |
+|----------|--------|----------|----------|
+| first_steps | 初次尝试 | 完成首次 Quiz | 10 |
+| week_warrior | 周末战士 | 7天连胜 | 25 |
+| month_master | 月度大师 | 30天连胜 | 100 |
+| perfect_10 | 完美十连 | 10次满分 Quiz | 50 |
+| vocab_hunter | 词汇猎人 | 学习100个表达 | 75 |
+| error_slayer | 错题克星 | 清除30个错题 | 30 |
+
+---
+
+## Activity Levels 活跃等级
+
+| Stage | 中文名 | Level | XP 范围 |
+|-------|--------|-------|---------|
+| Starter | 启程者 | 1-5 | 0-350 |
+| Traveler | 行路人 | 6-10 | 550-2000 |
+| Explorer | 探索者 | 11-15 | 2600-6000 |
+| Pioneer | 开拓者 | 16-20 | 7200-15000 |

package/templates/quiz_schema.json

@@ -0,0 +1,214 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "quiz_schema.json",
+  "title": "Quiz",
+  "description": "Daily quiz for knowledge point reinforcement with emoji-enhanced display",
+  "type": "object",
+  "required": ["quiz_date", "questions", "total_xp", "passing_score"],
+  "properties": {
+    "quiz_date": {
+      "type": "string",
+      "format": "date",
+      "description": "Date of this quiz (YYYY-MM-DD)"
+    },
+    "cefr_level": {
+      "type": "string",
+      "enum": ["A1", "A2", "B1", "B2", "C1", "C2"],
+      "description": "Target CEFR level for this quiz"
+    },
+    "keypoint_fingerprint": {
+      "type": "string",
+      "description": "Reference to the knowledge point this quiz is based on"
+    },
+    "questions": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["id", "type", "question", "correct_answer", "xp_value"],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Question number"
+          },
+          "type": {
+            "type": "string",
+            "enum": ["multiple_choice", "fill_blank", "dialogue_completion", "chinglish_fix"],
+            "description": "Question type"
+          },
+          "question": {
+            "type": "string",
+            "description": "The question text or prompt"
+          },
+          "chinglish_sentence": {
+            "type": "string",
+            "description": "Original Chinglish sentence for chinglish_fix type"
+          },
+          "context": {
+            "type": "string",
+            "description": "Optional context or scenario description"
+          },
+          "options": {
+            "type": "array",
+            "minItems": 4,
+            "maxItems": 4,
+            "items": {
+              "type": "string"
+            },
+            "description": "Options for multiple_choice type (A, B, C, D)"
+          },
+          "word_bank": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Optional word bank for fill_blank type"
+          },
+          "correct_answer": {
+            "type": "string",
+            "description": "The correct answer (option letter for multiple_choice, word for others)"
+          },
+          "explanation": {
+            "type": "string",
+            "description": "Explanation of why this answer is correct"
+          },
+          "xp_value": {
+            "type": "integer",
+            "minimum": 5,
+            "maximum": 20,
+            "description": "XP reward for correct answer"
+          },
+          "display": {
+            "type": "object",
+            "description": "Emoji-enhanced display format for this question",
+            "properties": {
+              "type_emoji": {
+                "type": "string",
+                "description": "Question type emoji (🔤, ✏️, 💬, 🔧)"
+              },
+              "type_name": {
+                "type": "string",
+                "description": "Question type name in bilingual format"
+              },
+              "question_formatted": {
+                "type": "string",
+                "description": "Question with emoji prefix"
+              },
+              "context_formatted": {
+                "type": "string",
+                "description": "Context with appropriate emoji"
+              },
+              "sentence_formatted": {
+                "type": "string",
+                "description": "Formatted sentence for display (e.g., with bold corrections)"
+              },
+              "dialogue_formatted": {
+                "type": "string",
+                "description": "Dialogue with speaker emojis"
+              },
+              "options_formatted": {
+                "type": "array",
+                "items": {"type": "string"},
+                "description": "Options with checkbox emoji"
+              },
+              "word_bank_formatted": {
+                "type": "string",
+                "description": "Word bank with box emoji"
+              },
+              "hint": {
+                "type": "string",
+                "description": "Hint with lightbulb emoji"
+              },
+              "email_formatted": {
+                "type": "string",
+                "description": "Email content with email emoji"
+              },
+              "correct_feedback": {
+                "type": "string",
+                "description": "Positive feedback with checkmark emoji"
+              },
+              "wrong_feedback": {
+                "type": "string",
+                "description": "Helpful hint with X emoji"
+              },
+              "answer_formatted": {
+                "type": "string",
+                "description": "Formatted correct answer"
+              },
+              "xp_display": {
+                "type": "string",
+                "description": "XP display with gem emoji"
+              },
+              "key_phrase": {
+                "type": "string",
+                "description": "Key phrase with bold formatting (e.g., '**touch base**')"
+              },
+              "correct_pattern": {
+                "type": "string",
+                "description": "Pattern explanation with bold (e.g., '**Agree + suggest time**')"
+              }
+            }
+          }
+        }
+      }
+    },
+    "total_xp": {
+      "type": "integer",
+      "minimum": 30,
+      "maximum": 50,
+      "description": "Sum of all question XP values"
+    },
+    "passing_score": {
+      "type": "integer",
+      "minimum": 50,
+      "maximum": 100,
+      "default": 70,
+      "description": "Percentage needed to pass"
+    },
+    "display": {
+      "type": "object",
+      "description": "Emoji-enhanced display format for the entire quiz",
+      "properties": {
+        "header": {
+          "type": "string",
+          "description": "Quiz title with emoji (e.g., '📝 今日测验 | Daily Quiz')"
+        },
+        "date": {
+          "type": "string",
+          "description": "Date with calendar emoji"
+        },
+        "topic": {
+          "type": "string",
+          "description": "Topic tag with label emoji"
+        },
+        "instructions": {
+          "type": "string",
+          "description": "Instructions with target emoji"
+        },
+        "progress_bar": {
+          "type": "string",
+          "description": "Visual progress indicator"
+        },
+        "key_phrase_summary": {
+          "type": "string",
+          "description": "Summary of key phrase with translation (e.g., '🔑 Key Phrase: **touch base** = 快速沟通')"
+        },
+        "xp_summary": {
+          "type": "string",
+          "description": "XP and passing score summary"
+        },
+        "footer": {
+          "type": "string",
+          "description": "Encouraging footer message"
+        }
+      }
+    },
+    "generated": {
+      "type": "boolean",
+      "default": false,
+      "description": "Whether LLM content has been fully generated. CRITICAL: Set to true after generation to prevent re-generation"
+    }
+  }
+}