用 AI 给娃做了一个识物游戏:一份 2.3MB 的单文件 HTML,126 张卡片、三种玩法,手机平板打开就能玩

用 AI 给娃做了一个识物游戏:一份 2.3MB 的单文件 HTML,126 张卡片、三种玩法,手机平板打开就能玩

先放成品,扫码/点开就能玩,不需要登录、没有广告、没有倒计时:

4mhbm5naez8em.doubao.link/app/app_17j...

它叫「卡片乐园」,给 3--6 岁的孩子用:11 个分类、126 张认知卡,三种玩法(认一认 / 连一连 / 翻翻乐)。整个游戏是一个 HTML 文件 ,图片素材在旁边的 assets/ 目录里,没有任何构建步骤、没有 npm、没有框架。

这篇文章不讲"AI 多强",讲两件事:需求是怎么被一轮轮问清楚的 ,以及哪些实现细节值得抄走。


一、需求不是想出来的,是被问出来的

第一句话我只给了四个字:"益智游戏"。

于是先被反问了三件事:给谁玩、什么形式、想练什么。答案定下来之后,整个项目的边界就清楚了:

  • 3--6 岁,识字量接近于零,所以界面上的字越少越好,靠图形和声音沟通;
  • 要"识物 + 记忆",所以有配对,也有认卡;
  • 家长明确不要的东西:倒计时、排行榜、积分、连击特效。

这三条直接决定了后面所有取舍。比如"没有时间限制"不是一句文案,它意味着进度条只显示"已找到 3 / 6 对",永远不会因为你慢而变红。

第一版只做了一个翻翻乐:3D 翻牌、星星进度、Web Audio 合成的音效、通关撒彩带。素材是 AI 生成的卡通插画,统一缩到 512px 的 JPEG。

第二版加了分类:蔬菜、水果、动物、交通工具、混搭。

第三版是结构上最大的一次改动:用户给了一个很明确的层级------

认一认:分类型 → 点进类型 → 出现卡片 → 点卡片读信息并介绍 连一连:分类型,相同的东西点击连线 翻翻乐:记忆配对

于是页面从"一个棋盘"变成五屏:首页选类别 → 选玩法 → 对应模式(外加认卡详情弹层、通关弹层)。

第四版 扩容:分类从 5 个到 9 个,每类 8 张变 10 张,卡片 32 → 80 张。新增的 48 张插画分四批生成、批量下载、用 Windows 自带的 System.Drawing 缩到 512px / JPEG q85(这台机器上没装 PIL,现成方案反而更省事)。

第五版发布成可访问链接(这一步比想象中重要,后面踩坑里会说)。

第六版做体验优化:刘海安全区、记住上次选的类别和难度、连线"长"出来的动画、配对成功弹一下加绿色对勾。

第七版加了三类"概念卡":认识数字(1--10)、认识字母(A--Z)、颜色 / 形状 / 大小。这一版我换了载体,理由见下面第三节。

第八版加了访问记录:本地记录每次打开、每局玩法、每次通关。

八轮,改的始终是同一个 HTML 文件、同一个文件名。到最后一版 126 张卡,体积账也好算:HTML 本体 106KB,80 张压缩插画 2.2MB,合计 2.3MB,打开一次就全在本地缓存里了。

126 张卡的分工:

分类 卡片 载体
小动物 / 水果 / 蔬菜 / 交通工具 / 食物 / 衣服 / 玩具 / 大自然 各 10 张,共 80 AI 插画(JPEG)
数字 10(1--10) 内联 SVG
字母 26(A--Z) 内联 SVG
颜色形状 10(4 色 + 4 形状 + 大/小) 内联 SVG

二、为什么选"一个 HTML"而不是"一个项目"

给幼儿做东西,交付链路本身就是体验的一部分。我要的是三件事:

  1. 双击就开 ,不装 Node、不跑 npm install;
  2. 能发链接,老人手机上也能打开;
  3. 离线可用,断网时不至于白屏。

所以:CSS 内联在 <style>、JS 内联在 <script>,状态用一个普通对象加若干重渲染函数,不用框架、不用 type="module"。整套东西只有一个约束要守:素材引用必须能被发布链路静态扫描到------这一点下面单独讲。


三、概念卡为什么放弃 AI 插画,改用内联 SVG

数字、字母、形状这三类,一开始我打算继续生成插画。想一想就知道不合适:

  • 数字 7 被画成"旁边七颗星星",模型有可能画出六颗或八颗------错误率不可控;
  • 字母 26 个,大小写各要一张,等于 52 张图,体积和生成轮次都不划算;
  • 颜色卡如果做成插画,孩子看到的是"一个红苹果",记住的是苹果,不是红色。

