yu-ai-learn

鱼皮 AI 闯关学习小程序（yu-ai-learn）

作者：程序员鱼皮

本项目为教学项目，提供完整视频教程 + 文字教程 + 简历写法 + 面试题解 + 答疑服务，帮你提升项目能力，给简历增加亮点！

⭐️ 加入项目系列学习：加入编程导航

一、项目介绍

这是一套以 AI 编程实战 为核心的项目教程，基于 Taro + Python FastAPI + LangChain + LangGraph + DeepSeek，用 AI 编程的方式从 0 到 1 开发一个《AI 闯关学习微信小程序》，并且走完部署上线的全流程，带你亲身体验 AI Vibe Coding 的完整工作流，学会用 AI 做出一个能上线、能传播、能变现的小程序产品！

输入一句话说出你想学什么，AI 自动联网搜索最新资料并生成一组闯关题目，边答边学，每答一题立刻给出答案和讲解，通关后还能拿到一份 AI 复盘报告。

为什么做这个项目？

学知识这件事，最大的敌人不是难，而是枯燥。看文档、看视频，看着看着就走神了，看完还是记不住。

而人天生喜欢玩游戏，喜欢闯关、答题、拿奖励。既然现在有了 AI，为什么不让 AI 把「我想学的任何知识」自动变成一局闯关游戏呢？

为什么做成微信小程序，而不是 App 或者网页？因为学习这件事发生在碎片时间里，微信小程序免安装、随时随地能打开、依托微信生态的流量入口、还便于分享给朋友一起卷，对一个学习类产品来说几乎是最优形态。

更重要的是，这个项目的骨架可以直接复用到任何垂直领域，换个知识源就是一个新产品，比如驾考宝典、面试题库、企业内部培训考核、职业资格考试复习、儿童英语单词闯关等等。

8 大核心能力

1）一句话起题，AI 自动联网搜索并生成闯关题目。

大模型的知识有截止日期，所以项目给出题环节接入了 Tavily 联网搜索，用 LangGraph 做成了一个会自己决定搜什么、搜几轮的 ReAct Agent，保证题目不过时。

2）闯关答题，答完立刻判分和讲解。

支持单选、多选、判断三种题型，每题答完立刻高亮正确答案、标记错误选项，并给出解析和对应的知识点，答错也一样有讲解。

3）AI 生成通关复盘报告。

包含掌握度评分、薄弱知识点、三句话知识总结和下一步学习建议，还会结算本局获得的经验值。

4）想学什么就学什么，输入完全自由。

一句话、一段话、一个网址都可以，AI 会自行判断该怎么补全知识背景。

5）上传私有文档，基于自己的知识库出题（RAG）。

支持 PDF、Word、Markdown、纯文本四种格式，文档会被自动解析、分块、向量化后存入 Chroma 向量库，之后就能基于这篇文档出题，适合企业培训考核、特定题库复习等场景。

6）AI 给题目配图，学得更直观。

调用通义千问文生图模型按知识点生成配图，并转存到腾讯云 COS 获得永久链接，同时做了每日额度和并发控制来管住成本。

7）微信一键登录，闯关记录随时回看。

采用微信静默登录，用户无感授权即可拥有账号。个人中心能看到累计经验值和历史闯关列表，点进任意一条还能回看当时的复盘报告。项目还做了「可选登录」设计，没登录也能完整体验核心流程。

8）真正上线，微信里搜得到。

后端 Docker 化部署到微信云托管，走完服务类目申请、ICP 备案、代码审核流程，最终正式发布。

二、项目优势

本项目选题新颖，紧跟 AI 编程时代。区别于增删改查的烂大街项目，你将从一个想法开始，实战最主流的 AI 编程方法，上线发布一个真正有人愿意用的产品。

项目内容精炼，不到一周就能学完，带你快速掌握 AI 编程做产品的完整工作流，给你的简历和求职大幅增加竞争力！

技术丰富，覆盖小程序开发和 AI 应用开发的全链路：

从这个项目中你可以学到：

• 如何用 AI 做需求调研和竞品分析，划清 MVP 和扩展功能的边界？
• 如何配置 MCP 和 Agent Skills，充分扩展 AI 编程工具的能力？
• 如何让多个 AI 工具「赛马」产出 UI 原型，做出精美界面？
• 如何用 AI 从 0 开发一个微信小程序，包括跨端框架选型、脚手架初始化、页面开发？
• 如何用 LangChain 编排大模型，让 AI 稳定输出结构化的 JSON 题目数据？
• 如何用 LangGraph 构建 ReAct 智能体，把一次大模型调用升级成会自主联网查资料的 AI Agent？
• 如何从零实现一套 RAG 知识库，包括文档解析、分块、向量化、检索增强出题？
• 如何接入 AI 生图并结合对象存储，把临时图片链接转成永久可用的资源？
• 如何用 OpenSpec 做规范驱动开发，让 AI 在长周期项目里稳定产出？
• 什么是 Harness Engineering？如何用需求文档、方案设计、UI 原型、MCP、Skills 和 Git 给 AI 搭好脚手架？
• 如何把项目 Docker 容器化部署，并走完一整套小程序发布流程？

