乐于分享
好东西不私藏

源码终于能给了:我把学习闯关系统拆成了小白也能改的版本

源码终于能给了:我把学习闯关系统拆成了小白也能改的版本

问灯AI · AI 工作流真实记录

前几天发完《我做了一套学习闯关系统》以后,评论区比我预想得热闹。

有人问:能不能给后面具体网站开发的提示词。

有人说:要是能分享一下就好了,有思路,有代码,可以在这个基础上按需修改。

还有人更直接:源码能共享下吗。

我当时回复得很谨慎:源码文件太大了,我整理一下,看能不能分享出来。

不是我不想给。

是真的太大了。

我本地那套“力兴积分闯关系统”,光视频素材就接近 9GB。里面还有孩子真实的闯关记录、错题、积分钱包、上传作业、每天生成的学习数据。

这种东西原样发出来,不合适。

所以我这两天干了一件有点笨但必要的事:把它拆成了一个公开分享版。

视频删掉。

真实学习记录删掉。

钱包流水删掉。

孩子名字也换成了通用称呼。

最后压出来,只有 63KB。

这才像一份能给大家折腾的源码。

从 9GB 到 63KB:公开分享前,先做脱敏和轻量化

这套系统到底是什么

先说清楚,它不是一个“AI 自动家教”。

我现在越来越不喜欢一上来就把教育工具说成“AI 家教”。

因为很多时候,真正有用的不是 AI 会讲多少道题,而是它能不能帮家长把一件事变得更容易开始。

我这套系统做的事很简单:

每天自动生成一批关卡。

孩子打开以后,不是一屏看到几十道题,而是只看到当前这一关。

关卡分成三类入口:

闯关。

错题。

加练。

每过一关,会有英雄积分。

答错的题,会进错题入口。

题目不是纯刷题,而是混着数学、英语、语文表达、学习习惯。

比如数学里会有百分数、分数、比例、方程、应用题。

英语里会有单词和句子跟读。

语文里会有听写、造句、复述。

习惯里会有“先做一关”“收尾整理”“错题复盘”这种很小的动作。

我做它的时候,脑子里想的不是“做一个大而全的平台”。

我只想解决一个很具体的问题:

让孩子愿意打开。

让他不要一打开就觉得“又要学习了”。

让家长也不要每天重新想,今天到底让他练什么。

源码包我做了哪些处理

公开版我没有放原始视频。

这个是第一刀。

原项目里有六年级数学动画、DK 数学动画、英语视频,本来是给孩子降低理解压力用的。但这些素材太大,也涉及来源问题,不适合直接塞进源码。

所以分享版默认关闭本地视频。

没有视频,也能正常闯关。

第二刀,是删掉 `data` 里的真实数据。

这个目录很关键,但不能公开。

系统运行以后,`data` 会自动生成这些东西:

`daily`:每天生成的关卡

`progress`:当天进度和错题

`wallet.json`:积分钱包

`uploads`:上传的照片或录音

如果你以后把自己改好的版本分享给别人,记得先清空 `data`。

第三刀,是把名字改成通用模板。

我原来所有页面、语音、鼓励语里都有孩子名字。

公开版统一改成“小小英雄”。

你拿到以后,第一件事就可以全局搜索“小小英雄”,改成你家孩子的小名,或者改成“闯关者”“小队长”都行。

小白怎么跑起来

这一步我尽量按完全没写过代码的人来写。

第一步,先装 Node.js。

不用理解它是什么。

你就把它当成“让这个网页系统跑起来的发动机”。

装 18 以上版本就行。

第二步,把源码压缩包解压。

注意,不要在压缩包里直接点文件。

一定要先解压成一个文件夹。

第三步,打开这个文件夹,在地址栏输入:

cmd

然后回车。

这时候会弹出一个黑色窗口。

第四步,在黑色窗口里输入:

npm start

看到类似 `http://127.0.0.1:3000` 的字样,就说明启动成功了。

第五步,电脑浏览器打开:

http://127.0.0.1:3000

如果你想让平板也能打开,就让电脑和平板连同一个 Wi-Fi。

然后把电脑的局域网 IP 找出来,在平板浏览器里打开:

http://电脑IP:3000

到这里,它就已经是一套能跑的本地学习闯关系统了。

真正需要改的,其实就 4 个地方

我知道很多人一看到源码就头大。

一堆文件,一堆代码,不知道从哪里下手。

但这套系统,普通家长真的不用从头看。

你先盯住 4 个地方就够了。

小白只改 4 个地方:名字、题库、关卡数、积分规则

第一个,改孩子名字。

全局搜索:

小小英雄

替换成你自己的称呼。

第二个,改题库。

打开:

mission-bank.js

里面最重要的是这几块:

mathMissions

englishMissions

chineseMissions

habitMissions

