Study Garden · 小学生学习花园生成器
Overview
把一份已验证可用的 490 KB 单文件 HTML 模板,按孩子信息一键个性化后交付。
应用为纯前端:每日任务清单、分科花园、蓝宝石奖励经济、连续打卡、宠物养成(Lv.25 上限、每 5 级 3 选一大奖)、家长视图(PIN)、JSON 备份导出。双击即可运行,无需安装、无需联网。
何时使用
- 用户要给孩子做学习计划/作业打卡/奖励激励类的网页或小工具
- 用户提到「学习工作台」「学习花园」「打卡表」「宠物养成学习」等词
- 用户要修改已有的学习花园(换名字、换年级、改奖励规则)
生成流程
- 收集参数(一轮问完,缺省项不追问):孩子昵称、年级标签。可选:应用标题(默认
<昵称>的学习花园)、初始宠物名。用户没提供的直接用模板默认值。 - 运行配置脚本生成个性化文件(唯一允许的改法,不要手改大文件):
bash
python scripts/configure.py --out 小明的学习花园.html --name 小明 --grade 三年级
# 可选:--title 小明的学习花园 --pet 火龙果
脚本只改模板顶部 CONFIG 块的 4 个字段,并做出现次数断言;若报「字段出现 N 次」说明模板被改过,停止并检查模板。
3. 交付:把生成的 html 给用户,双击即可用。数据存在各自浏览器的 localStorage,不同设备不互通,迁移用页内 💾 备份/恢复。
4. 需要在线链接/手机访问时:把生成的单文件 html 走「发布为应用」流程部署(入口就是这一个 index.html),不要改造成多文件工程。
5. 深度自定义(改奖励数值、换内置题库、改段位规则等):先读 references/customization.md,再动手;改完必须用无头浏览器或真机打开验证。
隐私红线(必须执行)
- 默认模板已去除一切个人信息;生成时不得把「真实全名 + 学校 + 班级」同时写进同一个文件用于公开发布。
- 给别人用/公开分享前,确认
CONFIG与页面里只有昵称级信息(如「小明」「三年级」),没有学校、班级、住址。 - 应用本身不联网上传任何数据;唯一网络相关能力是浏览器本地语音合成(英语听写)。
已知限制
- 预设任务「3年级必背」和语文/数学/科学内置题库是三年级内容,换年级不会自动变(详见 customization.md 第 5 节)。
- 「整理书包」任务固定只出现在每日计划,属有意设计。
- 覆盖模板文件不会丢用户数据(localStorage 独立于文件),但改
wb_fairy_key 前缀会丢。
Resources
scripts/configure.py— 个性化配置器(必经入口)assets/template.html— 去个性化的完整应用模板(约 490 KB,单文件)references/customization.md— 常量、数据存储、页面结构、已知限制速查