AI错题本Docker一键部署指南：打造孩子高效学习神器

April 4, 2026

本期我们将深入介绍一个名为「基于AI的学生错题本」的开源项目。该项目能够通过Docker实现快速部署，为家庭学习环境增添一个强大的智能助手。

那么这个工具具体能解决什么问题呢？正如项目作者在示例图片中所诙谐吐槽的那样，手动整理错题确实是一项繁琐耗时的工作。尽管过程充满挑战，我们仍然要衷心感谢开发者的贡献，打造出如此契合实际需求的应用。遵循技术爱好者中流传的「NAS、路由器、充电头」三大实用原则，这款工具对于许多已经成家立业、关注子女教育的朋友而言，无疑具有很高的实用价值。

项目的完整名称与开源地址为：GitHub - wttwins/wrong-notebook。

核心功能特性

以下内容整理自项目官方介绍，这是一个基于人工智能技术的智能错题管理系统，旨在协助学生高效地完成错题的整理、分析与复习工作。

🤖 AI智能解析：自动识别题目内容，并智能生成题目解析、关联的知识点标签以及同类型的练习题。
⚙️ 灵活的AI配置：支持集成Google Gemini和OpenAI（及其兼容API）作为AI服务提供商，用户可以直接在网页设置界面中动态切换和配置相关参数。
📚 多错题本管理：支持按照不同学科（例如数学、物理、英语等）创建并管理多个独立的错题本。
🏷️ 智能标签系统：系统能够自动从题目中提取关键的知识点作为标签，同时也支持用户进行自定义标签的管理。
🖨️ 灵活导出与打印：可以一键导出经过筛选的错题集，支持自定义打印内容（例如是否包含答案、解析或知识点），并可调整图片缩放比例，方便直接打印或保存为PDF文档。
📊 学习数据统计：通过可视化的图表，清晰展示错题的掌握情况与总体的学习进度。
🔐 多用户管理：支持多名用户注册和登录，确保不同用户之间的数据安全隔离。
🛡️ 管理员后台：提供了基础的用户管理功能，管理员可以执行禁用、启用或删除违规用户等操作。
📝 智能练习生成：能够基于已有错题，智能生成考察相似知识点的练习题，帮助巩固薄弱环节。
🎯 多维度筛选：支持按照掌握状态、时间范围、知识点标签、年级学期、试卷难度等级等多种条件对错题进行精细化筛选。

详细部署流程

本文将以威联通（QNAP）NAS设备为例，详细演示如何使用Docker Compose来部署该错题本应用。

请参考以下部署代码，将其保存为docker-compose.yml文件：

services:
  wrong-notebook:
    image: ghcr.io/wttwins/wrong-notebook:latest
    container_name: wrong-notebook
    restart: always
    ports:
      - "3000:3000" # 左侧主机端口可根据需要修改
    environment:
      - NEXTAUTH_URL=http://192.168.100.114:3000 # 请替换为您的实际访问地址
      - NEXTAUTH_SECRET=qnap1234 # 加密密钥，此处为示例，建议使用更强的随机密码
    volumes:
      # 持久化存储SQLite数据库和配置文件
      - /share/Container/notebook/data:/app/data
      - /share/Container/notebook/config:/app/config

基本使用介绍

按照上述步骤完成部署后，在浏览器地址栏输入您的NAS_IP:3000即可访问错题本服务。

首次使用时，需要注册一个新账户。完成注册后，使用账户信息登录系统。

登录成功后，首先需要进行关键配置。点击页面右上角的「设置」选项，进入「AI 提供商」配置页面。在此处填入您所选择的AI服务商（支持OpenAI及Gemini）的API密钥等相关信息。该项目兼容多种模型接口，例如您也可以使用硅基流动的Quwen系列等视觉语言大模型。请注意，务必选择具备视觉识别能力的多模态大模型，以确保能正确解析图片中的题目。

为了演示AI识题功能，此处我们截取原项目介绍图中的题目进行测试。

识别效果令人印象深刻！系统不仅准确地提取了题目原文，还自动生成了参考答案、详细的解析思路，并判断了题目所属的年级等信息。页面左侧的各个字段均支持手动调整，下方还可以自行添加或修改标签。确认信息无误后，点击保存即可将题目收录到个人错题本中。

我们也尝试上传了一道数学题目进行测试，AI同样能够准确识别并完成解析。

结语

随着此类智能学习工具的普及，当今的学生在获取高效学习辅助方面拥有了更多选择。

希望本篇介绍与指南能对您有所帮助。