换成矢量绘制之后,这几件事同时解决了:

  • 数字 1--10:一个大号数字 + 与数量严格对应的圆点,点数由代码算,不会错;
  • 字母:大写字 + 小写字上下排,完全清晰;
  • 颜色:一块纯色色块,没有干扰物;
  • 形状:圆 / 方 / 三角 / 五角星,纯色实心,边角清楚,不会被插画的阴影和材质干扰;
  • 大小:同一画面里画一大一小两个圆,目标那个实心、参照那个淡------对比关系一眼看得出来。

关键是,这一切没有改动卡片的取图逻辑,只是加了一个分流函数:

scss 复制代码
function faceNode(key){
  var item = itemByKey(key);
  if (item && item.art) return artNode(item.art);   // 概念卡:现场画 SVG
  return faceImage(key);                            // 实物卡:从隐藏图库克隆 <img>
}

全站有五处取卡片正面的地方(首页预览、认卡网格、认卡详情、连一连缩略图、翻翻乐牌面),统一改成调 faceNode 就接上了。46 张矢量卡,新增字节为 0。


四、四个值得抄走的实现细节

1. 隐藏图库 + clone:为了让发布链路扫得到图片

发布一个单文件 HTML 时,平台只会静态扫描 <img src>、<link href>、CSS 的 url()。把图片路径写在 JS 数组里,或者写在 data-src 上,发布之后一律裂图。

所以实物卡没有用"JS 里拼路径",而是把所有图片一次性写进一个 display:none 的图库:

xml 复制代码
<div id="faceLib" style="display:none" aria-hidden="true">
  <img src="assets/bear.jpg" alt="小熊" data-key="bear">
  <img src="assets/apple.jpg" alt="苹果" data-key="apple">
  <!-- ... 共 80 张 -->
</div>

运行时按 data-key 克隆一份:

ini 复制代码
function faceImage(key){
  var tpl = el.faceLib.querySelector('[data-key="' + key + '"]');
  var img = tpl.cloneNode(true);
  img.removeAttribute("data-key");
  img.alt = "";
  return img;
}

好处是:图片路径只出现在 src 属性里(发布能扫到),卡片正面永远只有当前那一张图,翻牌时不需要再发请求------图库里的 80 张会在首次加载时一起进缓存,之后就全是本地命中。代价是首屏要拉一次全量图,所以每张都压到 512px / JPEG q85,80 张合计 2.2MB;同时给图库里的图统一打上 decoding="async" 和 draggable="false",避免手机上拖拽图片和主线程解码卡顿。

2. 连一连的连线:SVG 三次贝塞尔 + dash 生长动画

连线不是用 Canvas 画的,而是往一个覆盖在牌面上的 <svg> 里插 <path>。每对连线一条三次贝塞尔:

lua 复制代码
var path = document.createElementNS(SVG_NS, "path");
path.setAttribute("d", "M" + x1 + " " + y1 + " C" + (x1 + (x2 - x1) * 0.45) + " " + y1 +
                 ", " + (x2 - (x2 - x1) * 0.45) + " " + y2 + ", " + x2 + " " + y2);
path.setAttribute("stroke", pair.color);
path.setAttribute("stroke-width", "4");

再让线"从左往右长出来":先量路径长度,用 stroke-dasharray 把线整段切掉,动画把 stroke-dashoffset 归零:

ini 复制代码
var len = path.getTotalLength();
path.style.strokeDasharray = len + " " + len;
if (fresh && !reduceMotion) {
  path.style.strokeDashoffset = String(len);
  // 下一帧过渡到 0,配合 transition,就是"画出来"的效果
}

fresh 标记只给刚连上的那条用,重绘时已经存在的线不再重播动画------不然每次点一下,满屏的线都会集体抖一次。

3. 牌堆实际对数要回写到 state

这一条是补漏。难度档是 4 / 6 / 8 / 10 对,但任何分类的卡片数都可能少于 10(现在是 10、26、10,够用;以后加小分类就不一定)。取牌时本来就有兜底:

ini 复制代码
var picks = shuffle(pool).slice(0, Math.min(pairs, pool.length));
state.pairs = picks.length;   // 实际发到手上的对数

如果进度条、星级、通关文案读的还是"难度表里的对数",就会出现"已找到 8 / 10 对"永远达不成的死局。所以所有展示都用 state.pairs,一处都不例外。

4. 幼儿交互的四条硬指标

  • 热区 ≥ 44px :类别按钮全部 min-height:44px,小孩的手指精度不背这个锅;
  • 不做倒计时:进度只说"已找到几对",不说"还剩几秒";
  • 反馈要立刻:配对成功音效 + 卡片弹一下 + 右上角绿色对勾,三件事同时发生;
  • 尊重 prefers-reduced-motion:命中时所有生长、弹跳动画直接给终态,彩带也不撒。

音效是 Web Audio 现场合成的(OscillatorNode,flip 620Hz、match 660→880→1120、win 523→659→784→1046),不加载任何音频文件,所以整包很小。按规矩来:默认静音、必须用户点一下(resume())才出声、右上角有开关(role="switch")、音量 0.32、localStorage 记住开关状态。iOS 侧边静音键会静音合成音,这一点用一个灰色小字提示解决,不弹窗。


