SolEdu

AI 驱动的 K12 教育自动化平台
组卷 · 题库 · 知识图谱 · 学情分析 · 智能助手

安装 · 本地编译 · 功能 · 路线图 · 贡献 · 许可证

---

简介

SolEdu 是一个面向 K12 教育的开源自动化平台，灵感来自光电子电子设计自动化（EPDA）的理念——通过标准化工具链和自动化流水线，将组卷、题库管理、知识图谱维护、学情分析等高度重复的教学事务，提升到工程级水准。

围绕教师核心工作流形成持续闭环：

备课 → 组卷 → 考试 → 分析 → 改进 → 备课

内置的 AI 智能助手贯穿各业务环节，将教师从重复事务中解放出来，回归教学设计与课堂互动。

功能概览

能力域	说明
试卷编译	ExamCompiler然您从题库选题、模板组卷，一键导出学生版/教师版 PDF，轻松、简单、高效、标准
题库管理	KnowledgeForge实现了题库 CRUD、标签筛选、导入/导出（YAML 与 ZIP 交换包），轻松与其他老师分享您的题库
知识图谱	AxiomGraph模块知识点关系可视化编辑，题目与知识点双向关联，为您的教学提供灵感
学情分析	EduAnalysis为考试结果提供了多维诊断（班级/学生/知识点），自定义脚本扩展
教育绘图	PrimeBrush提供声明式配置生成平面几何、函数图、统计图等高清矢量图
智能助手	内嵌AI助手Solaire，助您一键组卷、分析、图谱等全业务场景（需要API-KEY）

支持 Web 端 和 Windows 桌面端（基于 Tauri）。

版本说明

社区版（当前版本）

本仓库即社区版，以 AGPL-3.0 协议开源，包含上述全部核心功能模块。适用于：

• 个人教师独立使用
• 学校内部部署与二次开发
• 教育技术爱好者研究与贡献

商业版（未来计划）

面向学校和教育机构提供的商业授权版本，将在社区版基础上增加：

• 多用户与权限管理
• SaaS 云端部署与私有部署
• 官方题库与精品模板
• 企业级技术支持与 SLA 保障
• 闭源授权选项
• 其他高级功能

企业版相关信息将在后续公布，敬请关注。

安装

下载安装包

前往 GitHub Releases 下载最新版本：

平台	格式	说明
Windows	.msi	双击安装，开箱即用

其他平台支持正在规划中。

环境要求（本地运行源码）

• Python 3.11+
• Node.js 18+（前端开发）
• TeX 发行版（TeX Live 或 MiKTeX）— 导出 PDF 必需；latexmk 与 xelatex 需在 PATH 中
• 或使用 Docker（免装 TeX，推荐用于分发场景）

本地编译

1. 克隆仓库

git clone https://github.com/zijian-optics/SolaireEPDA
cd SolEdu

2. 安装后端依赖

pip install -e .

（会安装 pyproject.toml 中的全部主依赖，含教育绘图里的化学结构式渲染组件。）

3. 安装前端依赖

cd web
npm install
cd ..

4. 启动开发服务器

一键启动（推荐）：

平台	命令
Windows PowerShell	.\start-web.ps1
Windows CMD	start-web.bat
macOS / Linux	./start-web.sh

手动分步启动：

# 启动后端（终端 1）
python -m uvicorn solaire.web.app:app --host 127.0.0.1 --port 8000

# 启动前端（终端 2）
cd web && npm run dev

前端默认运行在 http://127.0.0.1:5173，API 请求自动代理到后端 8000 端口。

5. 桌面版构建

桌面版基于 Tauri，构建步骤详见 docs/desktop-build.md。

# Windows 一键构建
.\scripts\build.ps1

未来计划

• 扩展绘图：三维图形、物理绘图、化学晶格、地理等高线等（社区版规划）
• 证明验证器：形式化验证基础数学推理 （社区版规划）
• 教案与课件：从教学目标自动生成教案与课堂素材（社区版规划）
• 仿真画布：简单物理场可视化仿真引擎 （商业版规划）
• 教师智能总览与学生中心：统一呈现教学进度、薄弱点与改进成效，学生档案、个性化学习路径（商业版规划）
• SaaS 部署：多用户鉴权与云端服务（商业版规划）

贡献

我们欢迎所有形式的社区贡献！

提交 Issue

如果你发现了 Bug 或有功能建议，请 提交 Issue。提交时请包含：

• 问题描述与复现步骤
• 运行环境信息（操作系统、Python 版本等）
• 相关日志或截图

提交 Pull Request

1. Fork 本仓库并创建特性分支
2. 确保代码通过现有测试：pytest 与 cd web && npm test, 并且进行了i18n国际化
3. 提交 PR 并描述你的改动
4. 在 solaire_doc中记录changelog

报告安全漏洞

如果你发现安全漏洞，请勿通过公开 Issue 报告。请发送邮件至 hectorzhang4253@gmail.com，我们会在确认后尽快修复并致谢。

贡献者许可协议（CLA）

为保障项目的长期健康发展，首次提交 PR 时需签署 贡献者许可协议（CLA）。CLA 不会改变你对自己代码的权利，仅确保项目可以持续以开源方式分发。

许可证

本项目基于 AGPL-3.0 协议开源。

完整许可证文本见 LICENSE 文件。

---