编程入门学习者长期依赖视频课程，缺少即时的动手反馈：写完代码没人逐行检查，出错时也不清楚是哪一步理解偏了。市面上的在线判题平台多面向算法竞赛，题目难度跳跃大，初学者往往在语法阶段就已流失。
本产品面向零基础到入门阶段的 Python 学习者，把语法基础与 AI 入门知识拆分为 20 个递进关卡。每关包含故事化情境、知识点讲解、编码任务与本地测试用例，提交后由大模型给出评分与具体修改建议，并按掌握程度生成复习提醒。使用者无需配置任何开发环境，本地启动即可学习，全部学习数据保存在本机数据库中。
1. 关卡地图：20 个关卡按「入门—变量—逻辑—函数—AI 入门」的路径递进解锁，展示通关状态与三星评级。
2. 知识点讲解：每关包含故事背景、概念讲解、示例代码与常见陷阱，支持 Markdown 排版与代码高亮。
3. 在线编码与运行：页面内置代码编辑器，可直接编写并运行 Python，支持模拟程序输入。
4. 本地判题：每关配置多组测试用例，提交后逐条校验，并显示每条用例的实际返回值。
5. AI 批改点评：调用大模型对代码给出百分制评分、问题分析与改进建议。
6. 感悟笔记与复习提醒：记录学习心得，AI 自动总结问题；对易错关卡生成到期的复习清单。
7. 修炼足迹与旅程预览：已通关关卡以卡片墙与滑动画廊呈现学习轨迹。
8. 背景主题切换：提供银河、光雨、雷电、飘雪、网格五种动态背景。
9. 学习助手对话：页面内可随时向 AI 导师提问，结合当前关卡内容作答。
我独立负责需求设计、后端接口、判题引擎、前端界面与 AI 接入。
技术栈：后端使用 Python 3.13 + FastAPI + uvicorn；数据存储使用标准库 sqlite3；前端为原生 HTML/CSS/JavaScript 单页应用，代码编辑器使用 CodeMirror 5；AI 部分接入 DeepSeek Chat，用于批改点评、分步提示与笔记总结。
实现要点：
1. 判题引擎在受限环境下执行用户代码并逐条比对测试用例，同时返回标准输出、错误信息与通过情况。
2. 关卡内容与代码逻辑分离，20 关的题目、讲解与测试用例统一放在 levels.json 中，新增关卡无需改动后端代码。
3. AI 接口与判题结果解耦：即使模型不可用，判题与进度记录仍能正常完成。
4. 前端为纯静态单页，通过接口驱动视图切换，未引入前端框架，本地运行与部署成本低。
5. 进度、笔记与历史提交全部落地 SQLite，支持按「掌握程度 + 间隔时间」生成复习清单。
评论