文件
岚椿铧 8790fcb5a9 feat: 加入了调试器
docs: 完善了文档
2026-05-23 21:40:58 +08:00
..
2026-05-23 21:40:58 +08:00
2026-05-23 21:40:58 +08:00
2026-05-23 21:40:58 +08:00
2026-05-23 21:40:58 +08:00
2026-05-23 21:40:58 +08:00

物理实验教学平台 (PhyExp)

项目概述

PhyExp 是一个交互式物理实验教学平台,支持学生在线完成实验预习、测验、数据记录和 AI 辅助分析。平台采用前后端分离架构,前端基于 Vue 3 + TypeScript,后端基于 Python FastAPI。

核心功能

  • 分阶段实验流程:预习 → 测验 → 实验 → 考试 → 总结
  • Excel 风格数据表:网格布局的数据录入界面,支持 LaTeX 数学公式渲染
  • AI 助教:基于 SSE 的流式对话,支持实验数据评价、答疑和错题分析
  • 自动计算与验证:前端 mathjs 即时计算,后端 Pydantic 验证,背景色可视化反馈
  • PDF 导出:实验数据导出为 A4 格式 PDF
  • 示波器集成:可选的 PyUSB 示波器数据采集(含模拟模式回退)

技术栈

层 技术
前端 Vue 3, TypeScript, Vite, Pinia, KaTeX, mathjs
后端 Python, FastAPI, Pydantic v2, Uvicorn
硬件 PyUSB, libusb (可选)
AI REST + SSE (Server-Sent Events)

快速开始

环境要求

  • Node.js >= 18
  • Python >= 3.10
  • uv (Python 包管理器)
  • yarn (Node.js 包管理器)

启动后端

cd backend
uv sync
uv run python -m app.main
# 默认监听 http://0.0.0.0:8000

启动前端

cd frontend
yarn install
yarn dev
# 默认监听 http://localhost:5173

目录结构

PhyExpRefactor/
├── backend/                    # Python FastAPI 后端
│   ├── app/
│   │   ├── main.py             # FastAPI 应用入口
│   │   ├── models.py           # 模型兼容导出
│   │   ├── schemas/            # Pydantic 数据模型
│   │   ├── api/                # REST API 路由
│   │   ├── core/               # 业务逻辑层
│   │   └── hardware/           # 示波器硬件驱动
│   ├── config/experiments/     # 实验 JSON 配置
│   └── ARCHITECTURE.md         # 后端架构文档
├── frontend/                   # Vue 3 前端
│   ├── src/
│   │   ├── components/         # 可复用组件
│   │   ├── pages/              # 页面组件
│   │   ├── stores/             # Pinia 状态管理
│   │   ├── types/              # TypeScript 类型定义
│   │   └── utils/              # 工具函数
│   └── ARCHITECTURE.md         # 前端架构文档
├── docs/                       # 本目录 - 项目文档
└── .vscode/                    # VS Code 配置

相关文档