智能错题本SMART WRONG NOTEBOOK GitHub
EN

给错题一个新的开始

让每一道错题，
成为进步的起点。

收录，只是第一步。
用 AI 帮你理解错因、举一反三，
让「做过了」真正变成「学会了」。

下载安装包 在线体验

Windows · macOS · Linux · 安卓 · 飞牛OS · 全部系统与架构 · 自托管部署

演示账号 demo@localhost / demo123456 · 共享数据，请勿录入个人信息

源码开放全平台安装包手机电脑都能用
用户交流 QQ 群二维码，群号 964325781用户交流 QQ 群964325781QQ 扫码加入，交流用法与建议
AI 帮你把知识串起来
属于你的知识积累
每一次练习，都有迹可循记录作答 → 评估掌握 → 持续进步

真实应用截图 · 点击可放大

为持续学习而设计

小学 · 初中 · 高中 多种 AI 服务可选 电脑 · NAS · 服务器PWA 像 App 一样随手打开

A LITTLE MISTAKE. A BIG STEP FORWARD.

从「这题错了」，到「这题会了」。

不用把时间花在反复誊抄上，把精力留给真正的理解。

  1. 01

    先把错题收进来

    拍照、粘贴截图或输入文字。AI 识别题目，整理答案、解析与知识点。
    每个账户可选择固定录入年级，或由 AI 按题目识别。

    少一点整理负担
  2. 02

    把思路看明白

    回看错因与解题过程，用 SVG 动画讲解，把抽象的步骤变得直观。

    多一点「原来如此」
  3. 03

    换一道题，再试试

    围绕同一知识点生成变式题，选择难度，检验自己是否真的理解。

    从记住答案到举一反三
  4. 04

    让进步被看见

    保留每次作答结果，跟踪掌握情况，再把需要巩固的题目组成试卷。

    让下一次复习更有方向

THOUGHTFUL TOOLS, REAL UNDERSTANDING

不止收集错题，
更关心你有没有学会。

从一道题的细节，到整个知识网络，
把学习中需要的工具，放在一起。

把解题思路「演」给你看

抽象的步骤，
也可以一目了然。

AI 按解题思路生成分步骤的 SVG 动画，
中英文讲解随界面语言切换。
点击播放后才开始，打开页面时保持暂停。
可开启语音讲解，边看边听：
浏览器语音免费，云端语音自然如真人（需付费，建议购买套餐）；
暂停、拖动、重播，按自己的节奏理解。

举一反三，不止这一题

会做一道，
更要会做一类。

基于错题生成同知识点的填空或解答题，可选难度，用新的问题巩固旧的薄弱点。
写法一致直接判对，其余由 AI 对照标准答案判定并说明理由。

原题 · 一元一次方程3x + 6 = 21这一次，理解等式的性质。
同一知识点，新的练习
变式题 · 换个角度5x − 8 = 27这一次，试着独立解答。
功能示意 · 示例题目

让知识，有自己的位置。

按学段、学科和章节组织知识点，AI 自动打标签，也支持自定义。
题目详情与录入校对页都能手工调整年级和学期。
管理员还可在设置中导入人教版课标知识点，作为另一套标签体系选用。

屏幕上整理，纸上练习。

按知识点、掌握情况组卷。自由选择答案与解析，打印或保存为 PDF。有配图的错题与试卷题目支持保存显示比例与位置（居左/居中/居右），试卷还可统一调整。

会没会，让练习来回答。

按 1、2、4、7、15、30 天的间隔安排复习，「今日复习」列出今天该做的题；
再根据实际作答历史评估掌握概率，找到下一步。

×初次出错✓变式练习✓复习巩固
参考作答记录，辅助复习判断
一图多题框选 可配置相似题判重 LaTeX 公式排版 多用户数据隔离 每人每日 AI 次数可限 免费 MiniMax 账号可用

A CLOSER LOOK

好不好用，打开看看。

真实运行的界面，真实的学习记录。
点击标签，看看每一步如何发生。

我的错题本

按知识点、年级、掌握情况和 A/B 卷筛选，把需要复习的题目快速找出来。

实际应用截图 · 浅色模式

YOUR NOTEBOOK, YOUR SPACE

把学习资料，
留在自己的空间。

Windows、macOS、Linux 桌面版开箱即用，
飞牛OS、npm 与 Docker 部署到 NAS 或服务器。
用熟悉的 AI 服务，建立属于自己的错题本。

  • 数据由自己管理

    SQLite 数据库保存在本机；一键导出备份，
    错题、练习记录、试卷和偏好都能完整导入。

  • AI 服务，自由选择

    免费版 MiniMax 账号即可使用：网页登录 MiniMax Code，
    每天自动签到领积分，AI 功能消耗免费积分额度；
    也可选 MiniMax、智谱 GLM、DeepSeek、Kimi、千问、阶跃星辰、
    火山引擎（含 Agent Plan、Coding Plan、免费试用）、Anthropic、Azure OpenAI、OpenAI、Gemini 及兼容接口。

  • 随手打开，随时复习

    支持 PWA，可添加到手机和平板主屏幕；
    安卓单机版装上即用，数据只存在手机里。

