# teachagent

**Repository Path**: cpt11/teach

## Basic Information

- **Project Name**: teachagent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-02
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 故事小精灵 (Story Elf) · 幼儿看图讲故事伴读智能体

> 专为幼儿园 3-6 岁孩子设计的看图讲故事伴读软件。结合大模型理解能力与儿童语音识别，用温柔亲切的真人老师声音，一步一步带着孩子看懂图画、敢开口、讲出一个完整好听的故事。

🌐 **手机/电脑直接体验**：[https://story.alphaintelligence.ltd](https://story.alphaintelligence.ltd)  
📂 **完整代码开源仓库**：[https://gitee.com/cpt11/teach](https://gitee.com/cpt11/teach)

---

## 📑 教师参赛申报材料（婺城区教育智能体设计应用大赛）

本项目严格对照婺城区教育智能体大赛官方通知要求，参赛教师个人所需提报的文字申报材料均已完整备齐：

| 文件名称 | 说明与用途 |
| :--- | :--- |
| 📄 [《附件 1：智能体设计和使用说明 (申报文档)》](docs/附件1_智能体设计和使用说明_故事小精灵.md) | **参赛核心申报书**（申报单位、作者信息已留空，可打印盖章或导出 Word/PDF） |
| 📘 [《系统技术架构与实现原理》](docs/01_技术架构与详细设计说明书_TDD.md) | 供评审专家查阅的后台技术与数据流说明 |
| 📙 [《产品需求与功能规划说明书》](docs/02_产品需求与功能规格说明书_PRD_V2.0.md) | 包含 3-6 岁小中大班语言教学目标与功能设计 |
| 📗 [《提示词编写与 58 本绘本图库整理规范》](docs/03_Agent核心Prompt工程与知识库构建规范.md) | 详细展示防瞎编知识库与名师人设提示词编写方法 |
| 📕 [《真实教学试用效果与测试报告》](docs/04_测试验证与教学效果量化评估报告.md) | 记录 86 名幼儿真实试用数据与开口率提升分析 |

---
## 🌟 解决真实教学问题，为什么孩子们喜欢它？

### 1. 顺着孩子往下聊，绝不生硬逼问
传统的教学软件总是一板一眼地问：“第一幅画是什么？第二幅画是什么？” 只要孩子多说两句就被打断。  
**故事小精灵就像一位懂孩子的温柔幼师**：
- 孩子要是胆子大、一口气把故事讲全了，老师立刻拍手大力夸奖，并好奇地追问一个更有趣的问题；
- 孩子要是害羞只讲了半句，老师就先肯定他说得对，再温和地拉着他看下一幅图；
- 孩子如果卡壳想不起来，老师只在图里圈出线索提醒，绝不替孩子直接把答案说破。

### 2. 彻底去掉“AI 机械电音”，换上自然好听的真人声音
普通软件的声音硬邦邦的，像新闻播报员，小孩子听两句就觉得无聊。  
我们精选了 **4 位性格不同、声音柔和自然的好老师**（默认推荐：小晨老师自然口语），把语速放慢到最适合小朋友听懂的节奏，说话就像大姐姐坐在旁边笑眯眯地聊天。

### 3. 一目了然的干净界面，没有任何杂乱表情符号
不用花里胡哨的 Emoji 表情干扰幼儿注意力。底部的录音麦克风是清清爽爽的矢量图标，孩子小手一按就能说话，松开就能发送，3 岁小班娃娃也能自己拿手指操作。

### 4. 讲完故事发大奖杯，出具能力小报告
孩子讲完故事，屏幕上会绽开五彩礼花，跳出一座闪亮的大奖杯，告诉孩子获得了“看图讲故事小达人”荣誉！还会给老师和家长生成一份观察力、表达力和连贯性的小结，点击还能听孩子自己的口播录音。

---

## 📱 手机端真实操作页面全览

### 1. 挑选班级与绘本封面

| 选班级（小班/中班/大班） | 小班连环画（2幅简易图） |
| :---: | :---: |
| ![班级年龄段选择](docs/images/01_step_age.png) | ![小班绘本挑选](docs/images/02_step_story_small.png) |
| 根据年龄自动匹配难度，小班抓词汇、大班抓情节 | 满格生动手绘封面，让孩子一眼就喜欢 |

| 中班连环画（多角色情节图） | 大班连环画（4幅完整故事脉络） |
| :---: | :---: |
| ![中班绘本挑选](docs/images/02_step_story_middle.png) | ![大班绘本挑选](docs/images/02_step_story_big.png) |
| 支持点击【换一批】换一组新故事 | 4幅连贯故事，培养孩子说清前后因果 |

---

### 2. 讲故事互动与录音

| 2 幅连环画互动示范 | 4 幅连环画互动示范 |
| :---: | :---: |
| ![2幅连环画互动](docs/images/03_step_interact_2frames.png) | ![4幅连环画互动](docs/images/03_step_interact_4frames.png) |
| 画面大屏排布，晓晓老师温柔引导 | 经典故事《小茶壶会唱歌》，顺着脉络带孩子开口 |

| 麦克风录音中（波形指示） | 键盘打字辅助模式 |
| :---: | :---: |
| ![SVG麦克风录音](docs/images/03_step_interact_recording.png) | ![打字输入模式](docs/images/03_step_interact_typing.png) |
| 按住说话、松开发送，适合幼儿小手操作 | 方便老师或家长临时输入文字辅助记录 |

---

### 3. 查看大图、换声音与领奖杯

| 轻触全屏放大检视细节 | 选名师声音与护眼皮肤 |
| :---: | :---: |
| ![大图放大检视](docs/images/06_image_zoom_modal.png) | ![名师音色设置](docs/images/05_settings_modal.png) |
| 任何图画轻触即可全屏放大看细节 | 4 款生活化声音（小晨/晓晓/依依/小雨）任选 |

| 结业荣誉奖状与能力评分报告 |
| :---: |
| ![结业荣誉报告](docs/images/04_step_report.png) |
| 金色大奖杯 + 细节观察/语言表达/逻辑连贯三维评分 + 故事回放 |

---

## 🛠️ 项目结构与运行方法

### 目录结构
```text
TeachAgent/
├── docs/                               # 参赛全套申报文档与实机截图
│   ├── 附件1_智能体设计和使用说明_故事小精灵.docx  # 官方格式申报书 (Word)
│   ├── 附件4_2026年婺城区教育智能体设计应用大赛参赛名单汇总表_填写示例.docx
│   └── images/                         # 11 张高清手机实机操作截图
├── public/                             # 网页前端静态文件
│   ├── index.html                      # 主页面
│   ├── style.css                       # 4 套护眼儿童视觉主题
│   ├── app.js                          # 交互与录音逻辑
│   └── story_data.js                   # 58 本原创连环画故事知识库
├── functions/api/                      # 后台云函数服务
│   ├── asr.js                          # 语音识别接口
│   ├── tts.js                          # 拟真语音合成接口
│   └── session/interact.js             # 启发式带教逻辑
├── package.json
└── README.md
```

### 老师如何快速在自己电脑上运行？
1. 安装 Node.js；
2. 下载代码：
   ```bash
   git clone https://gitee.com/cpt11/teach.git
   cd teach
   npm install
   npm run start
   ```
3. 打开电脑浏览器访问 `http://localhost:3000` 即可开始使用。