単語学習

Local Push SDK を使って私の PC にローカルプログラムを構築し、単語学習の機能を接続して検証してください。
プロジェクトのリポジトリ：https://github.com/itopinion/zectrix-vocabulary
インストール説明：https://github.com/itopinion/zectrix-vocabulary/blob/main/README.md
情報確認日：2026-10-20、参照コミット：b0962e5ad5073cde9ea6aa59b6d3624cc47c5319。実行前に現行バージョンを再確認してください。
Local Push SDK：https://github.com/itopinion/zectrix-local-push-sdk
SDK API 文書：https://github.com/itopinion/zectrix-local-push-sdk/blob/main/docs/API.md
SDK 互換性一覧：https://github.com/itopinion/zectrix-local-push-sdk/blob/main/compatibility.json
必要環境：Local Push SDK · 単語リスト · ローカル ASR / TTS · NOTE4
接続方法：公開 SDK でローカルプログラムを作り、アプリの処理、描画、デバイスイベントを接続します。実行時には最新ソースのインターフェースと依存関係を確認します。
最初に現行 SDK の README、API 文書、互換性一覧を読んでください。SDK 0.1.0 は NOTE4 ファームウェア 3.7.2、400×300 のキャンバスに対応し、NOTE4C は対象外です。実際のデバイスを確認し、ファームウェアを自動更新しないでください。
1. OS とプロセッサーを確認し、既存の SDK とローカルプログラムがあれば互換性を確認して再利用します。なければ公開 SDK をクローンし、最新の README に従って Rust、C/C++ コンパイラー、CMake を用意し、パス依存でこの PC 向けにビルドします。
2. まず cargo test --locked と cargo check --locked --examples を実行します。デバイス選択、単一接続の管理、PNG 描画、イベント処理、設定保存、終了時の解放処理を実装します。SDK に既製のプラグインローダーはありません。
3. プラグインのソースを読み、処理ロジックを再利用して、描画、デバイスイベント、音声のインターフェースをローカルプログラムに移植します。必要な呼び出しインターフェースや互換レイヤーを実装し、依存名の置換だけで接続成功としないでください。
4. プラグインの要件に合わせ、描画、状態管理、ボタン操作、音声機能をローカルプログラムに実装し、機能ごとにテストします。完了した機能と実際に発生した問題を記録し、テスト結果に基づいて利用可能な範囲を報告してください。
5. NOTE4 と PC は相互通信できる LAN に接続します。SDK の案内に従って待機中の Wi-Fi 維持を有効にしてください。接続前に対象デバイスと他のプログラムによる使用状況を確認し、接続を奪わないでください。ローカル接続に ZECTRIX Cloud API Key は不要です。データソース用のキーはプラグインごとに設定します。
6. 元の 400×300 PNG を渡し、SDK で mono、gray4、gray16 に変換します。二重にディザリングしないでください。対話中は next_event() を継続して受け取り、終了時は close() を呼びます。自動再接続や接続の奪取を行わず、ResultUnknown を失敗と見なして画像や音声を再送しないでください。
7. SDK に ASR、TTS、大規模言語モデルは含みません。必要な音声バックエンドは別途設定します。再生は 16 kHz モノラル PCM16、録音はデバイスのボタンで開始します。初回送信はユーザーが対象とプレビューを確認してから行います。

このプロジェクトの接続手順：
1. SDK でローカルプログラムをビルド: 公開の Local Push SDK を取得し、OS に合わせて Rust とビルドツールを用意します。サンプルのビルドとローカルテストを通してから、デバイス接続と画面出力を実装します。現行 SDK は NOTE4 ファームウェア 3.7.2 に対応します。
2. 単語練習機能を接続: 単語リストと練習ロジックを再利用し、画面描画、ボタンによる録音、回答の再生をローカルプログラムに接続します。ASR と TTS は別途設定します。参照用の認識バックエンドは Apple Silicon / MLX を使うため、他の OS では移植が必要です。
3. 少数の単語から始める: 利用権のある単語リストを取り込み、教材と単元を選択します。ヒント、長押しスペリング、単語の読み上げ、解答例を確認してから、本番の単語帳を取り込みます。
初回検証：NOTE4 で中国語のヒント、アルファベットのスペリング、単語の読み上げ、解答例を一通り確認し、アプリを再起動しても単語帳が保持されることを検証します。
ビルド、プレビュー、デバイスの表示完了応答、実画面の確認を分けて報告します。起動、停止、アンインストール、更新の手順を示し、既存データを保持してください。対話型アプリは PC 上のプログラムの継続実行が必要です。
アカウント、キー、デバイスアドレス、個人データは端末上でのみ設定し、共有タスクやログに含めないでください。AI にローカル実行環境がなければ、ビルドと接続の計画を渡し、インストール済みとは報告しないでください。