LumeSync（萤火课堂）文档
把可交互课件稳定地运行在真实教室里。
LumeSync（萤火课堂）把教师端、学生端、课件运行时、AI 课件编辑器和 VS Code 插件组织在同一个工作区中，适合局域网课堂、机房教学和本地部署场景。
核心能力
教师端课堂控制
教师端服务扫描课程、维护当前课程和页码、管理座位表、收集学生提交，并通过 Socket.IO 同步课堂状态。
学生端连接与监控
学生端连接教师机地址，接收课件状态、提交作业、参与投票，并可按教师端设置上报课堂行为和截图。
.lume 课件运行时
当前运行时优先加载 Zip 格式 .lume 包，通过 manifest.json、pages 和 assets 组织 TSX/JSX 页面与资源。
编辑器与插件
AI Editor 负责本地创建、预览和导出 .lume 包；VS Code 插件提供 .lume 自定义编辑器和本地预览服务。
推荐阅读路径
第一次运行项目，先阅读 快速开始 和 安装，确认 submodule、pnpm 依赖和桌面端构建前置条件。
准备开发课件，阅读 第一个课件示例、课件运行时 和 课件开发指南。当前主格式是 Zip .lume 包，旧的单文件 .lume 不再作为可播放格式。
需要对接或排障，阅读 HTTP API、Socket 事件、配置项 和 排障。
当前文档依据
本轮内容重新读取了最新代码，包括根工作区配置、repos/teacher、repos/teacher/core、repos/student、repos/ai-editor 和 repos/editor-plugin。无法从源码确认的版本历史、发布流程、部分部署参数和产品截图已在对应页面标为 TODO。
Last updated on