Skip to content

README.md

Latest commit

 

History

History
117 lines (89 loc) · 4.09 KB

README.md

File metadata and controls

117 lines (89 loc) · 4.09 KB
Raw

智学AI (ZhixueAI)

高中生 AI 自学平台 — 以 B 站名师视频为教材，AI 为私教

本项目分为两个独立仓库：

仓库 说明 技术栈
zhixue-ai-server 后端服务 Express + SQLite + 多模型 AI
zhixue-ai-client 前端界面 Vite + KaTeX + jsPDF

核心理念

不要 AI 自己讲，让 AI 帮你看懂名师视频。

多数 AI 学习工具的问题是"AI 自己讲知识"——内容肤浅、脱离考情、题目质量差。智学AI 的思路不同：

  1. B 站名师视频当教材 — 一数、云凌、阿不、MST 等 UP 主的好课都在
  2. AI 做三件事：看不懂时答疑、看完后生成笔记、按薄弱点出题
  3. 学情追踪 — 错题和掌握度全记录，下次推荐对应视频和练习

功能

模块 说明
🤖 AI 视频推荐 根据学情自动推荐最合适的 B 站视频
🔍 B 站搜索 搜索任意关键词，直接嵌入播放，不跳转
🎬 嵌入播放 + AI 侧边栏 播放器嵌入页面，右侧笔记/答疑/练习三 tab
📝 AI 笔记（SSE 流式） 拉取字幕 → DeepSeek 生成 7 步结构笔记
💬 时间点答疑 输入秒数，AI 结合附近字幕解答"为什么"
✏️ 视频出题 基于视频内容生成 3 道巩固题
📷 拍照解题 上传截图，多模态 AI 自动识别并解答
📰 智能组卷 + PDF 选知识点 → AI 命题 → 一键导出 PDF
📕 错题本 归类管理，追踪薄弱点
📊 学情追踪 掌握度持久化，AI 推荐下一步

视频库（内置）

770+ 个高中数学视频，覆盖 248 位 UP 主：

  • 一数 (88) — 系统课代表
  • MST 高考数学 (108) — 一轮/二轮系统课 ⭐编辑推荐
  • H 老师讲数学 (35) — 竞赛/强基 ⭐编辑推荐
  • 阿不高中数学 (30) — 导数大合集
  • 赵礼显老师 (26) — 高考压轴
  • 数学竞赛飞哥 (12) — CMO 金牌竞赛
  • 漫士沉思录 (17) — 数学科普（独立栏目）
  • 云凌Sapphire (8) — 二级结论技巧

依赖总览

后端运行时依赖

包 用途
express Web 框架
better-sqlite3 本地数据库
cors 跨域
dotenv 环境变量
undici HTTP 客户端

前端运行时依赖

包 用途
vite 构建工具
KaTeX (CDN) 数学公式渲染
jsPDF (CDN) PDF 导出
html2canvas (CDN) HTML 截图

参考项目

项目 参考内容
BiliGPT B站 API 认证机制
video-summarizer WBI 签名 + 字幕提取
bilibili-video-summarizer 视频分P解析
NovaForge 7 步笔记结构
ChinaTextbook 教材目录结构
DeepTutor Agent 辅导架构
tutor-skills 掌握度追踪
slides_maker PDF 导出排版
xiaozhi-skills AI 教学提示词
SyllabusOS Agent workspace
sm-math-teacher 互动式教学

快速部署

本地运行

# 1. 克隆两个仓库
git clone <server-repo-url> zhixue-ai-server
git clone <client-repo-url> zhixue-ai-client

# 2. 启动后端
cd zhixue-ai-server
npm install
cp .env.example .env
# 编辑 .env，填入 API Key
node src/index.js &    # http://localhost:8787

# 3. 启动前端
cd ../zhixue-ai-client
npm install
npx vite --host &      # http://localhost:5173

服务器部署

详见各仓库 README：

许可证

MIT