tutoring-prep

AI家教备课教案生成工具 | AI Tutoring Lesson Plan Generator

项目简介

基于Gitee.AI平台（沐曦GPU算力）开发的AI家教备课助手，自动生成结构化Word教案文档。

核心功能

• AI教案生成：调用Gitee.AI大模型自动生成符合家教场景的教案内容
• Word文档导出：支持生成标准化的Word格式教案，便于打印和分享
• 调用日志记录：完整记录每次模型调用的时间、延迟、Token消耗等性能数据
• 批量生成支持：支持批量生成多个学生的教案

技术架构

用户输入学生信息
       │
       ▼
generate_with_ai.py
       │
       ▼
model_service.py  ◄──────►  Gitee.AI API (minimax_2.7)
       │                       (沐曦GPU算力)
       │
       ▼
tutoring-prep.py
       │
       ▼
Word教案文件 (.docx)

使用的模型与算力环境

• 模型服务商：Gitee.AI
• GPU算力：沐曦GPU (MXGPU)
• 模型名称：MiniMax_M2.7
• API接口：OpenAI兼容格式
• API Endpoint：https://api.gitee.com/v1

项目结构

tutoring-prep/
├── tutoring-prep.py      # Word教案生成器（核心模块，不依赖外部API）
├── model_service.py      # Gitee.AI模型服务封装
├── generate_with_ai.py   # AI教案生成主程序
├── 教案/                  # 生成的教案Word文件输出目录
├── call_logs/            # 模型调用日志目录
│   └── call_log_YYYYMMDD.jsonl
└── generation_reports/   # 生成报告目录
    └── report_YYYYMMDD_HHMMSS.json

快速开始

1. 安装依赖

pip install python-docx requests

2. 配置API密钥

在代码中设置您的Gitee.AI API密钥：

api_key = "AMSIIEA0FFBSYM5OJNSY8FVM1GFVSTZIT3QNE917"

3. 运行示例

cd tutoring-prep
python generate_with_ai.py

4. 自定义学生信息

student_info = {
    "name": "学生姓名",
    "subject": "科目",
    "grade": "年级",
    "topic": "课题",
    "textbook": "教材版本",
    "school_type": "学校类型",
    "exam_type": "考试类型",
    "weak_points": "薄弱点",
    "duration": 60,  # 课时长（分钟）
    "date": "2026-05-17",
}

result = generate_teaching_plan_with_ai(api_key, student_info)

调用验证

日志文件格式

每次模型调用都会记录日志到 call_logs/call_log_YYYYMMDD.jsonl：

{"start_time": "2026-05-17 10:30:00.123", "end_time": "2026-05-17 10:30:02.456", "latency_ms": 2333.0, "prompt_tokens": 500, "completion_tokens": 800, "total_tokens": 1300, "model": "minimax_2.7", "temperature": 0.7, "prompt": "..."}

获取调用统计

from model_service import get_call_stats

stats = get_call_stats()
print(f"总调用次数: {stats['total_calls']}")
print(f"成功: {stats['successful_calls']} | 失败: {stats['failed_calls']}")
print(f"平均延迟: {stats['avg_latency_ms']}ms")
print(f"总Token消耗: {stats['total_tokens']}")

示例输入输出

输入（学生信息）：

{
    "name": "小明",
    "subject": "英语",
    "grade": "六年级",
    "topic": "be动词",
    "weak_points": "am/is/are混淆",
    "duration": 60
}

输出（Word教案）：

• 包含教学目标与重难点
• 教学流程与时间分配表
• 知识点讲解要点
• 例题精讲
• 随堂练习
• 课后作业
• 备忘卡片

性能数据

指标	数值
模型	minimax_2.7
平均延迟	~2-3秒
单次Token消耗	~1000-1500

部署说明

环境要求

• Python 3.8+
• 网络访问 Gitee.AI API

目录权限

确保以下目录可写：

• 教案/ - Word文件输出
• call_logs/ - 调用日志
• generation_reports/ - 生成报告

License

MIT License