ClassIntra
—— 一个班级里能用到的一切 ——
聊天 · AI · 论坛 · 云盘 · 笔记 · 音乐 · 天气 · 全在一个网页里
一个班级里能用到的一切——聊天、AI 助手、社区论坛、云盘、笔记、天气、音乐——全在一个网页里。
💡 为什么做这个？
学校给我们发了学生平板。但说实话，这些设备除了看看课件、刷刷题，几乎没有"班级自己的东西"——聊天用 QQ、交作业用微信、文件传来传去靠 U 盘。功能割裂、数据散落、体验割裂。
我就想：能不能把这些平板真正利用起来？搭一个班级专属的一体化平台，聊天、AI、论坛、云盘、笔记、天气、音乐全在同一个网页里，平板打开浏览器就能用。
于是从零开始写了 ClassIntra。AI 辅助 Coding，一个人全栈。
🚀 能干什么？
SUCCESS: 以下所有功能均已在最新版本中可用，浏览器打开即用，无需安装任何 App。
💬 即时通讯
· WebSocket 实时聊天，支持私聊 + 群聊 + 班级广播
· @提及、消息引用回复、Emoji 反应、转发消息
· 群聊成员管理（踢人 / 禁言 / 转让群主）
🤖 AI 对话助手
· OpenAI / DeepSeek 双引擎 + 联网搜索
· Markdown 格式回复，LaTeX 数学公式完整渲染
· Mermaid 流程图 / 时序图 / 甘特图 / 类图 等 20+ 种图表
· 对话记录可一键转发到论坛或聊天
📝 社区论坛
· 发帖 / 评论 / 点赞 / 转发 / 收藏
· Markdown + LaTeX + Mermaid 编辑器
· 匿名发帖模式
· 等级系统（每日签到、经验值、连续签到奖励）
☁️ 云盘
· 文件上传 / 下载 / 在线预览（图片 / 视频 / 音频）
· 免登录上传码（访客通过上传码提交文件，防爆破保护）
· 完整的文件管理（新建文件夹 / 移动 / 重命名 / 删除）
📋 笔记系统
· 专业 Markdown 编辑器（粗体 / 斜体 / 代码 / 表格 / 任务列表）
· LaTeX 完整文档渲染 + KaTeX 数学公式
· Mermaid 20+ 种图表支持（流程图 / 时序图 / 类图 / ER 图 / 饼图……）
· 文件附件管理、全屏专注模式、导入 / 导出 .md 文件
· 笔记可设为仅自己可见，云端实时保存
🎵 音乐
· 内置播放器（播放 / 暂停 / 上一曲 / 下一曲 / 进度条）
· 歌单管理（创建 / 编辑 / 删除），支持本地音乐上传
· 歌单可一键转发到论坛
🌤️ 天气
· 实时天气卡片（温度 / 湿度 / 风力 / 能见度 / 空气质量）
· 7 日天气预报 + 生活指数（紫外线 / 穿衣 / 运动 / 洗车等）
⚙️ 系统功能
· 深色 / 浅色主题 + 动态壁纸（内置渐变 + 自定义图片 / 视频）
· 锁屏密码、通知中心
· 等级系统（签到 / 发帖 / 评论 / 获赞均可获得经验）
· 管理面板（用户管理 / 广播通知 / 应用管控 / 资源管理）
· 版本号自动管理（SemVer，构建时 PATCH 自动 +1）
· 新版本桌面角标提示 + 更新介绍弹窗
🛠️ 技术栈
前端：Vue 2.7 + Vue Router + Vuex
构建：Vite 5
样式：SCSS + CSS 变量 + iOS 风格设计系统
后端：Node.js + Express
数据库：SQLite（better-sqlite3，WAL 模式）
实时通信：WebSocket（ws）
图表：Mermaid 11
数学公式：KaTeX 0.16
Markdown：marked 4
视频播放：Video.js 8 + HLS
认证：bcryptjs + JWT（jose）
项目管理：pnpm workspace（Monorepo）
📦 快速开始
git clone https://github.com/ClassIntra/ClassIntra.git
cd ClassIntra
pnpm install
cp server/.env.example server/.env
\# ⚠️ 务必设置 JWT_SECRET
mkdir -p Resources/public/wallpapers Resources/public/music Resources/videos
pnpm dev
打开 localhost:5001，首次访问 /setup 完成班级初始化。
📺 宣传视频
B站宣传片：
📖 相关链接
· 官方文档站：https://classintra.github.io
· 官方 QQ 群：点击加群（群号：1074276021）
· GitHub：github.com/ClassIntra/ClassIntra
📌 后续计划
· PWA 支持（离线可用）
· 移动端适配优化
· Docker 一键部署
🙋 开发心得
1. AI 写代码不等于不管代码
AI 写的代码需要你来——审查逻辑、统一风格、修边界 Bug。AI 是"写得快"，你是"写得对"。
2. 版本号省心方案
SemVer 的 PATCH 号构建时自动 +1，日常完全不碰版本号。新功能完成时手动改一下 MINOR。Changelog 从 Git Log 自动生成。
3. 单文件 SQLite 真香
班级场景 50 人以内，SQLite 完全够用。零配置，备份就是一个文件复制。
SUCCESS: 欢迎 Star / Fork / 提 Issue！
如果你们班也需要一个这样的平台，直接 clone 下来改改配置就能跑。
—— 欢迎 Star / Fork / 提 Issue ——
🌟 彩蛋：Ditto
如果你想要一个不限校园、不限场景的通用 WebOS，我也在同时维护另一个项目：
Ditto —— 把浏览器变成操作系统，Cell 架构、沙盒隔离、权限系统、面向嵌入式（树莓派 / 开发板）。
github.com/Ditto-Platform/Ditto
ClassIntra 管好一个班，Ditto 管好你自己。
