Skip to content

AI 英语学习助手实战(三):一套底座撑起 9 款背记游戏 ​

光背单词,孩子坚持不下来。这一篇讲 9 款游戏怎么共用一套底座,以及怎么让「玩游戏」真正推进单词本里的背记进度,而不是玩了就玩了。

一、共用内核 ​

games/ 下有 9 款游戏(单词挑战、限时挑战、连击奖励、AI 对战、单词速射、记忆配对、单词猎人、词汇拼图、单词大冒险),但选词、音效、朗读、结算这四件事只写了一遍,都收在 game-kit.js 里。

这是被维护成本逼出来的:前几款游戏各写各的,改一处音效逻辑要改好几个文件。抽出内核后,新增一款游戏只需要写"这个游戏怎么玩",通用逻辑不用再碰。

二、三机制闭环:玩游戏真的能推进背记 ​

很多"学习游戏"的问题是玩了就玩了,跟学习数据没关系。这里的做法是让游戏直接写回单词本,靠三个机制:

  1. 自适应出题:掌握程度低、历史答错多的词优先出现
  2. 错词回炉:本局答错的词,本局内一定再考一次
  3. 连对升星:同一个词连续答对 3 次,单词本自动升 1 星(上限 3 星)

第 3 条的实现里有一处细节值得看 —— 升星后连对计数必须清零,否则"连对 3 次"会退化成"连对满 3 次之后每答对一次都升星":

python
if correct and streak >= MASTERY_STREAK_TARGET:
    wb = cursor.execute('''SELECT id, mastery_level FROM wordbook
                          WHERE user_id = ? AND english_word = ?''',
                        (user_id, word)).fetchone()
    if wb and (wb['mastery_level'] or 0) < 3:
        new_level = (wb['mastery_level'] or 0) + 1
        cursor.execute('''UPDATE wordbook
                          SET mastery_level = ?, review_count = review_count + 1,
                              last_reviewed = ?, updated_at = ?
                          WHERE id = ?''', (new_level, now_str, now_str, wb['id']))
        # 升星后连对计数清零:下一次升星要再连对 3 次
        cursor.execute('''UPDATE game_word_stats SET streak = 0, updated_at = ?
                          WHERE user_id = ? AND english_word = ?''',
                       (now_str, user_id, word))

这三条的数据来源是 game_word_stats 表:每个词的累计对错次数、当前连对、历史最高连对。也就是说,游戏和单词本共享同一份学习数据,而不是各记各的。

三、断网先存本地,进度跨设备 ​

游戏过程中的逐词成绩,断网时先写 localStorage,联网后补报。而星星、贴纸、关卡解锁这些"资产"存服务端(game_progress 表,按 game_type + progress_key 存 JSON),手机和电脑打开是同一份进度 —— 不然孩子在手机上打过的关,换台设备就白打了。

四、新增一款游戏要动哪几处 ​

目录约定固定:games/<游戏名>/ 下放 xxx.html、xxx.css、xxx.js,游戏列表里注册一张卡片,统计与存档复用现成的 /api/games/* 接口。没有构建步骤,也没有路由注册中心 —— 加一个目录就能跑。

本文阅读--次|全站访问--次|访客--人