Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
109 changes: 109 additions & 0 deletions README-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@

## 🗞️ 动态

- **2026-04-20** — **v1.0.0 发布!** 交互模式 — 3D 可视化、模拟实验、游戏、思维导图、在线编程,动手学习新体验。详见[功能特性](#-功能特性)。
- **2026-04-14** — [v0.1.1 发布!](https://github.com/THU-MAIC/OpenMAIC/releases/tag/v0.1.1) 自动语言推断、ACCESS_CODE 站点认证、课堂 ZIP 导入导出、自定义 TTS/ASR、Ollama 支持等。查看[更新日志](CHANGELOG.md)。
- **2026-03-26** — [v0.1.0 发布!](https://github.com/THU-MAIC/OpenMAIC/releases/tag/v0.1.0) 讨论语音、沉浸模式、键盘快捷键、白板增强、新 provider 等。查看[更新日志](CHANGELOG.md)。

Expand Down Expand Up @@ -207,6 +208,114 @@ docker compose up --build

## ✨ 功能特性

### 深度交互模式(新功能)

**被动听讲?❌ 动手探索!✅**

爱因斯坦说过:*"玩耍是最高形式的研究。"*

**标准模式**快速生成课堂内容,而**深度交互模式**更进一步——创建交互式、可探索、动手的学习体验。学生不只是观看知识,而是调整实验、观察模拟、主动探索原理。

#### 五种交互界面

<table>
<tr>
<td width="50%" valign="top">

**🌐 3D 可视化**

三维可视化呈现,让抽象结构更直观。

<img src="assets/interactive_mode/3D_interactive.gif" width="100%"/>

</td>
<td width="50%" valign="top">

**⚙️ 模拟实验**

流程模拟和实验环境,观察动态变化和结果。

<img src="assets/interactive_mode/simulation_interactive.gif" width="100%"/>

</td>
</tr>
<tr>
<td width="50%" valign="top">

**🎮 游戏**

知识小游戏,通过交互挑战加深理解和记忆。

<img src="assets/interactive_mode/game_interactive.gif" width="100%"/>

</td>
<td width="50%" valign="top">

**🧭 思维导图**

结构化知识组织,帮助学习者建立整体概念框架。

<img src="assets/interactive_mode/mindmap_interactive.gif" width="100%"/>

</td>
</tr>
<tr>
<td width="50%" valign="top">

**💻 在线编程**

浏览器内编码和即时运行,边写边学边迭代。

<img src="assets/interactive_mode/code_interactive.gif" width="100%"/>

</td>
<td width="50%" valign="top">

</td>
</tr>
</table>

#### AI 教师引导

AI 教师可以主动操作界面引导学生——高亮关键区域、设置条件、提供提示、在恰当时机引导注意力。

<img src="assets/interactive_mode/teacher_action_interative.gif" width="100%"/>

#### 多设备适配

所有生成的交互界面完全响应式——桌面、平板、手机均可使用。

<table>
<tr>
<td width="50%" align="center">

**桌面**

<img src="assets/interactive_mode/desktop_interactive.png" width="90%"/>

</td>
<td width="50%" align="center" rowspan="2">

**手机**

<img src="assets/interactive_mode/phone_interactive.png" width="45%"/>

</td>
</tr>
<tr>
<td width="50%" align="center">

**iPad**

<img src="assets/interactive_mode/ipad_interactive.png" width="90%"/>

</td>
</tr>
</table>

#### 需要更完整、更专业的 UI 生成体验?
如果你希望获得功能维度更丰富、交互能力更强,并面向高质量教育界面生产进行深度优化的完整版本,欢迎访问 [MAIC-UI](https://github.com/THU-MAIC/MAIC-UI)。

### 课堂生成

描述你想学习的内容,或附上参考材料。OpenMAIC 的两阶段流水线自动完成剩余工作:
Expand Down
111 changes: 111 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@

## 🗞️ News

- **2026-04-20** — **v1.0.0 released!** Interactive Mode — 3D visualization, simulations, games, mind maps, and online programming for hands-on learning. See [features](#-features) for details.
- **2026-04-14** — [v0.1.1 released!](https://github.com/THU-MAIC/OpenMAIC/releases/tag/v0.1.1) Automatic language inference, ACCESS_CODE authentication, classroom ZIP export/import, custom TTS/ASR providers, Ollama support, and more. See [changelog](CHANGELOG.md).
- **2026-03-26** — [v0.1.0 released!](https://github.com/THU-MAIC/OpenMAIC/releases/tag/v0.1.0) Discussion TTS, immersive mode, keyboard shortcuts, whiteboard enhancements, new providers, and more. See [changelog](CHANGELOG.md).

Expand Down Expand Up @@ -207,6 +208,114 @@ Set `PDF_MINERU_BASE_URL` (and `PDF_MINERU_API_KEY` if needed) in `.env.local`.

## ✨ Features

### Interactive Mode (New!)

**Passive listening? ❌ Hands-on exploration! ✅**

As Einstein said: *"Play is the highest form of research."*

While **Standard Mode** focuses on quickly generating classroom content, **Interactive Mode** goes further — creating interactive, explorable, hands-on learning experiences. Students don't just watch knowledge; they adjust experiments, observe simulations, and actively explore how things work.

#### Five Types of Interactive UI

<table>
<tr>
<td width="50%" valign="top">

**🌐 3D Visualization**

Three-dimensional visual representations that make abstract structures more intuitive.

<img src="assets/interactive_mode/3D_interactive.gif" width="100%"/>

</td>
<td width="50%" valign="top">

**⚙️ Simulation**

Process simulations and experimental environments for observing dynamic changes and outcomes.

<img src="assets/interactive_mode/simulation_interactive.gif" width="100%"/>

</td>
</tr>
<tr>
<td width="50%" valign="top">

**🎮 Game**

Knowledge-based mini-games that reinforce understanding and memory through interactive challenges.

<img src="assets/interactive_mode/game_interactive.gif" width="100%"/>

</td>
<td width="50%" valign="top">

**🧭 Mind Map**

Structured knowledge organization to help learners build an overall conceptual framework.

<img src="assets/interactive_mode/mindmap_interactive.gif" width="100%"/>

</td>
</tr>
<tr>
<td width="50%" valign="top">

**💻 Online Programming**

In-browser coding and instant execution for learning by writing, testing, and iterating.

<img src="assets/interactive_mode/code_interactive.gif" width="100%"/>

</td>
<td width="50%" valign="top">

</td>
</tr>
</table>

#### AI Teacher Guidance

The AI teacher can actively operate the UI to guide students — highlighting key areas, setting conditions, providing hints, and directing attention at the right moments.

<img src="assets/interactive_mode/teacher_action_interative.gif" width="100%"/>

#### Available on Any Device

All generated interactive UI is fully responsive — desktop, tablet, or mobile.

<table>
<tr>
<td width="50%" align="center">

**Desktop**

<img src="assets/interactive_mode/desktop_interactive.png" width="90%"/>

</td>
<td width="50%" align="center" rowspan="2">

**Mobile**

<img src="assets/interactive_mode/phone_interactive.png" width="45%"/>

</td>
</tr>
<tr>
<td width="50%" align="center">

**iPad**

<img src="assets/interactive_mode/ipad_interactive.png" width="90%"/>

</td>
</tr>
</table>

#### Need a More Complete and Professional UI Generation Experience?
If you are looking for a version with richer functionality, stronger interactivity, and deeper optimization for high-quality educational UI production, please visit [MAIC-UI](https://github.com/THU-MAIC/MAIC-UI).

### Lesson Generation

Describe what you want to learn or attach reference materials. OpenMAIC's two-stage pipeline handles the rest:
Expand All @@ -219,6 +328,8 @@ Describe what you want to learn or attach reference materials. OpenMAIC's two-st
<!-- PLACEHOLDER: generation pipeline GIF -->
<!-- <img src="assets/generation-pipeline.gif" width="100%"/> -->



### Classroom Components

<table>
Expand Down
Binary file added assets/interactive_mode/3D_interactive.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/interactive_mode/code_interactive.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/interactive_mode/desktop_interactive.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/interactive_mode/game_interactive.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/interactive_mode/ipad_interactive.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/interactive_mode/mindmap_interactive.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/interactive_mode/phone_interactive.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading