设备固件 · NOTE4 · 黑白
WQN · 错题与学习系统
由高中生持续开发的开源学习系统，将错题识别、整理、FSRS 复习与学习记录连接起来。NOTE4 专用固件提供错题复习、单词、待办和语音 AI，并把学习结果同步回 WQN；需要配套服务端。
它能做什么
由高中生持续开发的开源学习系统，将错题识别、整理、FSRS 复习与学习记录连接起来。NOTE4 专用固件提供错题复习、单词、待办和语音 AI，并把学习结果同步回 WQN；需要配套服务端。
识别并整理错题，记录作答、错因与订正，让复习建立在持续积累的学习记录上
FSRS 安排复习；学生可检查、纠正 AI 标注，学习评价保留人工确认
NOTE4 缓存错题、单词和学习状态，离线完成的记录通过持久队列重试回传
语音问答与 StepFun 实时对话；可通过授权工具查题、记笔记、安排待办
Web、38 个 MCP 工具与 NOTE4 共用学习数据；支持配置 OpenCode 远程 Agent 接口
安装与使用
让 AI 帮你装好
连接设备，把检测结果和这份固件资料一起交给 AI。
1
确认设备，接上 USB
USB 芯片信息不能区分黑白屏与四色屏，请先确认型号。
接上 USB，检测设备
先识别芯片和容量，让 AI 少问几个问题。
检测可能让设备重启进入下载模式，不会刷写。屏幕型号仍需你确认。
尚未检测。也可以先复制任务，让 AI 协助连接。
2
把安装任务交给 AI
电脑上的 Codex 可以在本机安装依赖和运行程序。
AI 会接着做这些事
核对兼容性 → 准备固件和完整备份 → 协助本机安装 → 检查首次运行
复制后，在电脑上的 Codex 新建对话并粘贴。
看看交给 AI 的内容
只包含项目资料与本次选择的设备信息。网络地址、账号和密钥在安装时由你本地配置。
3
装好以后，看这一眼
设备能展示WQN · 错题与学习系统的预期画面，重复更新仍然正常。
让 AI 汇报安装位置、验证结果和以后怎么启动；有问题时在同一个对话继续处理。
熟悉安装？查看手动步骤与源码
NOTE4 黑白屏 · ESP-IDF 5.5.4 · WQN 账号或自托管服务 · Wi-Fi · AI 功能另需服务配置
先准备 WQN 服务
投稿说明称公开服务 wqn.helema.cn 已因资源限制停止注册，体验需联系开发者；也可自托管 Wrong-Question-Notebook 仓库。按 README 准备 Node.js 24+、npm、Docker 与 Supabase CLI，配置数据库、认证、存储及所需模型服务。先确认自己的网页和账号可用，再连接设备。
备份并构建 NOTE4 固件
适用于 zectrix-s3-epaper-4.2 / ESP32-S3 / 16 MiB Flash 的 NOTE4 黑白屏，不适用于 NOTE4C。先备份自己设备的完整 Flash 并确认恢复方式，再用 ESP-IDF 5.5.4 按固件 README 构建、烧录。当前未提供 GitHub Releases 安装包；文档中的电脑路径、COM 端口和备份校验值是作者环境示例，不能直接当作自己的设备配置。
配对、同步并按需开启 AI
自托管时将 WQN_API_BASE 指向自己的 /api/esp32，再完成 Wi-Fi 配网与 WQN 设备配对。先核对错题下载、按键复习和学习结果回传，再启用语音与 MCP。实时语音需要额外部署 realtime proxy 并配置模型服务，远程 Agent 需要 OpenCode 网关；服务商密钥留在服务端。离线缓存不代表离线 AI。
源码与部署文档已核对 · 完整服务及实机未验证。生成任务不会自动发送，也不会执行安装。
常见问题
它与本地推送插件有什么不同？
WQN 会替换 NOTE4 原系统，通过自己的设备 API 与 WQN 服务端配对和双向同步。它不是给官方固件推一张图片，也不使用极趣云 Open API 插件流程。网页、MCP 与硬件共同使用学习记录。
38 个 MCP 工具都能在设备语音里用吗？
不能简单等同。当前 MCP 注册表覆盖 38 个工具，设备语音侧使用其中单独定义的授权子集；可用能力还取决于服务端配置和用户权限。通过模型处理的问题、图片、音频和学习记录会进入所配置的 WQN 服务与相关 AI 服务。
项目目前适合谁？
适合愿意自行部署、编译固件并参与反馈的学生和开发者。作者投稿称项目由高中生开发，并与学生共同测试迭代；当前仓库仍在积极开发，部分学习流程与低功耗能力会变化。本站未验证学习效果，不将 AI 解答视为正确性保证。
配图与核对范围是什么？
配图使用当前固件的原有绘制函数和内置字库，在电脑上输出 400×300 帧缓冲；题目、时间、进度和电量为演示数据，不是实机照片。已核对两个仓库、部署文档以及 FSRS、MCP、语音与远程 Agent 的相关实现；未部署完整服务、编译刷入设备或实测语音。两个仓库采用 GPL-3.0，Web 项目基于 mrmagic2020/Wrong-Question-Notebook 持续扩展。
你可能还喜欢
浏览更多固件 →
