用 SOLO 从零搭建一个乡村教师AI教学助手「师伴」——覆盖备课→上课→课后→成长全场景

用户50508 · 2026 年5 月 8 日 23:19

【Code With SOLO】用 SOLO 从零搭建一个乡村教师AI教学助手「师伴」——覆盖备课→上课→课后→成长全场景

一、摘要

用 TRAE SOLO 从零开发了一款面向乡村教师的 AI 教学助手「师伴」，覆盖备课→上课→课后→成长全教学场景。后端基于 FastAPI + SQLite，前端基于 React + TypeScript + Tailwind CSS，集成 DeepSeek/OpenAI 等大模型实现 AI 教案生成、课堂分析、家校报告等功能。整个项目从需求拆解到代码实现全部由 SOLO 辅助完成，大幅提升了开发效率。

二、背景

我是一名开发者，关注乡村教育数字化转型。乡村教师通常面临以下痛点：

备课负担重：缺乏优质教案模板，每次备课从零开始
教学记录难：课堂表现、学生进步缺乏系统化记录
家校沟通少：缺乏便捷的工具生成学生表现报告
激励手段单一：缺乏有效的学生积分激励体系

原本开发这样一个全功能系统可能需要 2-3 周，现在借助 TRAE SOLO，我能够在 2-3 天内完成从需求分析到前后端全栈开发。

三、实践过程

3.1 任务拆解

我将整个项目拆解为以下子任务，逐步交给 SOLO 完成：

阶段	任务	SOLO 能力
需求分析	梳理功能模块、技术选型	代码理解 + 规划
后端开发	FastAPI 路由 + 数据库服务层	代码生成 + 补全
前端开发	React 页面 + 组件 + API 层	代码生成 + 全栈补全
AI 集成	教案生成 + 语音识别	代码生成
联调测试	前后端对接 + Bug 修复	调试 + 错误分析

3.2 关键 Prompt 示例

后端服务层生成：

在 backend/services/ 目录下创建 Database 类，封装所有数据库操作。
需要支持：教师认证、学生管理、教案管理、课堂记录、积分系统、
班级管理、成绩管理、仪表盘数据。使用 SQLite，包含 ensure_schema()
自动建表，默认教师账号 teacher/shiban2024。

前端页面生成：

创建 React 登录页面，使用 Tailwind CSS。
蓝色渐变背景，白色登录卡片，包含用户名密码输入框，
调用 /api/auth/login 接口，登录成功后跳转到首页。

AI 教案生成服务：

创建 AI 教案生成服务，支持 DeepSeek/OpenAI/SiliconFlow 多模型。
包含意图分析、学情检索、教案生成、迭代修改、练习题生成。
无 API Key 时降级到本地规则引擎生成基础教案。

3.3 踩过的坑

SQLite 线程安全：FastAPI 异步环境下 SQLite 默认不允许跨线程使用，需要设置 check_same_thread=False
前后端字段不匹配：后端返回 token + teacher，前端期望 access_token + user，需要统一接口契约
依赖缺失：语音识别模块需要 python-multipart，首次运行才发现
热重载导致状态丢失：修改配置文件触发 uvicorn 热重载后，数据库连接和运行时目录需要重建

四、成果展示

4.1 项目架构

shiban/
├── backend/           # Python FastAPI 后端
│   ├── api/          # 11个API路由模块
│   ├── services/     # 业务逻辑层（数据库 + AI服务）
│   ├── models/       # Pydantic 数据模型
│   ├── config.py     # 配置管理
│   └── main.py       # 入口
├── frontend/          # React 前端
│   ├── src/
│   │   ├── pages/     # 9个页面组件
│   │   ├── components/ # 布局组件
│   │   ├── api/       # API调用层
│   │   └── hooks/     # 认证Hook
│   └── package.json
└── README.md

4.2 功能模块

模块	功能说明
工作台	Dashboard 统计学生数、教案数、班级数、今日记录
学生管理	学生 CRUD、搜索、完整档案查看
备课中心	AI 生成教案、教案库管理、收藏、标签
课堂记录	课堂记录 CRUD、AI 分析课堂表现
积分管理	加分/扣分、排行榜、里程碑激励
班级管理	班级 CRUD、学生关联
成绩管理	成绩录入、Recharts 趋势折线图
家校报告	AI 生成学生表现报告，支持微信分享