🏫
一套平台搞定教学：从小学到高中 50+ 功能
SmartKBS 智慧教学平台：教·学·练·评·管一条龙，AI 对话/题库/考试/课堂互动/学情分析全都有，本地部署、不填 API Key 也能用基础功能
AGPL-3.0
本地部署
学科无关
📖 它是什么
SmartKBS（Gitee：youufis/SmartKBS）是一款面向小学、初中、高中三个学段的 AI 智慧教学平台，学科、年级、班级全部由配置驱动，不限定任何一门学科。它把备课出题、课堂互动、练习考试、学情分析、荣誉激励和系统运维收敛到同一套账号体系与数据链路，供一所学校、一个教研组或一位任课老师直接用，覆盖 教·学·练·评·管 五条主线、48 个功能分区、共 50+ 功能点。
平台基于 FastAPI + React 19 + TypeScript 构建，深度集成阿里云 DashScope（通义千问 / 通义万相）与 DeepSeek；SSE 流式输出与 WebSocket 实时链路支撑课堂并发，数据全部落在本地 SQLite 与本地目录，可完全离线部署。AI 能力按 RAG → 百炼智能体 → 直接调用大模型三种模式自动接管、逐级降级。部署方式灵活：Windows 桌面版一键安装（零环境，不需要 Python / Node.js）、源码包部署、Git 克隆部署（支持在线增量升级）。采用 AGPL-3.0 协议（校内直接部署不受限），当前版本 8.7.0，2026-09 建仓、至今仍在活跃更新。
📎 Gitee：gitee.com/youufis/SmartKBS ｜ 桌面安装包：github.com/youufis/SmartKBS/releases/latest ｜ 演示：youufis.oicp.net:8086
✨ 核心亮点
🧑🏫
教·学·练·评·管一条龙
备课出题、课堂互动、考试练习、学情分析、荣誉激励一个平台全包
🌐
学科无关、配置驱动
换学科只改配置与提示词，不改代码；内置小学到高三 12 个年级
🔒
本地化优先
双 SQLite + 本地目录，可完全离线部署，学生数据不出校
🖥️
桌面版一键装
Electron + 内置后端，目标机器不需要 Python / Node.js
🖥️ 环境要求
| 系统 | Windows x64（桌面版）；或任意可跑 Python 的服务器（源码包） |
| 运行环境 | 桌面版零依赖；源码包需 Python 3.11+，前端开发需 Node.js |
| 硬件 | 常规即可；数据全在本地，端口固定 8086 |
| 关键依赖 | 基础功能无需 API Key；AI 功能需 DashScope / DeepSeek Key（可选） |
| 接入端 | 手机浏览器直接访问，无需 App |
🚀 上手步骤
① 桌面版一键安装（零环境，最省事）
下载 SmartKBS-Setup-版本号.exe（约 120 MB，仅 Windows x64），双击按向导安装。启动后自动拉起内置后端，等 8086 就绪自动打开应用。本机访问 http://127.0.0.1:8086；同局域网学生访问 http://本机局域网IP:8086（首次请在防火墙弹窗选「允许访问」）。数据存在 %APPDATA%SmartKBS，卸载重装不丢。
② 源码包 / Git 部署（需 Python）
pip install -r requirements.txt
python backend/main.py后端默认运行在 http://localhost:8086 并自动托管前端产物。开发模式可用 python -m uvicorn backend.main:app --host 0.0.0.0 --port 8086 --reload。Git 部署还支持站内在线增量升级。
③ 用默认管理员登录
用户名 root ｜ 密码 root首次登录后请立即改密码并设置密保问题，避免默认凭据留在生产环境。
④ 配置 AI 服务（可选）+ 建班开用
进「系统配置」填 DashScope API Key（及可选 DeepSeek Key），配置页内置模型清单与连通性自检。不配置也能用题库、考试、点名、资源、积分等主流程功能。然后按教·学·练·评·管建班建课开用。
📊 关键速查
| 桌面版 | SmartKBS-Setup-版本号.exe，约 120 MB，Windows x64，端口 8086 |
| 源码部署 | pip install -r requirements.txt + python backend/main.py |
| 默认账号 | root / root（首次登录后请改） |
| AI | DashScope（通义千问/通义万相）/ DeepSeek；基础功能不填 Key 可用 |
| 协议 | AGPL-3.0；版本 8.7.0；Gitee 托管 |
🎯 典型玩法
🏫 整校部署：一套账号体系管全校班级、任教、学情与荣誉
🧑🏫 教师备课出题：AI 助手 + 智能题库，一键组卷导出 Word
🎪 课堂互动：抢答闯关、抽问、分组讨论、协作白板活跃课堂
📝 考试与练习：在线考试自动批改，错题巩固、同步练习
📊 学情分析：AI 分析 + 成长档案 + 12 级称号 + 积分激励
🔌 离线 / 私有化：本地 SQLite 全离线部署，学生数据不出校
📊 和同类做法比
| 通用 AI 聊天框教学 | 只对话、不落到题库/考试/课堂/学情，难以形成教学闭环 |
| 拼装多套工具 | 出题一套、考试一套、点名一套，账号与数据割裂、难维护 |
| 商业云教学平台 | 要付费、数据在云端、未必可离线、扩展受限 |
| SmartKBS | 教·学·练·评·管一条龙 + AI 原生，本地离线可私有化，学科配置驱动 |
原理一句话：学科、年级、班级、题型、称号、AI 模型与提示词全部来自配置而非硬编码，所以一套平台能通吃各学科；数据全落本地 SQLite，AI 调用按需触发（无人使用零消耗），并默认「题库优先 → 缺口交 AI → AI 生成的题入库留用」，把每次算力沉淀成可复用资产。
❓ 常见问题
Q：什么协议？部署受限制吗？
AGPL-3.0。可自由使用、修改、分发，校内直接部署不受限；若修改后通过网络对外提供服务，须以相同许可证公开修改源码；仅通过接口通信的自有系统不受此约束。
Q：一定要填 API Key 吗？
不需要。基础功能（题库、考试、点名、资源、积分等）不填 Key 就能用，仅 AI 相关入口会提示。想开 AI 对话/学伴/出题补差再去「系统配置」填 DashScope 或 DeepSeek Key。
Q：支持哪些学段和学科？
内置小学、初中、高中（一年级到高三共 12 个预置年级），学科不限——学科清单、年级、班级、题型全由配置驱动，换学科只改配置不改代码。
Q：需要装 Python / Node.js 吗？
用桌面版安装包不需要（Electron + 内置后端，双击即用）；用源码包部署需要 Python 3.11+，开发前端才需 Node.js。
Q：数据存在哪里？能离线吗？
核心业务在 backend/smartkb.db、试题在 backend/questions.db（SQLite），对话、资源、画像等存本地目录；数据全在本地，可完全离线部署。
Q：学生用什么访问？
手机浏览器直接访问 http://本机局域网IP:8086，无需 App、无需额外部署。
Q：怎么升级？
Git 部署：系统配置→版本管理→检测更新→增量升级（失败自动回滚）；源码包：下载新版 ZIP 覆盖并保留 system_config.json 与两个 .db；桌面版：下载新版安装包覆盖安装，数据在 %APPDATA%SmartKBS 不丢。
Q：有演示环境吗？
README 提供了在线演示环境（youufis.oicp.net:8086）可先行体验；生产部署建议用桌面版或源码包本地装。
📎 Gitee 搜索 youufis/SmartKBS
关注「AI工具匠」，获取更多 AI 工具实操教程