
デバイス用ファームウェア · NOTE4 · モノクロ
WQN · 間違いノートと学習システム
高校生が継続開発するオープンソース学習システム。問題の取り込み・整理、FSRS 復習、学習記録を連携します。NOTE4 専用ファームウェアで問題復習、単語、タスク、音声 AI を利用し、結果を WQN サーバーへ同期します。

できること
高校生が継続開発するオープンソース学習システム。問題の取り込み・整理、FSRS 復習、学習記録を連携します。NOTE4 専用ファームウェアで問題復習、単語、タスク、音声 AI を利用し、結果を WQN サーバーへ同期します。
インストールと使い方
AI にインストールを依頼
デバイスを接続し、検出結果とこのファームウェアの資料をまとめて AI に渡します。
デバイスを確認して USB に接続
USB のチップ情報ではモノクロと 4 色の画面を区別できません。先にモデルを確認してください。
USB に接続してデバイスを検出
チップと容量を先に確認して、AI とのやり取りを短くします。
検出によりデバイスが再起動し、ダウンロードモードになることがあります。書き込みは行いません。画面モデルはご自身で確認してください。
まだ検出していません。先にタスクをコピーして、AI に接続を手伝ってもらうこともできます。
インストールタスクを AI に渡す
PC 上の Codex は、この PC に依存関係をインストールしてプログラムを実行できます。
互換性確認 → ファームウェアと完全バックアップを準備 → ローカルインストールを支援 → 初回動作を確認
コピー後、コンピューターの Codex で新しい会話を開いて貼り付けてください。
AI に渡す内容を見る
プロジェクト資料と今回選択したデバイス情報だけを含みます。ネットワークアドレス、アカウント、キーはインストール時にローカルで設定します。
インストール後に確認すること
機器に 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 とデータベース・認証・ストレージ・必要なモデルを設定し、Web とアカウントの動作を先に確認します。
バックアップと 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 設定と機器ペアリングを行います。問題取得、ボタン操作、結果同期を確認してから音声や MCP を有効にします。リアルタイム音声には専用 proxy とモデル設定、リモート Agent には OpenCode ゲートウェイが必要です。提供元のキーはサーバー側に置きます。キャッシュがあっても AI はオフライン動作ではありません。
ソースと導入文書を確認済み。全サービスと実機は未検証です。タスク生成だけでは送信や導入は実行されません。
よくある質問
ローカルプッシュのプラグインとの違いは?
NOTE4 の標準ファームウェアを置き換え、WQN 独自の機器 API でサーバーと双方向同期します。公式ファームウェアへの画像配信や極趣クラウド Open API のプラグインとは異なり、Web・MCP・実機で学習記録を共有します。
音声でも 38 個すべての MCP ツールを使えますか?
同じではありません。MCP 登録は 38 ツールですが、機器の音声には別途定義された許可済みの一部が公開されます。サーバー設定と権限にも依存します。モデルで扱う問題・画像・音声・学習記録は、設定した WQN と関連 AI サービスで処理されます。
現在はどのような利用者向けですか?
自前運用、ファームウェアのビルド、フィードバックに参加できる学生や開発者向けです。投稿では高校生の開発者が学生とテスト・改善を進めているとされています。学習フローや省電力機能は開発中です。当サイトは学習効果を検証しておらず、AI 回答の正確性を保証するものではありません。
プレビューと確認範囲は?
現行ファームウェアの描画関数と内蔵字庫を使い、PC 上で 400×300 の画面を出力しています。問題・時刻・進捗・電池値はサンプルで、実機キャプチャではありません。両リポジトリ、導入文書、FSRS・MCP・音声・リモート Agent の関連実装を確認しました。全サービスの構築、機器向けビルド・書き込み、音声実機検証は未実施です。両者は GPL-3.0 で、Web は mrmagic2020/Wrong-Question-Notebook を基に拡張されています。

