# teacher-tool

**Repository Path**: yangkun2003430/teacher-tool

## Basic Information

- **Project Name**: teacher-tool
- **Description**: 小学教学工具箱 - 面向乡村教师的免费教学辅助平台
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-19
- **Last Updated**: 2026-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📚 小学教学工具箱

> 面向乡村教师的免费、开源、交互式教学辅助平台

## 🎯 项目简介

小学教学工具箱是一个面向广大教师（尤其是乡村教师）的免费教学辅助平台。平台涵盖数学、语文、英语、科学等科目，提供可视化、交互式的教学工具，帮助教师在有限条件下提升教学质量。

### 解决的问题

- 乡村学校缺乏实物教具（如几何模型）
- 优质教学软件价格高，学校负担不起
- 教师备课时间长，缺少可复用的数字化资源
- 学生空间想象力培养缺乏有效工具

## ✨ 已上线功能

### 🧊 立体图形与三视图（五年级 · 观察物体）

- **自由搭建**：支持正方体、圆柱、球体、圆锥四种几何体
- **四视图自动生成**：正面、左面、右面、上面视图实时同步
- **交互式操作**：左键旋转视角、右键放置图形、一键切换标准视角
- **预设示例**：L形、阶梯形、T形、十字形、三层塔等经典案例
- **8种颜色**：自由切换，区分不同结构

## 🛠️ 技术栈

| 技术 | 用途 |
|------|------|
| React 19 | UI 框架 |
| TypeScript | 类型安全 |
| Three.js + @react-three/fiber | 3D 渲染 |
| @react-three/drei | 3D 辅助组件 |
| React Router | 路由管理 |
| Vite | 构建工具 |
| Canvas 2D | 三视图绘制 |

## 📁 项目结构

```
src/
├── tools/
│   └── registry.ts          # 工具注册表（添加新工具只需一行配置）
├── pages/
│   ├── Dashboard.tsx         # 首页仪表盘
│   └── Geometry3DPage.tsx    # 3D几何工具页面
├── components/
│   ├── layout/               # 平台布局（侧边栏+顶栏）
│   ├── scene/                # 3D场景组件
│   ├── toolbar/              # 工具栏组件
│   └── views/                # 三视图组件
├── stores/                   # 状态管理
├── utils/                    # 工具函数（三视图算法等）
└── types/                    # TypeScript 类型定义
```

## 🚀 快速开始

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 预览生产版本
npm run preview
```

## 📋 操作说明

| 操作 | 功能 |
|------|------|
| 左键拖动 | 旋转3D视角 |
| 右键点击 | 放置几何体 |
| 中键拖动 | 平移视角 |
| 滚轮 | 缩放 |
| 正/左/右/上按钮 | 一键切换标准视角 |
| ◀/▶ 按钮 | 折叠/展开左右面板 |

## 🔮 路线图

- [ ] 分数可视化工具（三年级）
- [ ] 面积与周长计算器（三年级/五年级）
- [ ] 乘法表互动练习（二年级/三年级）
- [ ] 坐标系绘图工具（六年级）
- [ ] 拼音学习工具（一年级）
- [ ] 笔顺演示工具（一年级/二年级）
- [ ] 单词卡片（三年级起）
- [ ] 太阳系模拟（六年级）

## 🤝 如何添加新工具

只需 3 步：

1. 在 `src/tools/registry.ts` 中添加工具配置
2. 创建页面组件 `src/pages/XxxPage.tsx`
3. 在 `src/App.tsx` 中添加路由

## 📄 开源协议

MIT License

---

**用 AI 让教育更公平，让技术更有温度。**