📖 旺豆新语 · 使用手册
旺豆新语是为 KET / PET 备考学生打造的英语学习平台，
集绘本阅读、单词闯关、语法闯关、剑桥真题、高考冲刺、班级管理于一体。
① 注册 / 登录
首次使用请点击首页右上角「登录」按钮，填写手机号、设置密码完成注册。注册时可选择班级（30+ 班级，覆盖启蒙/新芽/青竹/秋桐/金葵/星耀 6 大系列）、上传头像，方便老师统一管理。
② 选择学习内容
点击首页左侧导航栏中的课程分类，选择对应书籍或单元即可进入学习：
- RAZ 绘本 — 分级阅读（Level A/B/C），点击级别进入该级别书籍列表，每本含朗读 + 单词闯关 + Quiz + Phonics + 雷达图
- Power Up — 剑桥 PU1/PU2/PU3/PU4 系列，按单元选择；每单元含 6 个学习标签（闪卡 / 测试 / 近义词 / 听写 / 语法 / 挑战）
- Prepare — 剑桥 Prepare 4/5 单词闯关
- 分级时文阅读 — 按 AR 级别阅读英语新闻短文，支持 PDF 导出
- 剑桥真题词汇 — KET / PET 官方真题词汇闯关
- 高考冲刺 — 高考必修 1-2 单词 / 冲刺 List 1
📖 什么是 RAZ？
RAZ（Reading A–Z）是美国主流分级阅读体系，按难度分为 A–Z 共 27 个级别。本平台已上线 Level A（8 本）、Level B（7 本）、Level C（1 本），每本均配有英音朗读音频、单词闯关、读后测试、自然拼读（E 级）和能力雷达图。
▶️ 如何使用
- 在首页 RAZ 区域点击一个级别卡片（如「Level A」）
- 进入级别页面后，点击任意绘本书名进入学习页
- 绘本页面包含：AR/Lexile 标签、句子卡片（图文+播放按钮）、单词闯关、Quiz（读后测试）、Phonics（自然拼读，E 级）、能力雷达图
- 听完所有句子音频后，点击「Star Quiz」按钮完成读后测试
- 测试完成后成绩自动保存到云端，可在「学习报告」中查看
📱 微信 / 企业微信适配
RAZ 绘本页面专为微信和企业微信内置浏览器优化，所有播放按钮使用 CSS 三角形（非 Unicode ▶），音频使用预加载 DOM <audio> 标签，确保 iOS 微信中可正常播放。
📊 能力雷达图五维
每本 RAZ 绘本顶部（含 E 级）和学习报告页都有一个五边形雷达图，展示该学员在该绘本上 5 个能力维度的历史累计表现。计算口径统一：每维 = 该类别历史会话累计正确题数 ÷ 累计总题数。
- 听力理解（蓝 #378ADD） — 来自 listen 类题型（listen-img / listen-sentence）的累计正确率
- 阅读理解（绿 #639922） — 来自 read-choice 类题型的累计正确率
- 句子结构（橙 #BA7517） — 来自 sort（句子排序）+ match（句块匹配）的累计正确率
- 词汇掌握（紫 #7F77DD） — 来自 word_challenge（单词闯关 wc_audio / wc_en2cn / wc_cn2en）的累计正确率
- 自然拼读（红 #E24B4A） — 来自 phonics 模块的累计正确率
📝 功能介绍
Power Up 是剑桥大学出版社的官方教材，本平台将其转化为互动单词闯关模式。每个单元包含 6 个学习标签页：
- 闪卡 — 翻转卡片记忆单词，正面英文+英音发音，背面中文释义
- 测试 — 10 道英中 / 中英选择题，检测单词掌握
- 近义词 — 选择题（PU1=10题，PU2=20题，PU3+=30题）
- 听写 — 听英文音频拼写单词（10 题，30 秒倒计时）
- 语法 — 见下方「语法闯关」专章
- 挑战 — 综合测试，完成后获得成长积分
🎯 错词本
测试或听写中答错的单词自动加入错词本。错词在闪卡中以 金色 → 橙色 → 红色 → 深红色 渐变标记，提示需要重点复习。登录后错词本自动同步到云端。
📊 已上线单元
🌌 玩法介绍
语法闯关采用深色太空主题，配有 SVG 计时圆环、粒子特效与进度反馈。每道语法题限时 30 秒 作答，完成后立即判题并保存到云端，答错题自动入「错题本」。
入口：Power Up / Prepare 单元页面 → 「语法」标签页
📚 题库随机抽题（PU3 U4 / U5 / U6）
PU3 现已上线的 U4 / U5 / U6 三个单元采用题库随机抽题机制，告别死题：
- 每次开始闯关，从题库随机抽 8 题 = 6 道单项选择 + 2 道句子排序
- 每单元题库规模：19 单选 + 5 排序题，覆盖本单元全部核心语法点（U4 副词/比较级/过去式，U5 介词搭配/be made of/提建议，U6 should/shouldn't/be good at）
- 答完一题立即判题；答错时该题同步入云端错题本，下次进入单元时会重点复习
- 配合「错题挑战」功能，可在错题本内反复练习历史错题
📋 其他单元题型（PU1/PU2/PU4 等）
未升级随机抽题的单元，采用固定题目集：
- PU1/PU2 语法闯关：5 单选 + 1 排序 + 2 填空（FILL 拖词）
- Prepare 语法闯关：与 PU1/PU2 类似
- 所有题型错题均自动入「错题本」
📝 与 Power Up 的区别
Prepare 是剑桥 KET/PET 备考教材，单词闯关模式与 Power Up 类似，但测试题量更大：
- 每次 30 题 — 15 道英文选中文 + 15 道中文选英文
- 近义词 20 题、听写 10 题，与 Power Up 一致
📊 已上线单元
🌍 功能介绍
按 AR（Accelerated Reader）难度分级的英语新闻短文，帮助孩子用英语了解世界。每篇文章包含：
- 段落朗读 — 英音音频，逐句播放
- 核心词汇 — 新词带中文释义和发音
- 单词闯关 — 10 题限时词汇练习
- 阅读 Quiz — 3–5 题阅读理解选择题
- PDF 导出 — 支持打印纸质版阅读
📊 已上线文章
📝 KET / PET 真题词汇闯关
精选剑桥 KET、PET 官方真题词汇，按「剑 X · Test X」组织，帮助学生集中突破考试核心词：
- 普通测试 — 30 题（英选中 + 中选英），检验词汇掌握
- 近义词 — 20 题，自动播放录音，训练听力与词义联想
- 听写 — 15 题，根据音频拼写单词
- 错词自动收录 — 答错单词进入错词本，可反复复习
📊 已上线真题
🎯 高考冲刺词库
面向中国高考英语考生的词库闯关，包含：
- 高考必修 1 — Unit 1-2 / Unit 3-4 / Unit 5（词组 + 单词闯关）
- 高考必修 2 — Unit 1-2（词组 + 单词闯关）
- 高考冲刺 List 1 — 高频考纲词冲刺闯关
每套词库含：闪卡 / 测试 / 近义词 / 听写 / 错词本等标准模块，与 Power Up / Prepare 体验一致。
👥 32 个班级，6 大系列
旺豆新语支持多班级管理，方便老师批量跟踪学情：
学生注册时选择班级后，老师可在管理员看板按班级筛选查看所有学员。
📊 管理员看板（admin.html）
教务老师专属数据看板，从首页顶部「管理员登录」入口进入（默认账号 admin/0000）：
- 学情看板 — 全部学员的总时长 / 累计正确率 / 最近学习等核心 KPI
- 学员管理 — 点击学员名字查看个人详情，环形进度 + 步骤指示的加载动画，等待体验丝滑
- 智能看板 — 按班级 / 课程切换，雷达图叠加（每位学员的听/读/句/词/拼 五维独立展示）
- 学习记录 — 全部学员最近学习动态，错题错词一目了然
- 数据维度：每位学员的雷达图五维含义与学生端一致，但聚合单位为「该学员 + 该课程/绘本」的全部历史记录
📈 学生端报告（report.html）
登录后点击任意页面顶部右上角用户名 → 「报告」即可进入。报告包含：
- 累计时长 — 各绘本 / 各单元的学习时长（按 bookTime 聚合）
- Quiz 正确率 — 各绘本 / 各单元的读后测试累计正确率
- 最近学习 — 最近 7 天的学习动态折线图（含本周 vs 上周对比）
- 错词本 / 错题本 — 历史错词错题，针对性复习
- 能力雷达图 — 听 / 读 / 句 / 词 / 拼 五维总览（同绘本页面雷达图同源）
🧮 数据维度与计算口径
所有成绩 / 雷达图 / 正确率统计遵循统一口径，避免歧义：
- 正确率公式：累计正确题数 ÷ 累计总题数。例：做 2 次 Quiz，每次 5 题，答对 3 + 4 题，则正确率 = 7 ÷ 10 = 70%
- 未答题不算错：未作答的题目不计入分母（管理员智能看板口径），确保未做练习的学员不会被误判
- 雷达图五维（听 / 读 / 句 / 词 / 拼）数据源：
RAZCloud.getSessions(bookId)拉取历史会话，按 QTYPE_MAP 将每题归类到对应维度，维度内累加正确率 - 错题入题：Quiz / 单词闯关 / 语法闯关答错立即保存到云端（
RAZCloud.saveQuizWrongs/RAZCloud.addWrongWord），真删除不保留僵尸记录 - 时长统计：每条会话的
timeSpent（秒）累加，按 book 维度分桶 - 未登录保护：未登录状态下记录保存到本地 localStorage，登录后自动合并到云端
🏅 10 级成长体系
每次完成单元测试或绘本 Quiz 后，根据正确率获得成长积分：
- 全对（+10分） — 完美通关！
- 正确率 ≥ 90%（+8分） — 优秀！
- 正确率 ≥ 80%（+4分） — 不错，继续加油！
- 同一单元重复挑战，只补差额分（鼓励首次全对）
🎖️ 等级一览
积分同时保存在本地（localStorage）和云端（raz-cloud.js），登录后自动合并，多设备无缝同步。
音频在微信里不能播放？
本平台已针对微信/iOS 优化，使用预加载 DOM Audio 标签。如仍无法播放，请检查手机是否设置为静音模式，或尝试在企业微信中打开。
学习记录会丢失吗？
登录后所有记录实时同步到云端（CloudBase）。未登录时记录保存在本地浏览器，清缓存会丢失。建议每次使用都先登录。
为什么有些单元显示「陆续上线中」？
Power Up 和 Prepare 教材单元正在逐步制作中，优先上线学生当前正在学习的内容。如有急需的单元，可联系老师安排上线顺序。
雷达图里某个维度显示 0% 或很低的数值？
表示该学员在该类题型上历史累计正确率低。可能原因：（1）刚开始学习该绘本，记录太少波动大；（2）该类题型是薄弱点。建议去「错题本」针对性复习，或在管理员端查看班级整体雷达图分布，对比同伴表现。
管理员账号怎么开通？
默认账号 admin/0000。首次登录后请尽快修改密码，并在「管理员登录」页面记录账号权限。如忘记密码，请联系技术支持重置。
💬 需要帮助？
如有使用问题或功能建议，请联系旺豆新语教务老师。
旺豆新语 · 新知教育 | British English (en-GB)
