① 摘要
面向乡村小学教师，在备课环节提供“教案→课堂互动游戏”的一键转化能力。教师只需粘贴教案文本，系统即可在 90秒内 生成可直接投屏使用的 HTML5 互动游戏，带来零代码、零设计、零成本的极简备课体验。
目前产品已部署上线
支持语数英科学道法五门学科，实测端到端生成 3 个游戏耗时仅约 2 分钟。
② 真实场景与需求
目标人群：
乡村小学 1-6 年级一线教师，以及乡村小学校长/教务主任等教育资源管理者。
痛点描述：
今年4月我在广西的乡村小学进行实地走访调研时，真实地观察到了老师们的备课困境。以三年级语文的老师为例，明天要上《望天门山》，她想在课堂最后 10 分钟用一个“诗句排序”小游戏让学生互动巩固。但她面临着现实的“四座大山”：
- 零技术基础：不会编程，连 HTML 是什么都不知道。
- 零设计能力：PPT 动画只会最基础的切换。
- 时间极度压缩：一个班 40 多个学生，备课、批改、家访已经占满整天，无法耗费 2-3 小时去手捏动画。
- 硬件条件受限：教室里有智慧黑板，但是没有方便可用的上课课件。
现有做法对比：
目前老师们通常去网盘或课件网站找资源，但固定模板无法匹配老师自己写的教案内容，且部分工具需要自费充值会员。最终，绝大多数老师只能无奈放弃互动环节，改回传统的“纯讲授”或“请同学上黑板写”。
核心矛盾： 乡村教师最缺的不是教学热情，而是把“好想法”变成“好工具”的技术桥梁。她们需要的是——输入教案，输出游戏，复杂的中间过程必须由 AI 隐形完成。
③ 作品介绍
产品形态：
轻量级网页工具（Web 应用）。无需安装任何软件，教师在办公室用手机或电脑输入教案，到教室用投影仪投屏即可，离线可用。
核心功能：
-
智能教案解析：输入教案文本或一句话（如“三年级语文《春晓》”），自动提取核心知识点。
-
AI 游戏规划：基于教学大纲，自动推荐 2-3 种最适合的互动类型（如语数英的拖拽排序、记忆翻卡、分类归纳等）。
-
一键生成交互页面：90 秒内输出完整 HTML5 游戏。自带开场动画、实时计时器、连击特效、错题回顾面板等完整游戏机制。
④ 用 SOLO 实现的过程（核心挑战与拆解）
在这个项目中，TRAE SOLO 是我绝对的主力开发搭档，帮我完成了从前端脚手架到后端复杂算法的快速落地：
1. 任务拆解与全栈构建
我通过向 SOLO 描述“前端三栏布局 + 后端 API + LLM 调用客户端”的四层架构，让 SOLO 直接帮我初始化了基于 Next.js + Tailwind CSS 的项目骨架，并完成了基础的 UI 组件编写。
2. 攻克核心技术难点（深度提取算法）
踩坑： 接入带有深度推理能力的大模型时，API 返回的内容包含了大量如“首先，用户提供的课题是…”的推理过程，导致标准的 JSON.parse() 直接报错崩溃。
破局： 我将这个痛点直接抛给 SOLO。在 SOLO 的协助下，我们共同编写并测试了一套“深度追踪提取算法”：
- 定位第一个 { 或 [
- 通过状态机逐字符扫描，正确处理转义序列 "
- 精准追踪嵌套层级，在 depth 归零时提取最外层纯净的 JSON 块。
这套在 SOLO 里跑通的算法，将 JSON 提取成功率从 30% 瞬间拉升到了 95% 以上。
3. Prompt 工程的持续微调
如何让大模型直接写出视觉精美且无 Bug 的游戏代码？我利用 SOLO 的对话视窗进行了 3 轮 Prompt 迭代。
最终在 SOLO 的建议下，我引入了参考模板系统：在系统提示词中内置一份高质量的 HTML 游戏范本，并附带“必须做到的 20 项检查清单”（如：必须包含计时器、移动端 Touch 事件支持等）。我在 SOLO 中反复模拟生成，直到输出代码的质量完全稳定。
4. 运维部署排雷
在部署阶段遇到了环境变量读取的坑。比如在 .env 中写了行内注释导致 API 报 404，以及 systemd 配置的环境变量名不匹配。我把日志报错直接贴给 SOLO，它迅速帮我定位了问题并提供了修改好的配置文件，省去了大量查阅文档的时间。
⑤ 成果展示
目前该系统已具备极高的可用性：
| 核心指标 | 实测表现 |
|---|---|
| 方案规划耗时 | ~9 秒（智能推荐 3 个匹配游戏） |
| 单游戏生成耗时 | ~30-90 秒 (包含约 2 万字符的完整代码) |
| 全流程端到端耗时 | 约 2 分钟 (从粘贴教案到进入游戏) |
| 硬件兼容性 | 完美适配 PC 浏览器 |
⑥ 验证方式与下一步
场景验证与反馈：
在针对广西乡村小学教师的早期访谈和调研中，该产品原型的思路得到了极大的验证。老师们对“离线可用”和“无需登录设计平台”的特性评价最高。