鱼皮系列项目优势

鱼皮原创项目系列以 实战视频教程 为主，从 0 到 1 带做，涵盖企业级 Java / Python 后端 + 前端全栈项目、最新 AI 应用开发 + AI 编程项目、大厂架构进阶项目。已有近 30 套 保姆级项目教程，并提供现成的源码、简历写法和面试题解，帮你用最快的速度学会做项目、写满简历、拿到 Offer。

比起看网上的教程学习，鱼皮项目系列的优势：从学知识 => 实践项目 => 复习笔记 => 项目答疑 => 简历写法 => 面试题解的一条龙服务

编程导航已有 近 30 套项目教程！ 每个项目的学习重点不同，从 0 到 1 带做，有大量完整的 AI 应用开发 + AI 编程 + 全栈项目，零基础也能学！

详细请见：https://codefather.cn/course（在该页面右侧有教程推荐和学习建议）

鱼皮的项目帮很多同学拿到了大厂高薪 Offer：

三、更多介绍

该项目功能丰富，涵盖闯关答题、AI 出题、复盘报告、用户系统、知识库、AI 配图 6 大模块，30+ 功能点，覆盖了一个真实上线小程序的核心业务场景。

本项目以 Taro 微信小程序 + Python FastAPI + LangChain / LangGraph 为核心，前后端分离，综合运用了多种主流的小程序开发和 AI 应用开发技术。

技术选型

四、快速运行

完整的保姆级步骤请参考 保姆级本地运行指南，里面有每个 API Key 的申请步骤、环境变量逐项说明和 11 个常见问题排查。下面是精简版。

前置条件

• Python >= 3.11
• Node.js >= 18（推荐 20+）
• MySQL >= 8.0
• 微信开发者工具（下载地址）
• 一个 DeepSeek API Key（✅ 必需，用于 AI 出题和报告）
• 一个 Tavily API Key（ 可选，用于联网搜索增强）
• 一个 阿里云百炼 API Key（ 可选，用于知识库 RAG 和 AI 生图）
• 一个 腾讯云 COS 存储桶（ 可选，用于存储题目配图）
• 一个 微信小程序测试号（ 可选，用于微信登录）

1. 克隆项目

git clone https://github.com/liyupi/yu-ai-learn.git
cd yu-ai-learn

2. 启动后端

cd backend

# 建议使用虚拟环境
python3 -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\Activate.ps1

# 安装依赖（国内可加 -i https://pypi.tuna.tsinghua.edu.cn/simple 加速）
pip3 install -r requirements.txt

# 配置环境变量
cp .env.example .env              # 至少填写 DEEPSEEK_API_KEY 和 MYSQL_PASSWORD

# 启动服务（数据表会在启动时自动创建）
python3 -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

启动成功后访问 http://localhost:8000/docs，能看到 FastAPI 接口文档即为正常。

数据库无需手动创建，MYSQL_AUTO_INIT=true 时启动会自动建库建 7 张表。也可以手动执行 python3 scripts/init_mysql.py。注意不要用 sql/init_mysql.sql 建表，该文件缺少 3 张表。

3. 启动前端

新开一个终端：

cd frontend
npm install                       # 国内可加 --registry=https://registry.npmmirror.com
npm run dev:weapp                 # 编译到 dist/ 并进入监听模式

然后用微信开发者工具新建项目，目录选择 frontend/dist，AppID 填测试号 AppID。

⚠️ 本地开发必须在开发者工具的「详情」到「本地设置」里 勾选「不校验合法域名」，否则请求 localhost 会被拦截。

生产构建（自动切换到线上后端地址）：

npm run build:weapp

4. 运行测试

cd backend
pytest

测试通过 mock 隔离了大模型和第三方接口调用，不消耗 API 额度。

5. 部署

backend/Dockerfile 提供了适配 微信云托管 的镜像构建文件，也可用于任意支持 Docker 的容器平台。部署所需的密钥类环境变量（数据库密码、各类 API Key、微信 AppSecret、JWT_SECRET 等）请通过平台的环境变量功能注入，不要 提交到代码仓库。

上线还需要完成小程序服务类目申请（AI 类需要「深度合成 - AI 问答」类目及资质材料）、ICP 备案、服务器域名白名单配置和代码审核，详细流程见教程第 12 期。

加入项目学习

编程导航已有 近 30 套项目教程！ 每个项目的学习重点不同，从 0 到 1 带做，有大量完整的 AI 应用开发 + AI 编程 + 全栈项目，零基础也能学！

详细请见：https://codefather.cn/course（在该页面右侧有教程推荐和学习建议）

欢迎加入 编程导航，加入后不仅可以全程跟学本项目，往期 近 30 套原创项目教程 也都可以无限回看。还能享受更多原创技术资料、学习和求职指导、上百场面试回放视频，开启你的编程起飞之旅~

助力新项目学习，给大家发放 限时编程导航优惠券，扫码即可领券加入。加入三天内不满意可全额退款，欢迎加入体验，名额有限，速来学习！

1 天不到 1 块钱，绝对是对自己最值的投资！成为编程导航会员后，可以解锁近 30 套项目的教程和资料，PC 网站和 APP 都可以学习，如图：