QuizTube 是一个面向学习场景的 AI 视频笔记与复习工具。
你只需要粘贴 B 站视频链接，系统会自动完成字幕/转写、结构化康奈尔笔记生成，并进一步产出可循环复习的 Quiz 题目，帮助你把“看过”变成“记住”。

粘贴 B 站视频链接，点击「开始生成」，AI 自动提取康奈尔骨架并串联复习闭环；最近编辑的笔记也会在这里快速找回。

左栏：B 站视频播放、自动生成的视频简介，以及基于笔记内容的 AI 问答（可追问、推荐相关概念）。右栏为康奈尔布局——「线索」列出核心问题，「笔记」按时间戳展开要点，支持编辑与保存。

汇总所有已生成笔记：展示视频标题、AI 摘要与核心知识点数量；支持按标题/知识点搜索，待巩固笔记置顶；每张卡片可直达「复习」。

统计待复习视频数、题目数与预估用时，支持连续打卡；按紧急程度列出今日任务（含逾期提醒），点击即可开始对应视频的 Quiz 巩固。

进入单条视频后，按要点逐题作答；答错可看解析，支持免惩罚提示，进度条实时追踪当前巩固进度。

QuizTube 聚焦三个核心目标：

• 将视频内容快速沉淀为可编辑、可保存的康奈尔笔记
• 将知识点自动转化为复习题，支持间隔重复训练
• 提供本地化可配置能力（LLM / ASR API 配置），降低使用门槛

• B 站链接一键生成笔记：优先官方字幕，必要时 ASR 兜底
• 康奈尔笔记编辑器：线索区 / 笔记区 / 总结区固定布局，支持富文本编辑
• Quiz 复习系统：自动生成题目、会话答题、错题解释与复习状态追踪
• 合集分P支持：可选择多个分P合并生成单篇笔记
• 后台任务中心：生成进度可视化与任务状态反馈
• API 配置页面：可在页面中配置 Chat / ASR 的 Base URL、Model、Key

• Backend: FastAPI (Python)
• Frontend: HTML + Tailwind CSS + Vanilla JavaScript
• AI: OpenAI Compatible API（支持 MiMo / Ark / OpenAI 等）
• 媒体处理: yt-dlp + ffmpeg

• 需要高频复习技术视频/课程的学习者
• 想把视频内容沉淀成结构化知识卡片的创作者
• 希望快速搭建“视频转笔记 + 测验复习”流程的开发者

• 操作系统：macOS / Linux（Windows 建议使用 WSL）
• Python：3.9+（推荐 3.10+）
• 必备工具：
  • ffmpeg（音频切片）
  • yt-dlp（视频/字幕抓取）

macOS 可用 Homebrew 安装：

brew install ffmpeg yt-dlp

git clone https://github.com/threeorz1027-svg/quiztube.git
cd quiztube
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

uvicorn app:app --host 127.0.0.1 --port 8000 --reload

浏览器打开：

• http://127.0.0.1:8000

项目内置了 API配置 页面：

1. 打开左侧导航 API配置
2. 填写 Chat/ASR 的 Base URL、Model、API Key
3. 点击保存后立即生效

配置优先级：页面本地配置 > 系统环境变量

如果你更习惯命令行，也可在启动前手动设置：

export MIMO_API_KEY="your_key"
export MIMO_BASE_URL="https://api.xiaomimimo.com/v1"
export MIMO_CHAT_MODEL="mimo-v2-flash"
export MIMO_TRANSCRIBE_MODEL="mimo-v2-omni"

• 页面打不开 / Connection refused
  • 检查服务是否启动：uvicorn ...
  • 检查端口是否被占用（默认 8000）
• ASR 报 Invalid API Key
  • 到 API配置 页面确认 Key 是否正确保存
  • 避免多个无效环境变量覆盖
• 提示缺少 yt-dlp / ffmpeg
  • 重新安装工具并确认 PATH 生效
• B站视频抓不到字幕
  • 可在配置里保持 ASR 兜底开启