五、踩过的坑(Windows + 发布链路)

坑 现象 解法
.ps1 里的中文路径 中文被按 GBK 解码成乱码,New-Item 报"访问被拒绝" 脚本全文保持 ASCII,路径用 $PSScriptRoot 推导
图片路径写在 JS 里 本地好好的,发布后全裂图 路径只出现在 <img src> 和 CSS url() 里
单次生图有上限 一次要 48 张直接报错 分批(10 + 10 + 10 + 8),再批量下载压缩
Edit 的 old_string 不唯一 报 Found 2 matches,改不进去 带上下文行,让匹配点唯一
key 撞名 新加的形状卡 key 和大自然的"星星"撞了 给新卡加前缀(shapeStar / colorRed / sizeBig)
严格模式下的手滑 多写一行未声明赋值,整段 JS 直接 ReferenceError "use strict" 会把这类错误当场抛出来,别关掉它

发布这一步其实很省事:单文件部署会自动爬取同目录 assets/ 里的依赖,80 张相对路径的图不用逐张上传:

css 复制代码
lark-cli apps +deploy --file-path ./记忆配对小游戏.html --app-id app_17j70csr606

返回里看 ok(不是看 exit code),再轮询到 status=finished,取 online_url。之后每次迭代复用同一个 app_id,手机上的链接就始终不变------对"发给家人"这件事来说,这点很重要。


六、访问记录:为什么只做了"本机"

最后加的一个功能是访问记录:每次打开、每局玩法(含类别和卡片数)、每次通关都会写一条,首页底部点"访问记录"能看"打开次数 / 开始玩 / 最近一次",最多留 60 条,可一键清空。

实现就是 localStorage 里一个数组:

scss 复制代码
function addLog(kind, text){
  var list = readLog();
  list.push({t:Date.now(), kind:kind, text:text});
  if (list.length > LOG_MAX) list = list.slice(list.length - LOG_MAX);
  writeLog(list);
}

写的时候就用 try/catch 包住------隐私模式下 localStorage 会直接抛异常,不能让它把整个游戏搞崩。

说清楚边界:这是本地记录,换设备看不到。想要"这条链接被多少人打开过"的真实访问量,纯静态单文件做不到,得接一个有后端的统计接口。这个功能我留着,等有服务端了再接。


七、现在能玩到什么

4mhbm5naez8em.doubao.link/app/app_17j...

  • 11 类 126 张卡(另有一个"混搭"入口,把 126 张全放进池子里):小动物 / 水果 / 蔬菜 / 交通工具 / 食物 / 衣服 / 玩具 / 大自然 / 数字 / 字母 / 颜色形状
  • 三种玩法:认一认(点卡听讲解,支持键盘 ←/→ 翻页)、连一连(左右各点一张连起来)、翻翻乐(4/6/8/10 对四档)
  • 手机上刘海和底部手势条自动留白,类别和难度会记住上次的选择
  • 支持朗读(speechSynthesis,zh-CN),不支持时会自动提示

接下来想做的:拼音/英文朗读的发音细节、更多概念卡(时间、反义词)、以及一个家长能看的孩子学习足迹。

如果你也在给小孩做类似的小工具,欢迎在评论区聊------尤其是"图片怎么放才能不被发布链路吃掉"这件事,我在这上面交过学费。

技术栈:原生 HTML/CSS/JS(单文件)· Web Audio 合成音效 · 内联 SVG · localStorage · SpeechSynthesis

相关推荐
Hilaku20 分钟前
Claude Code 过夜跑长任务实战:tmux、权限、验收,以及我为什么换到 ApexOne
前端·javascript·程序员
程序员大阳35 分钟前
副队长ES6+教程(14)--手写Promise来加深理解
前端·javascript·es6·源码·promise·手写·深层
J船长44 分钟前
从 Trellis 看 AI 研发工具选型:OpenSpec、Spec Kit 与 Harness 如何配合
前端
FungLeo1 小时前
成为全栈·Vue 管理后台篇·可折叠侧栏与移动抽屉:后台导航的响应式实现
前端·javascript·vue.js·侧边栏·响应式布局·无障碍·移动端导航
deli0073 小时前
翻到第 1000 页为什么卡?LIMIT OFFSET 与游标分页实测
前端
johnjincaaaa3 小时前
猿人学第22题「初识-魔改标准算法」逆向实录:jsconfuser 混淆下的 AES + MD5 魔改还原
前端
deli0073 小时前
马赛克打多粗才安全?8 档像素块 PSNR 实测,脸还认得出吗
前端
JianZhen✓3 小时前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
deli0073 小时前
为什么 5 个人 5 把叉子会全卡住?deadlock 四条件逐项实测
前端