一行题目大概长这样:

["math-percent-101", "百分数", "把 25% 写成小数。", "0.25", "百分数去掉百分号,再除以 100。"]

你不用害怕。

它其实就是五个东西:

题目编号。

题目分类。

题目内容。

正确答案。

提示语。

你想换成自己孩子的题,就照着这个格式改。

第三个,改每天基础关数量。

还是在 `mission-bank.js`。

找到:

const DAILY_WEB_TARGET = 20;

如果你觉得 20 关太多,就改成 8。

如果你家孩子很能刷,也可以改成 30。

我自己的建议是,先少一点。

孩子愿意打开,比一天塞满更重要。

第四个,改积分规则。

打开:

server.js

搜索:

COINS_PER_REAL_YUAN

这是积分和现实奖励之间的换算。

再搜索:

missionCoinAward

这里可以改不同题型给多少积分。

我自己后来发现,积分不一定要给很多。

关键是反馈要及时。

孩子不是为了那点钱才做题,他需要的是“我刚才那一下真的被系统看见了”。

不会改代码,就把这几段丢给 AI

评论区还有人问,能不能给后面具体网站开发的提示词。

可以。

如果你拿到源码以后不知道怎么开口,就从这几段开始。

第一段,先让 AI 读懂项目:

请你先阅读这个项目,帮我用小白能听懂的话解释:

1. 每个主要文件是干什么的

2. 我如果只想改孩子名字、题目、积分,应该分别改哪里

3. 哪些文件不要随便动

先不要改代码,只解释。

第二段,让 AI 帮你换成自家孩子版本:

我想把这套家庭学习闯关系统改成我家孩子使用的版本。

孩子称呼是:____

年级是:____

最近最需要练的是:____

每天最多能接受 ____ 道题。

请帮我修改题库和每日关卡数量,保持系统能正常运行。

第三段,让 AI 帮你加题:

请在 mission-bank.js 里新增一组题目。

学科:____

主题:____

题目数量:____

难度要求:先简单后稍微提高。

每道题都要包含题目、答案、提示语。

不要改动其它功能。

第四段,改完以后让 AI 检查:

请检查我刚才修改后的项目:

1. 有没有语法错误

2. npm start 能不能正常启动

3. /api/daily 能不能生成今日关卡

4. 有没有把孩子真实记录、上传文件、钱包流水放进分享包

如果有问题,请直接修复。

你会发现,会不会代码不是最关键的。

关键是你要知道让 AI 改哪里,别让它一上来把整套系统重写。

你想继续加视频,也可以

公开版默认没开视频。

如果你自己有合适的本地视频,可以这样改。

先在 `public` 下面新建:

videos

然后把视频放进去。

再打开:

public/app.js

找到:

ENABLE_LOCAL_VIDEOS = false

改成:

ENABLE_LOCAL_VIDEOS = true

但我建议小白第一版先别折腾视频。

先把系统跑通。

先把名字改掉。

先把 5 道题换成自己孩子正在学的内容。

能跑起来,比一上来追求完整更重要。

我建议你这样改第一版

不要一上来就做“全科系统”。

第一版只做一个很小的版本。

比如:

数学 5 道。

英语 3 道。

语文 2 道。

习惯 2 道。

每天总共 12 关。

然后观察三件事:

孩子愿不愿意打开。

哪类题最容易卡住。

积分反馈有没有让他愿意继续。

如果这三件事有一点点变好,再慢慢加。

我自己做这套系统最大的感受是:

工具不是一次做完的。

它是孩子用一次,家长看一次,再回来改一次。

评论区有人说“有代码,可以在这个基础上按需修改,自己从 0 到 1 搞不定”。

我觉得这句话特别准确。

很多人不是没有想法。

是缺一个已经能跑起来的底座。

那这次,我先把这个底座放出来。

后面怎么改,就可以一边用,一边长。

这次我准备了两条路

会用 GitHub 的,可以直接看仓库。

https://github.com/gan-qin/family-learning-quest

不会用 GitHub 的,就走飞书下载压缩包。

源码包:

https://www.feishu.cn/file/Q9PgbPO4foeidNx1C5bcVRLfn4f

使用说明:

https://www.feishu.cn/file/G4slbtM0RonyYSxrHXfcBNiVnjh

我也把 GitHub Release 打好了,想下载固定版本的,可以看这里:

https://github.com/gan-qin/family-learning-quest/releases/tag/v1.0

源码分享,两条路:GitHub 看代码,飞书下压缩包

源码包我已经整理成公开分享版。

想要的,来问灯,回复:

闯关源码

我把轻量版和修改说明放一起。

别急着做大。

先让它在你电脑上跑起来。

*想聊的,来问灯。*

💡 问灯AI · 一个新媒体人用 AI 重建工作方式的真实记录