用 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"而不是"一个项目"
给幼儿做东西,交付链路本身就是体验的一部分。我要的是三件事:
- 双击就开 ,不装 Node、不跑
npm install; - 能发链接,老人手机上也能打开;
- 离线可用,断网时不至于白屏。
所以: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