デバイス用ファームウェア · 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 のチップ情報ではモノクロと 4 色の画面を区別できません。先にモデルを確認してください。

USB に接続してデバイスを検出

チップと容量を先に確認して、AI とのやり取りを短くします。

検出によりデバイスが再起動し、ダウンロードモードになることがあります。書き込みは行いません。画面モデルはご自身で確認してください。

まだ検出していません。先にタスクをコピーして、AI に接続を手伝ってもらうこともできます。

2

インストールタスクを AI に渡す

PC 上の Codex は、この PC に依存関係をインストールしてプログラムを実行できます。

AI が次に行うこと

互換性確認 → ファームウェアと完全バックアップを準備 → ローカルインストールを支援 → 初回動作を確認

コピー後、コンピューターの Codex で新しい会話を開いて貼り付けてください。

AI に渡す内容を見る

プロジェクト資料と今回選択したデバイス情報だけを含みます。ネットワークアドレス、アカウント、キーはインストール時にローカルで設定します。

3

インストール後に確認すること

機器に WQN の想定画面が表示され、更新を繰り返しても正常に動作すること。

AI にインストール場所、検証結果、次回の起動方法を報告してもらいます。問題があれば同じチャットで続けて相談できます。

自分で設定する方へ:手動手順とソース

NOTE4 モノクロ · ESP-IDF 5.5.4 · WQN アカウントまたは自前サーバー · Wi-Fi · AI サービスの別途設定

  1. WQN サービスを準備

    投稿によると、wqn.helema.cn はリソース不足で新規登録を停止しています。体験は開発者へ相談するか、Wrong-Question-Notebook を自分で運用してください。README に従って Node.js 24+、npm、Docker、Supabase CLI とデータベース・認証・ストレージ・必要なモデルを設定し、Web とアカウントの動作を先に確認します。

  2. バックアップと NOTE4 ファームウェアのビルド

    対象は zectrix-s3-epaper-4.2 / ESP32-S3 / 16 MiB Flash の NOTE4 モノクロです。NOTE4C には対応しません。自分の機器の Flash 全体を保存し復元方法を確認してから、ESP-IDF 5.5.4 と README に従いビルド・書き込みします。GitHub Releases の配布パッケージは現在ありません。記載のパス・COM ポート・バックアップ値は作者の環境例です。

  3. ペアリング・同期と AI の設定

    自前運用では WQN_API_BASE を自分の /api/esp32 に向け、Wi-Fi 設定と機器ペアリングを行います。問題取得、ボタン操作、結果同期を確認してから音声や MCP を有効にします。リアルタイム音声には専用 proxy とモデル設定、リモート Agent には OpenCode ゲートウェイが必要です。提供元のキーはサーバー側に置きます。キャッシュがあっても AI はオフライン動作ではありません。

GitHub で詳しい説明を見る ↗詳しい開発ドキュメント ↗

ソースと導入文書を確認済み。全サービスと実機は未検証です。タスク生成だけでは送信や導入は実行されません。

よくある質問

ローカルプッシュのプラグインとの違いは?

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 を基に拡張されています。

このプロジェクトについて

作者:HelemaZuba。コミュニティプロジェクトは作者が保守し、対応状況は利用するバージョンに依存します。

ソースと更新履歴 ↗
NOTE4 · モノクロAI にインストールを頼む →

プロジェクト情報は support@zectrix.com に送信され、審査後に掲載されます。メールアドレスは投稿に関する連絡にのみ使用します。