智能错题本SMART WRONG NOTEBOOK GitHub EN

给错题一个新的开始

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

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

开始使用 在线体验

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

源码开放全平台安装包手机电脑都能用
AI 帮你把知识串起来
属于你的知识积累
每一次练习，都有迹可循记录作答 → 评估掌握 → 持续进步

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

为持续学习而设计

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

A LITTLE MISTAKE. A BIG STEP FORWARD.

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

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

  1. 01

    先把错题收进来

    拍照、粘贴截图或输入文字。AI 识别题目，整理答案、解析与知识点。

    少一点整理负担
  2. 02

    把思路看明白

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

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

    换一道题，再试试

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

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

    让进步被看见

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

    让下一次复习更有方向

THOUGHTFUL TOOLS, REAL UNDERSTANDING

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

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

把解题思路「演」给你看

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

AI 按解题思路生成分步骤的 SVG 动画，
中英文讲解随界面语言切换。
暂停、拖动、重播，按自己的节奏理解。

举一反三，不止这一题

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

基于错题生成同知识点的填空或解答题，可选难度，用新的问题巩固旧的薄弱点。

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

让知识，有自己的位置。

按学段、学科和章节组织知识点，AI 自动打标签，也支持自定义。

屏幕上整理，纸上练习。

按知识点、掌握情况组卷。自由选择答案与解析，打印或保存为 PDF。

会没会，让练习来回答。

根据实际作答历史评估掌握概率，结合错题与练习统计，找到下一步。

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

A CLOSER LOOK

好不好用，打开看看。

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

我的错题本

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

实际应用截图 · 浅色模式

YOUR NOTEBOOK, YOUR SPACE

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

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

  • 数据由自己管理

    SQLite 数据库保存在本机，支持数据备份导入与导出。

  • AI 服务，自由选择

    默认使用 MiniMax，也可选智谱 GLM、DeepSeek、Kimi，
    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
启动后访问 http://localhost:3000

默认管理员为 admin@localhost / 123456，首次登录后请修改密码，并在「设置」中配置 AI 服务。镜像发布在 ghcr.io/margrop/wrong-notebook，也可用 2026.10.22 等版本标签锁定版本；升级、Docker Compose 和各平台安装包的数据目录见部署文档。

GOOD QUESTIONS

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

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

反馈问题或建议
使用这个项目，需要付费吗？

项目基于 MIT 许可证免费开源，提供源码、Docker 镜像、npm 包和各平台安装包供自行部署。AI 识题、生成讲解等功能需要配置自己的 AI 服务，调用费用由对应服务商收取，也可以直接选择 MiniMax、智谱 GLM、DeepSeek、Kimi 官方渠道，或接入兼容 OpenAI、Anthropic 接口的服务。

可以先试用一下吗？

可以。打开 在线演示站，使用账号 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 开始

应用界面预览