阅读完整部署文档
QUICK START
使用已发布镜像，支持 amd64 / arm64
# 1. 创建数据与配置目录
mkdir -p wrong-notebook/data wrong-notebook/config
cd wrong-notebook

# 2. 拉取镜像并启动，数据保存在挂载目录
docker run -d --name wrong-notebook \
  --restart unless-stopped -p 3000:3000 \
  -e NEXTAUTH_SECRET="$(openssl rand -hex 32)" \
  -v "$(pwd)/data:/app/data" \
  -v "$(pwd)/config:/app/config" \
  ghcr.io/margrop/wrong-notebook:latest
首次启动后用 docker logs wrong-notebook 找到一次性初始化链接，打开后设置管理员账号

首次启动时终端会打印一次性初始化链接，打开后设置管理员邮箱和密码，再按安装向导配置 AI 渠道、创建第一个错题本。镜像发布在 ghcr.io/margrop/wrong-notebook，也可用 2026.10.22 等版本标签锁定版本；升级、Docker Compose 和各平台安装包的数据目录见部署文档。

GOOD QUESTIONS

开始之前，
你可能想知道。

还有疑问？欢迎到 GitHub 或 QQ 群交流。

反馈问题或建议 智能错题本用户交流 QQ 群二维码，群号 964325781用户交流 QQ 群964325781用 QQ 扫码加入，交流用法与建议。点击可查看大图。
使用这个项目，需要付费吗？

项目基于 MIT 许可证免费开源，提供源码、Docker 镜像、npm 包和各平台安装包供自行部署。AI 识题、生成讲解等功能需要配置自己的 AI 服务，调用费用由对应服务商收取，也可以直接选择 MiniMax、智谱 GLM、DeepSeek、Kimi、千问、阶跃星辰、火山引擎官方渠道（火山引擎新用户有免费额度），或用免费版 MiniMax 账号网页登录 MiniMax Code（无需 API Key，每天自动签到领积分，AI 功能消耗免费积分额度），或接入兼容 OpenAI、Anthropic 接口的服务。动画的云端语音讲解同样由语音服务商收费，建议购买 Token Plan 等套餐，火山引擎提供免费试用额度；也可以使用免费的浏览器本地语音。

没有 API Key，能免费用 AI 功能吗？

可以。在设置中选择「MiniMax Code OAuth」，用免费版 MiniMax 账号网页登录即可调用 MiniMax-M3.1-Flash。应用每天自动签到领取积分，识题、讲解、举一反三等 AI 功能消耗的是账号的免费积分额度，剩余积分在设置页随时可查。

可以先试用一下吗？

可以。打开 在线演示站，使用账号 demo@localhost、密码 demo123456 登录。演示站为共享账号，数据对所有访客可见，请勿录入个人信息；正式使用建议部署自己的实例。

支持哪些系统和设备？

服务端可以运行在 Windows、macOS、Linux 桌面版，飞牛OS NAS，以及任何支持 Docker 或 Node.js 的服务器上。部署后，手机、平板和电脑都能通过浏览器使用。桌面版默认只允许本机访问，飞牛OS、npm 和 Docker 部署可在局域网内访问。

适合哪些年级和学科？

创建错题本时可以选择小学、初中或高中学段，以及对应学科。小学支持数学、英语和语文，内置语文章节与知识点覆盖小学一年级至六年级及初高中。系统按学段、学科组织知识点，支持自定义标签；AI 可辅助识别知识点和难度。

可以在手机上用吗？

可以。应用支持手机、平板和电脑浏览器，并提供 PWA 支持。在 iPhone / iPad 的 Safari 分享菜单，或 Android Chrome 菜单中选择「添加到主屏幕」，即可像 App 一样打开。安卓设备还可以安装 Releases 中的 APK：单机版内置服务端，装上即用，数据保存在手机上；客户端版连接自己部署的服务器。两者都支持拍照上传、文件导出和系统打印。

数据存在哪里？可以完全离线吗？

题目和作答记录保存在你部署环境的 SQLite 数据库中，AI 配置也保存在自己的部署环境。AI 识别、解答和生成等功能会向所配置的服务发送相关内容，需要该服务可访问；PWA 不等于完整离线运行。

GitHub Pages 能直接运行错题本吗？

这个官网可以通过 GitHub Pages 托管。错题本应用本身包含登录、数据库和 AI 接口，需要运行服务端：可以直接安装桌面版或飞牛OS 安装包，也可以用 npm 或 Docker 部署到电脑、NAS 或服务器。想先看看效果，可以使用在线演示站。

和上游 wrong-notebook 有什么关系？

本项目基于 wttwins/wrong-notebook 扩展，增加了中英文 SVG 动画讲解、掌握情况跟踪、可配置判重、试卷作答回填、国产大模型官方渠道、中英文界面和全平台安装包等功能。感谢上游作者的工作。完整功能与差异请查看项目 README。

KEEP THE LESSON. LEAVE THE MISTAKE.

下一次遇见，就会了。

从收下一道错题开始，积累每一次「我懂了」。

在 GitHub 开始

应用界面预览