# SmartKBS — 智慧教学平台
🌐 中文 | English
> 面向小学、初中、高中三个学段的 AI 智慧教学平台 — 学科、年级、班级均由配置驱动,不限定任何一门学科。
> 覆盖 教 · 学 · 练 · 评 · 管 五条主线,51 个功能分区按主线归为六章,共 60+ 功能点:
> - 🏠 入口 · 首页与待办 — 智能仪表盘、学生任务清单(多维筛选 · 多视图 · 简化模式)
- 🧑🏫 教 · 教学与资源 — 课程大纲(五级树 · 视野三档)、AI 讲演、AI 播客、AI 教学助手、智能题库与标签维护、在线考试、智能组卷与 Word 导出(原生公式)、AI 资源推荐、AI 生成 HTML 资源、资源中心与管理、文件中心
- 🎓 学 · 学习与练习 — AI 对话(知识问答)、AI 学伴、探索画布(AI 伴随式无限画布)、课程练习、同步练习、错题巩固、每日精选与热点新闻、代码练习
- 🎪 练 · 课堂活动 — 随堂测验、课堂投票、提问管理、课堂抽问、课堂闯关、知识抢答、分组讨论、协作白板、智能点名与考勤、知识闯关、作业中心(对话 / 文件 · AI 批改 · 应交名单与催交)
- 📊 评 · 学情分析与激励 — AI 学情分析、AI 课堂总结、教学简报、进度与活动监控、数据导出、成长档案、我的画像、12 级称号与成就徽章、自动积分奖励
- ⚙️ 管 · 系统管理 — 用户与权限(CSV 批量导入秒级)、系统公告、通知中心、技能管理、系统配置(云/本地双引擎 · 简报全局策略 · 日志轮转与保留)、在线增量升级、多主题外观
> 基于 FastAPI + React 构建,接入阿里云 DashScope(通义千问 / 通义万相)、DeepSeek 与本地 Ollama 引擎(云端/混合/本地三档);SSE 流式输出与 WebSocket 实时链路支撑课堂并发,数据全部落在本地 SQLite 与本地目录,可完全离线部署。
目录
- 📋 项目简介 · 💡 核心设计理念 · 🎮 演示环境 · ✨ 功能总览
- 📦 更新日志 · 🚢 部署安装指引 · 🚀 快速开始 · 📁 项目结构
- 💾 数据存储 · 👥 权限总览 · 🔧 技术栈 · 📄 许可证 · ❓ 常见问题 · 📬 关于
📌 V9.2.0 更新亮点(纲要)
> - 🎒 学生任务清单升级(新):多维筛选(教师/学科课程/类型/时间窗/资源形态)· 分组轴+截止日时间线多视图 · 内联筛选面板勾选即用 · 简化模式 · URL 深链 · 全状态记忆
- 🏠 学生首页降噪(新):徽标改「今天要做 N 项」· 我的进展四卡(今日完成/本周完成/连续学习/称号进度)· 考试提醒收敛 · AI 学伴单条 · 390/320 移动端达标
- 🖥 本地模型引擎(新):Ollama 接入 · 云端/混合/本地三档 · 模型清单实时加载与驻留信息 · 对话引擎徽章 · 能力矩阵与分级提示 · 友好报错
- 🧠 双引擎语义:混合=本地生成+云端知识库检索 · 本地=完全离线(云端检索/预热旁路、本地题库兜底)· 云端档原样直通
- 🧩 配置页重构:云端/本地模型小节 · 云端服务归属标注(知识库/TTS/ASR/生图)· 指引默认折叠 · 进页自动探活
- 📊 教学简报(新):周/月/年成稿 · 九板块结论与建议 · 表扬称号注册表 · 自动生成默认全关、系统配置统一开关 · 定时巡检与站内提醒 · 管理员按教师筛选 · 移动端只读转发
- 👥 批量导入提速:哈希出事务并行 · 相同初始密码只哈希一次 · 几千行秒级 · 分批提交中断保留 · 错误按原因汇总
- 🗂 日志轮转配置:按大小/按天/按天+大小三档 · 保留天数与份数可配 · 新增「日志与归档」小节 · 保存即生效
- 🔌 部署端口可配置:环境变量SMARTKB_PORT统一桌面版 / 开发代理 / 后端 / 打包检查口径 · 默认8086不变
- 🧮 公式导出升级:试卷/答案卷/讲义 Word 嵌入 Word 原生公式(OMML) · 中文公式、方程组、分段函数正常输出 · 缺依赖自动降级图片/Unicode · 填空下划线修复
- 🛡 稳定与隐私:升级后存量行为不变 · 完全离线可用,不联网也不影响功能 · 学生数据不出校
- 🧭 课程中心排序与回收站(新):学科拖动排序(仅管理员,全校生效)· 课程拖动(含跨学科移动)· 回收站视图(还原 / 彻底删除)
- 🛡 主数据保护(新):有课程的学科不可删除改名 · 默认题型不可改删 · 自定义题型按在用题目引用保护 · 默认学科按任教学科推断
> - ⚠️ 破坏性变更:无
> 🔄 本次升级须知:桌面版直接覆盖安装(数据不丢);启用本地引擎需自行安装 Ollama 并在「系统配置 → AI 能力」切换模式;如需换端口,设置系统环境变量 SMARTKB_PORT 后重启(桌面版与源码部署后端同一口径);Git 部署站内增量升级照旧。
项目简介
SmartKBS 把备课出题、课堂互动、练习考试、学情分析、荣誉激励和系统运维收敛在同一套账号体系与数据链路里,供一所学校、一个教研组或一位任课老师直接使用,无需拼装多个工具。
系统不限定学科。学科清单、年级、班级、题型、称号、AI 模型与提示词模板全部来自配置(backend/system_config.json 与数据库主数据表),切换课程体系只改配置、不改代码;学科的显示顺序可在课程中心左侧栏直接拖动(仅管理员,全校生效)。平台自身就是从「人工智能」一门课起步、再泛化为多学科通用版式,因此「零学科硬编码」是落地结论而非宣传语。
系统内置小学、初中、高中三个学段的年级与班级主数据(一年级 ~ 高三,共 12 个预置年级),教师可持有「高一|高二」这样的多年级任教范围,所有数据读写按任教范围收口。课程本身同样可以面向多个年级(高一|高二),练习提交与资源共享按年级交集放行。幼儿与高校场景没有内置学段规则,需自行扩展年级主数据。
AI 能力经统一调用服务接入,支持三种模式,并按优先级自动接管、逐级降级:
- 知识库检索增强(RAG) — 知识库就绪时接管整条 AI 链路:先检索(百炼知识库,或本地题库与课程大纲),再基于命中文本生成,界面标注引用来源;检索失败自动降级到下一级
- 百炼智能体应用 — 直接调用配置好的智能体应用
- 直接调用大模型 — 兜底路径,兼容 DashScope 与 DeepSeek
对话与附件同寿命:提问里上传的图片和文档会跟着对话一起入档,重开历史仍能看原图、下载原件;附件只对本人可见,容量与无引用回收由系统配置统一管理。
📦 三种部署方式:Windows 桌面版一键安装(零环境,不需要 Python / Node.js)· 源码包部署 · Git 克隆部署(支持在线增量升级)。详见部署安装指引。
核心设计理念
- 🧠 AI 原生,但题库优先
- 🎯 因材施教 · 千人千面
- 🔄 教学闭环 · 数据飞轮
- ⚡ 按需调用,无人使用零消耗
产品特性
| 特性 | 落地方式 | | --- | --- | | 👥 三层角色,各配其 AI | 学生用 AI 学伴陪伴式学习,教师用 AI 助手减负增效,管理员掌握配置与督导,互不干扰 | | 🏆 游戏化激励 | 12 级称号 + 成就徽章 + 自动积分奖励引擎,把外部压力换成持续正反馈 | | 🌐 配置驱动 · 学科无关 | 换学科只改配置与提示词模板,无需修改代码 | | 🔒 本地化优先 | 双 SQLite 库 + 本地目录存数据,可完全离线部署;AI 走国内可达通道,pip 有镜像方案,学生数据不出校 | | 📱 零安装多端 | 手机浏览器直接访问,无需 App、无需额外部署 | | 🖥️ 桌面版一键装 | Electron 壳 + 内置后端与前端产物,目标机器不需要 Python / Node.js | | ⬆️ 在线增量升级 | Git 部署可站内完成拉取、迁移、依赖安装、重启,失败自动回滚 |
演示环境
| 用途 | 地址 | | --- | --- | | 开发环境 | http://youufis.oicp.net:8086 | | 部署环境 | http://183.239.51.37:8086 |
测试账号
| 角色 | 用户名 | 密码 |
| --- | --- | --- |
| 教师 | youufis | ultraultra |
| 学生 | s11001 ~ s11009 | 123456 |
| 学生 | s18001 ~ s19009 | 123456 |
⚠️ 共享演示环境:所有访客共用同一个数据库,里面是测试数据,且他人可见你的操作痕迹。请勿填入真实学生姓名、真实成绩或学校涉密资料。
功能总览
六章各对应一条主线,前言里的六行与本表逐条对应(🏠 入口是跨主线的聚合层):
| 主线 | 章 | 覆盖的分区 | 数量 | | --- | --- | --- | :---: | | 🏠 入口 | 首页与待办 | 智能仪表盘、学生待办清单 | 2 | | 🧑🏫 教 | 教学与资源 | 课程大纲(学科与课程拖动排序)、AI 讲演、AI 播客、AI 教学助手、试题管理与标签维护(含回收站)、考试发布、智能组卷与 Word 导出、AI 教学资源推荐、AI 生成 HTML 资源、资源中心、资源管理、文件中心 | 12 | | 🎓 学 | 学习与练习 | AI 对话、AI 学伴、探索画布、课程练习、同步练习、错题巩固、每日精选与热点新闻、编程实践 | 8 | | 🎪 练 | 课堂活动 | 课堂互动工具(随堂测验、投票、提问)、课堂抽问、课堂闯关、知识抢答、分组讨论、协作白板、考勤与点名、作业中心(对话/文件)、知识闯关 | 9 | | 📊 评 | 学情分析与激励 | AI 学情分析、AI 课堂总结、教学简报、进度详情、活动监控、资源浏览统计、数据导出、积分奖励、课堂积分、荣耀殿堂、成长档案、我的画像 | 12 | | ⚙️ 管 | 系统管理 | 用户管理、系统公告、系统配置(云/本地双引擎)、技能管理、通知中心、在线升级、关于系统、其他系统服务 | 8 |
各节末尾的 权限提示(如「所有用户可用」)标出该功能的可访问角色;完整的角色矩阵见权限总览。
手机访问
平台可直接用手机浏览器访问,无需安装 App。手机端定位是「学生练与查、教师看与批」,管理型重页面保持电脑端专属。
手机已开放的页面
| 角色 | 数量 | 页面 | | --- | --- | --- | | 学生 | 28 | 首页、AI 学伴、错题巩固、每日精选、热点新闻、通知中心、系统公告、课堂提问、知识抢答、待办清单、作业中心、积分称号、考试与成绩、我的画像、学伴设置、知识闯关、同步练习、课堂互动、课堂投票、分组讨论与讨论室、文件中心、成长档案、风采展示、我的资源、资源中心、探索画布、关于系统 | | 教师 / 管理员 | 24 | 首页、教学简报(只读)、AI 助手、通知中心、系统公告、提问管理、AI 课堂总结、学情分析、作业批改确认、课堂积分、我的画像、分组讨论与讨论监控、闯关记录查看、汇总统计导出、文件中心、成长档案、风采展示、我的资源、资源中心、资源管理、探索画布、关于系统 |
手机端怎么用
- 底部标签栏固定 5 格:首页 / 学伴(教师为助手)/ 错题(教师为提问)/ 通知 / 菜单,「菜单」打开当前角色全部可用功能
- 未适配的功能在手机端不显示入口;直接输入地址会看到「此功能请在电脑端使用」,可一键返回上一页
- 考试作答、抢答答题、闯关战斗是独立全屏页,选项按钮按触屏放大,倒计时与进度常驻顶部
- 列表类数据(通知、公告、考试、抢答记录、作业、资源)在窄屏自动改为卡片或可横向滚动,标题不会被压成竖排
保持电脑端专属
试题管理与智能组卷、题库维护、用户管理、系统配置、点名管理、课堂抽问、课堂闯关、AI 播客生成、AI 讲演生成、活动监控、汇总导出、课程大纲维护、知识闯关管理、代码练习、协作白板、管理控制台
首页与待办
登录后的第一眼:按角色聚合的智能仪表盘与学生待办,是五条主线的统一入口。
系统首页(仪表盘)
登录后默认进入智能首页仪表盘,按角色聚合展示关键数据;支持手动刷新与「更新于」提示、回前台自动核对、首载骨架屏:
学生端:
- 📋 待完成考试数、已完成考试数
- 🏆 累计课堂积分与班级排名
- ✅ 活跃任务数与本周对话次数
- 📝 待答随堂测验数、已参与投票数
- 📅 待参加的考试列表(一键开始)
- 📈 近期考试成绩(得分/是否通过)
- 📢 系统公告滚动展示
- ⏱️ 最近活动动态时间线
- 🚀 快速入口(知识问答/考试中心/积分/互动)
- 📊 考试概览(总数/草稿/已发布/已结束)
- 📋 任务提交总数与活跃任务数
- 👥 学生总数、教师总数、任教学科
- 🎯 本周点名次数
- 📝 随堂测验总数与进行中数量
- 📊 活跃投票数与回应人数
- 💬 今日对话数
- 🚀 快速入口(AI 对话/考试发布/点名/用户管理/互动)
所有登录用户可用
待办事项(学生任务聚合)
学生端专属任务聚合看板:
- 🎒 多维筛选:状态 chips / 分类 / 类型 / 教师 / 学科课程(两级)/ 截止窗 / 资源形态 / 关键词,维度间 AND、勾选即生效
- 🗂 多视图:分组清单(状态/类型/教师/课程分组轴)+ 截止日时间线 + 紧凑密度;内联筛选面板默认收起、开合与勾选全记忆
- 🧘 简化模式(默认开):只列逾期+3 天内截止+课堂进行中,长尾收成一行;首页同口径「今天要做 N 项」
- 🔗 URL 深链(?f_teacher=…&view=timeline&simple=0…)优先于个人记忆且不回写;筛空与真空态分离
- ⚡ 今日聚焦常驻;live 脉冲徽标;失败可重试;回前台自动核对;已完成回看(近 30 天、成绩语义色)
学生可用
教学与资源
教师侧从备课到资源沉淀的完整链路:课程大纲、AI 讲演、出题组卷、考试发布、AI 生成与共享资源。
课程大纲(课程导学)
学科 → 课程 → 章 → 节 → 知识点五级树形结构:
术语口径:学科=系统配置里的SUBJECTS(信息科技、通用技术、人工智能、物理…),是题库与课程资源的归属依据;课程=courses表的一门开课(教材册别或校本开课,如《数据与计算》《技术与设计1》)。两者是上下级,不可混用。
- 🤖 AI 智能生成:粘贴文本或上传文件(txt/md/pdf/docx),AI 自动提取课程结构
- ✏️ 手动管理:添加、编辑、删除课程/章节/知识点
- 🔀 拖拽排序:同级和跨层级拖拽排序,灵活组织
- 🧭 学科顺序:侧栏学科分组可拖动排序(仅管理员,学生端同步跟随);课程顺序按任教范围放开给教师
- 🔗 资源绑定:为知识点绑定 7 类资源(HTML 课件、下载文件、试题、考试、讨论、随堂测验、任务)
- ✅ 学习进度追踪:学生逐知识点学习,标记完成状态,实时进度条
- 📊 课程进度总览(教师):全班学生知识点完成进度矩阵,按年级/班级筛选
- 🏋️ 课程练习:教师一键为知识点生成 10 道单选题,学生在线作答
- 🖥 视野三档:专注(收起顶栏与导航)/ 分栏 / 非模态浮层,按内容区宽度自动切换;知识点可「上一个 / 下一个」连续过
- 🎯 多年级课程:一门课程可同时面向多个年级,年级分隔符全站统一解析
- 🚪 停用即下架:课程停用后学生端所有入口一律关闭,教师与管理员仍可进入恢复或彻底删除
管理员/教师可管理;学生可查看并标记进度
教学助手(教师/管理员专属)
为教师和管理员提供的 AI 教学工具型助手:
- 📝 智能备课:根据课题自动生成完整教案(教学目标、教学过程、课堂活动、作业设计)
- 📄 自动出卷:按知识点/题型/难度生成试卷和随堂测验
- 📊 学情分析:分析班级或学生个人成绩数据,指出薄弱点和进步空间
- 🎯 活动策划:设计课堂互动方案(小组讨论、抢答、随堂测验等)
- 📋 教学数据侧栏:实时显示学生人数、考试统计、提交任务、课堂互动等教学概览
- 🎨 视觉差异化:青绿助手风格气泡与头像
教师/管理员可用(智答页面顶部切换)
试题管理(智能题库)
AI 智能试题管理系统,支持多种题型和多媒体:
- 🤖 AI 一键生成:按学科、题型、知识点、难度和数量自动生成试题
- 📤 智能提取:支持粘贴文本或上传 .docx/JSON 文件,自动识别题型、选项和答案
- 🧱 入库统一出口:AI 出题、智能提取与各练习 / 测验补题都走同一道关口(体检 → 查重 → 事务 → 连知识点边),不合格与重复的题不再进库。同一道题只有一条写入路径,判分、查重、选题口径从源头对齐
- 📋 题型支持:默认题型(单选/多选/判断/简答/填空/作文/主观)不可改删;自定义题型按配置启用,有在用题目时不可改删
- 📐 公式支持:全面支持 LaTeX 公式($...$)渲染显示
- 🖼️ 配图系统:
- 📂 题库管理:分类筛选、搜索、编辑、删除;支持多选批量删除(与单删同规则:非本人创建、被考试 / 同步练习引用的自动跳过并逐条说明,单次上限 500)
- 🗑 回收站:删除的题目在回收站视图可还原回题库(配图与知识点关联一并恢复),或彻底删除(删除前给出清单,说明会一并清理什么、哪些删不掉)
- 🏷️ 标签维护:按「标注状态」只看未标注的题(列表 / 统计 / 顶部角标同一口径),配合 AI 补标与知识点挂接治理题库
- 📐 列表紧凑:固定表格布局,列宽按实测数据分配 —— 题干列拿满剩余宽度,配图缩略图收小,行高约省三成
- 🔄 AI 生图:自动为主观题 SVG/图片占位符生成配图
管理员和教师可用
考试发布(在线考试系统)
完整的在线考试管理系统:
- ⚙️ 创建配置:标题、学科、时长、总分、及格分、题目/选项乱序、答题次数、时间范围
- 📋 组卷方式:
- 📋 考试流程:发布 → 学生在线答题(实时倒计时) → 客观题自动批改 → 成绩查看
- 📊 成绩统计:得分/总分/百分比/是否通过/排名
- 📤 数据导出:成绩导出为 Excel
- 🧑🏫 AI 讲评:整场考试分析报告、全班错因讲评(挑错误率最高的题给典型错答/错因/讲法/跟进练习)、学生本人错题讲解,均可导出 Word 并附每题正确率
- 🛡️ 考场防护:可开启题目防复制与作答页个人水印(默认关,系统配置里两个独立开关)
- 🔔 消息通知:发布/取消/修改/提前结束时自动通知
管理员/教师可创建管理;学生可参加已发布的考试
智能组卷 & Word 导出
分步引导式组卷向导,支持智能选题与专业文档导出:
- 📋 配置向导:题型题量配置、难度分布、知识点范围筛选
- 🤖 AI 智能选题:按知识点智能匹配
- 🔌 缺口补差:默认只报缺口;勾选后题库不足的部分由 AI 出题补齐并入库
- 📊 规则选题:按难度比例随机抽取
- 📊 组卷统计面板:实时题型/难度分布、总分,支持手动移除题目
- 📄 Word 导出(三份文档,正文/标题字体跟随系统配置):
- 📐 LaTeX 公式渲染:Word 原生公式(OMML)嵌入、可双击编辑;中文公式与方程组/分段函数正常;缺依赖自动降级 matplotlib 图片 / Unicode 文本
- 🖼️ SVG 自动转 PNG:确保 Word 兼容性
- 📦 题型排序:单选题 → 多选题 → 判断题 → 填空题 → 简答题 → 作文 → 主观题
管理员和教师可用
AI 教学资源推荐
根据知识点内容智能推荐教学资源:
- 🔍 智能分析:AI 分析知识点内容自动推荐关联资源
- 📋 推荐类型:HTML 课件、考试试卷、课堂讨论、随堂测验、任务
- 🔗 一键绑定:推荐资源可直接绑定到知识点
- 📄 AI 生成课件:AI 可根据知识点自动生成完整 HTML 课件
管理员和教师可用
AI 播客(双主播对话)
为知识点一键生成可以听的 HTML 播客页面:
- 🎧 双主播对话体:主讲(默认男声)+ 互动(默认女声),音色可在系统配置里换;留空则按当前合成模型自动挑一男一女
- 🎚 时长可选:3 / 4 / 5 分钟,默认 3 分钟;稿子字数按档位给(对话体约 250 字/分钟)
- 🧠 两种话题来源:AI 依当前知识点给一批候选话题(可换一批),也可手动输入
- 📄 内容是稿子、页面是模板:AI 只写结构化脚本,播放器页面由后端渲染——分段合成、顺序播放、对话文稿按角色高亮(点文稿可跳到那一段)
- ⏱ 时长算得准:按音频字节数换算秒数,超出上限就截断并在页面标注,不产出超标页面
- 🎨 4 套主题:暗夜紫 / 明亮白 / 护眼米 / 深海蓝,生成时可选,读者还能在页面右上角自己切
- ♻️ 省算力:同一段台词跨播客复用(内容寻址缓存);同一知识点他人已生成过则只读复用
- 📎 落地即资源:生成的页面进「我的资源」,绑定到知识点后学生可直接打开收听(手机浏览器也能听)
- 🔒 与点名播报同一个总闸:系统配置关掉语音合成,AI 播客一并停用(零计费)
管理员和教师可用(需管理员开启语音合成)
AI 讲演(分页讲解 + 逐句语音)
把一个知识点讲成一节能看也能听的微课:画面按页推进,语音逐句播放,字幕跟着走。不做视频文件,所以改一句只重录一句。
- 🎬 播完一句才翻页:一句台词一段音频,音频结束才翻页,不会"话没说完画面就变";字幕按句高亮,上一句淡出
- 🎙️ 两种讲法可切:双主播对话(学生自学,一问一答带节奏)/ 单主讲(教师投屏,不与老师抢话);同一知识点两版并存,按场景自动选
- 📐 公式与图示按需生成:出现主公式、步骤、数量对比、分类关系时,自动配公式页或流程图 / 条形图 / 分类树;纯叙述的页不加图,整节最多两图
- 🖥️ 课堂放映:全屏演示,空格暂停、方向键翻页、数字键跳页;演讲者视图把下一页预览与逐字稿放到老师自己的屏幕上
- 🎨 四套画面主题:清晰白 / 暖米 / 深墨 / 淡青,深墨专供暗光教室,只影响画面不改变整站外观
- ⏱ 三档时长:3 / 4 / 5 分钟(与播客同档),默认 5 分钟;超时长按整页截断,不切半页
- ✏️ 大纲可改、单页重录:逐句改台词、切说话人、调页序、删页;只改一页时只重合成那一页
- 💾 断点续播:关掉再进来,从第几页第几句继续;看完 80% 的页即记为学完
- 🔒 与播客共用语音总闸:总闸关闭时不能生成,但已生成的讲演仍能正常播放,不牵连正在学的学生
管理员和教师可生成;学生可观看(需管理员开启语音合成)
AI 生成 HTML 资源
在资源中心直接使用 AI 生成 HTML 教学资源:
- 📄 5 种资源类型:
- 🎭 主题选择:每种类型提供多套预设主题
- 📚 题库 + AI 混合出题:自动匹配题库题目,不足由 AI 补充;题目数量可在生成前指定
- 💾 AI 新题自动入库:AI 生成的题目自动保存到题库
- 🔗 学科/年级智能关联:根据学科和年级获取对应题库
实验交互资源详情
覆盖 9 大学科分类:
- 🔬 算法与编程:排序/搜索可视化、数据结构、编译原理
- 📐 数学:函数曲线调参、几何证明、概率统计、微积分
- ⚡ 物理:力学仿真、电路模拟、光学实验、热力学循环
- 🧪 化学:分子结构、化学反应、元素周期表、滴定实验
- 🧬 生物:细胞结构、DNA 复制、生态系统、遗传杂交
- 🌍 地理与天文:地图投影、气候模拟、太阳系模型、板块运动
- 🏛️ 人文与社会:历史年表、经济模型、语法分析、配色实验
- 🤖 人工智能:CNN 可视化、图像分类、Transformer 注意力机制
- 🎯 通用交互:拖拽点击、图表联动、自定义仿真
配图增强:AI 自动规划并生成 SVG 教育示意图 + 通义万相实景配图
管理员和教师可用
资源中心(共享中心)
以卡片网格展示 HTML 教学资源文件:
- 👁️ 卡片浏览:缩略图 + 文件名称
- 🔗 共享操作:
- 🔍 搜索筛选:按文件名搜索
- 🗂️ 统一浏览器:学生端「共享资源」、教师端「共享给我的」与学生端「共享文件」共用同一套浏览界面(未看·时间·类型·课程·共享者·范围六维分类 + 网格/列表双视图 + 偏好记忆)
- 🔗 直达定位:任务清单与共享通知点进去直接落到对应标签页,不会先跳回默认页再让人自己找
- 🤖 AI 生成:5 种资源类型(动画讲解、互动答题、章节练习、实验互动、自定义 HTML)
- 👁️ 资源浏览统计:自动记录学生查看行为
- 🖥️ 预览窗口:满幅贴边/拖移/缩放/全屏,尺寸位置记忆;内容源隔离、离线秒开(互动课件班级/点名可用)
所有登录用户可用;学生仅查看共享资源
资源管理
上传/删除/重命名教学资源文件:
- 📤 上传文件、目录(HTML/CSS/JS/图片/文档等)
- 🗑️ 删除与重命名
- 📁 每位教师拥有独立资源目录
- 🔗 文件共享操作(同资源中心共享)
- 📊 配额管理
管理员和教师可用
文件中心
下载目录文件管理:
- 📤 上传 / 📥 下载 / 🗑️ 删除
- 📊 空间配额(按人上限,管理员不受限;系统配置「文件中心空间」里调整)
- 📁 子目录支持
- 🔗 目录共享(整个目录自动继承权限;接收方显示为「文件夹」条目,内含文件数与总大小一目了然)
- 🗂️ 统一资源浏览器:与「共享资源」共用分类侧栏 / 统计条 / 网格·列表双视图 / 搜索排序分页与偏好记忆
- 👁️ 学生可查看共享文件,并记录未看·已看与浏览量(首次浏览奖励 1 分)
管理员和教师可用;学生可查看共享文件
学习与练习
学生侧的听课与练笔:AI 讲演(看课)、知识问答、AI 学伴、知识点练习与定向练习、错题巩固、视野拓展与编程实践。
AI 对话(知识问答)
核心智能问答界面,基于 SSE 流式传输,提供流畅的 AI 对话体验:
- ⚡ 流式对话:AI 实时逐字输出回复,即时反馈
- 📎 文件上传:支持图片(JPG/PNG/GIF)和文档(PDF/Word/Excel/PPT/TXT/MD 等),发送后与对话一起入档,历史里仍可看原图、下载原件
- 👁️ 图像理解:上传图片由对话模型先看图(快、省),解题类(题干 / 公式 / 手写)自动切视觉模型
- 🖼️ 多模态对话:对话模型需支持图片输入,图片与文字可同时提问,无需先做文件摘要
- 📄 文件摘要增强:自动对上传文档进行摘要,增强 AI 对话上下文
- 🔍 RAG 知识增强:从试题库和课程大纲中检索相关知识,提升回答准确性
- 📜 历史记录:桌面端常驻侧栏(推挤不遮挡),自动保存后即时出现;今天 / 昨天默认展开、跨年分年;单击只预览不覆盖当前对话,支持标题与正文搜索、重命名与下载;预览按正文排版渲染表格与公式
- 👁️ HTML 预览:对话中 HTML 代码块可一键预览
- 📋 示例提示词:内置多个教学场景示例,一键填充
- 🎭 三种模式:智答模式 / 学伴模式(学生)/ 助手模式(教师/管理员)
- 🎤 语音输入:支持麦克风语音转文字输入
- 📷 拍照上传:支持摄像头拍照直接上传
所有登录用户可用
AI 学伴(学生专属)
AI 对话的智能升级模式,为学生提供个性化的学习陪伴体验:
- 👤 专属学习伙伴:AI 学伴知道学生的姓名、年级、学习进度和薄弱知识点
- 🔄 三种人格切换:
- 📊 学习画像侧栏:实时显示称号、积分、薄弱知识点、考试趋势、连续学习天数
- 🔔 主动推送:早安问候、考试结果分析、称号升级祝贺、学习提醒
- 💾 对话历史统一管理:与智答模式共用聊天历史系统
- ⚙️ 自定义设置:可自定义学伴名称、人格、开关学伴、每日唤醒时间
- 🎨 视觉差异化:紫色学伴风格气泡与头像
学生可用(智答页面顶部切换)
探索画布(AI 伴随式无限画布)
师生共用的个人无限画布:自由提问、自由学习、自由探索、自由涂鸦。品牌统一,预置画布按角色区分——学生进入看到「我的问题堆 / 涂鸦台 / 探索笔记」,教师看到「备课灵感 / 素材工坊 / 自我修炼」,白板课堂与个人创作各司其职。
- 🧭 画布墙与多页画布:自动保存、页码按现存顺序连续显示、页面回收站(删页 30 天可还原)、一键清除(先存档)、一键整理布局;搜索直达命中页
- 🖼️ 时间线与成长档案:每 30 分钟自动留档并附线框缩略图,点「回到这一刻」即可换回;「存入档案」的作品在画布墙「我的档案」里查看 / 下载 / 回跳,同日重复自动合并
- 💬 AI 伴随悬浮窗:问答(带教材来源标签)、生图(SVG 图示优先)、朗读、语音输入、拍照贴图;侧栏 / 可拖动弹出大窗 / 移动抽屉三形态,弹出时工具栏自动让位
- 🖍️ 笔画圈智能提取:用画笔圈住内容,圈内文字自动填入输入框,提问只带圈住的部分;点即填、不用重打
- 🃏 提问卡:回答沉淀到画布,卡上追问 / 朗读 / 复制 / 定位,整页导出与归档不丢文字
- 🌌 结构化落画布:思维导图与知识星图直接铺开,圈住任何一块继续问
- 🤝 学生授权分享:一键生成只读快照给任课教师;教师列表缩略图直览、悬停大图、搜索分页;到期自动回收,学生随时收回
- 📐 模板共享库:内置 3 个系统范例(问题收集墙 / 探究笔记 / 课堂板书起步页)开箱可用;教师也可把自己的起步页发布为模板,师生一键复制为自己的新画布
- 🎖️ 弱积分 + 强荣誉:首问、深挖链、归档计探索分,5 枚徽章;不计考核、不排名,徽章只在自己名下发,荣誉展示跟随荣耀殿堂既有规则(按总分门槛自动建卡,无需审核)
- 🔒 安全护栏:每日问答 / 生图 / 朗读配额系统配置可调,管理员不限但照常记账。涉自伤 / 轻生 / 伤人 / 极度绝望的表达(问答、圈选资料、最近几轮对话都参与判定)一律改用固定关怀话术应答并附 12355 热线,同时给管理员推零原文提醒(只带学生身份与次数);模型从语气判断出的隐晦风险也会回传标记,一并入账。台账只存提问哈希,不保留原文;教师/管理员问「自杀率」这类教学话题不拦。
- 🗂️ 素材账本:上传、生成图、录音全入册;引用续命、孤儿自动回收(每日定时执行,不设手动清理入口)、回收站可还原;管理端「系统配置 → 探索画布 → 素材存储」可看容量水位、回收站与每日清理清单
- 📊 使用统计:并入活动监控,年级 → 班级两级筛选;只计行为计数,不看提问与画布内容
所有用户可用(画布默认仅本人可见,分享需学生主动授权)
课程练习(知识点练习)
基于课程大纲知识点的 AI 练习系统:
- 🤖 AI 自动出题:教师为知识点一键生成 10 道单选题
- ✍️ 学生在线作答:在课程学习页面点击知识点直接练习
- 🏆 自动积分奖励:
- 📊 数据展示:首页看板展示完成数与平均正确率
- 📋 成长档案集成:个人档案页集成练习明细
管理员/教师可出题;学生可参与练习
同步练习(AI 定向出题)
教师从错题本或知识点生成针对性练习题,推送至班级或指定学生:
- 🤖 AI 出题:从错题本或知识点自动生成针对性练习题
- 📤 定向推送:推送至班级或指定学生
- ✍️ 学生作答:在线答题,支持选择题和简答题
- 🤖 AI 自动批改:简答题自动批阅
- ⚡ 异步出题:不阻塞界面,支持后台生成
- 📊 练习记录:历史练习查看与成绩统计
- 📄 AI 学情分析导出:分析结果可存 Word,附完成概览与每题正确率
- 🛡️ 考场防护:作答页支持题目防复制与个人水印(系统配置开关,默认关)
管理员/教师可出题;学生可参与
错题巩固
自动归集学生错题,AI 辅助复习:
- 📋 错题归集:按考试归类展示错题
- ✅ 自主标记已掌握:每道题可标为「已掌握」也随时取消,配合待掌握/已掌握/全部三档筛选,学生自己决定还要不要继续练
- 📐 多媒体展示:支持 LaTeX 公式和配图显示
- 🤖 AI 复习计划:一键生成个性化复习报告(错题分析、知识点复习建议、针对性练习题)
- 👁️ 三级联动查看(教师):按年级 → 班级 → 学生逐级筛选
- 📊 错题统计:各科错题数和正确率
学生查看自己;教师/管理员可查看全班学生
每日精选 & 热点新闻
知识拓展双模块,让学生在学习之余轻松拓宽视野:
- 📖 每日精选:AI 趣味知识卡片池,每人随机抽取 6 张,
- 📰 热点新闻:RSS 聚合多个主流新闻源(中新网、IT之家等),
所有用户可用
编程实践(代码练习)
在线编程练习与自动评分系统:
- 教师端:
- 学生端:
- 🤖 自动评分引擎:
- 🔒 安全沙箱:
所有登录用户可用
课堂活动
一节 40 分钟课里的实时互动与组织工具:测验、投票、提问、抽问、抢答、讨论、白板、点名、闯关与作业中心。
课堂互动工具
随堂测验
课堂即时测验系统:
- ✏️ 可视化编辑器创建(单选/多选/判断)
- 🤖 AI 一键生成(指定主题/题型/数量):题库优先,缺口由 AI 补题并入库复用
- 📊 自动评分与结果统计
- 📐 支持 LaTeX 公式和配图
- 📤 数据导出(成绩 CSV)
- 📄 AI 答题分析可导出 Word,附每题正确率与错选分布
- 🛡️ 考场防护:作答页题目防复制与个人水印(系统配置开关,默认关)
课堂投票
课堂即时投票系统:
- 📋 单选/多选模式
- 🤖 AI 自动生成投票主题
- 📊 实时柱状图统计结果
- 👥 参与人数实时显示
提问管理
学生提问与教师审批一体化管理:
- 🙋 学生提问:学生发起提问(支持匿名)
- 🤖 AI 辅助回答:AI 自动生成建议回答,教师可修改后发布
- 👨🏫 教师回答:教师直接回答或审批通过学生的回答
- ✅ 审批机制:教师可标记学生回答为「已通过」或「未通过」
- 🔒 权限控制:仅本班学生和教师可见
学生可提问;教师可管理回答与审批
知识抢答活动
实时多人在线抢答竞赛系统:
- 教师端:
- 学生端:
- 计分规则:
- 📊 活动回顾:排行榜、每题正确率统计
管理员/教师可创建管理;学生可参与抢答
分组讨论(AI 助教)
AI 助教辅助的课堂分组讨论系统:
- 创建讨论:
- 参与讨论:
- 讨论管理:
- 📊 总结报告:关键观点、AI 评价、小组评分
管理员/教师可创建管理;学生可参与本班讨论
协作白板(AI 白板助手)
基于 TLDraw 的实时协作白板系统,内置 AI 白板助手侧栏:
- 两种课堂模式:
- 🔗 房间系统:教师创建房间(支持班级/课程/临时类型),学生输入 6 位房间码加入
- 👥 实时成员管理:在线成员列表,显示当前在线的学生
- 🎨 白板工具:画笔、形状(矩形/椭圆/菱形/箭头)、文本、便签、图片、激光笔
- 📄 多页面支持:支持多页白板,缩略图导航
- 🤖 AI 白板助手(教师专属):
管理员/教师可创建管理;学生可参与
考勤与点名管理
智能点名 + 考勤统计一体化管理:
- 🎲 权重随机点名:动态权重、抽中衰减、覆盖 60% 开新一轮;按班级 + 学号记账,
- 🧾 抽人记录:跨活动一条时间线,可按活动与班级筛选,含按活动统计、被抽最多、Excel 导出、重置本轮
- 🗣 点名语音播报:点到谁就念出谁的姓名(多音姓氏自动校正读法),由管理员在系统配置中启用
- ✅ 点名记录:标记正确/错误,查看历史记录与统计
- 📊 点名统计:按人统计被点次数与正确率
- 📝 考勤记录:自动记录每次登录的时间、IP、浏览器信息
- 📅 历史追踪:完整的历史登录记录
- 👁️ 权限控制:教师仅查看本班,管理员可查看全部
管理员/教师可用
课堂抽问
课前热身与课中提问用的「抽题 → 抽人 → 作答」大屏互动,可一直循环:
- 🎲 两种出题来源:按课程知识点(下拉可搜索)或手动输入知识点,从题库抽题;题型限单选题与判断题
- 🤖 AI 生题开关:开启后题库优先,题库没有才让 AI 现场出题,生成的题自动入库——下节课抽同一知识点就直接命中;管理员可在系统配置关掉全校总闸(关掉即零 AI 计费)
- 👤 公平抽人:与智能点名共用同一份班级权重,抽中即计入「抽人记录」,支持语音念名
- ✍️ 点选作答:学生在屏幕上点选项,提交后由服务端判定对错,并自动公布答案与解析
- 🏆 即时计分:答对 +5、答错 +2、跳过 0,分数进现有课堂积分,教师可在积分管理查看
- ♻️ 可一直循环:换一名学生自动清空上一轮的选择与答案,课前热身、课中提问都能一直抽下去
- ⌨️ 键盘可用:
空格抽人、1-4选答案、回车提交、0跳过、N下一题 - 🖥 大屏投屏用:学生不用自己的设备;手机端会给「请用电脑端」的引导
教师/管理员可用(教师限本人任教班级)
课堂闯关(大屏版)
教师投屏用的单人阶梯闯关,一节课可以一直开下去:
- 🎯 15 关阶梯:第 1 关 10 分 → 第 15 关 50 分(满分 415),逐关累加;第 5 / 10 关为安全关,口径为「答错保留已累计分、不倒扣」
- 🎲 出题:选学科即可开始(知识点可选、也可手输);题库优先、按关卡难度(易 / 中 / 难)分层取题,缺口由 AI 补题并自动入库
- 👤 公平抽人:与点名 / 课堂抽问共用同一份班级权重,抽中后语音念名;"请军师"同样记入抽人记录
- 💡 三个锦囊(每人每局限用一次,可重复用在同一题上叠加折减):🎯 去伪存真(排除一个错项 ×0.85)、📞 远程连线(AI 提示 ×0.70)、👥 群策群力(模拟投票 ×0.70)
- 🧮 服务端判定:题面不下发答案;学生在屏幕上点选项,提交后由服务端判对错并自动公布答案与解析
- 🏆 自动奖励:结算即把「答对关数」写进课堂积分(与积分管理同源,教师可查),并给学生留一条做题记录
- 📊 本场红榜 + 结算动画:答错 / 超时全屏结算(含解析复盘与撒花),红榜与流水实时刷新,答完直接抽下一人开新局
- 🎨 7 套大屏皮肤:默认浅色「云白课堂」,另有暖阳米 / 薄荷清(浅)与星海紫金 / 赛博霓虹 / 学院蓝 / 复古金色(深)
... (README truncated for length)