Codex ペット

Local Push SDK を使って私の PC にローカルプログラムを構築し、Codex ペットの機能を接続して検証してください。
プロジェクトのリポジトリ：https://github.com/itopinion/zectrix-agent-pet
インストール説明：https://github.com/itopinion/zectrix-agent-pet/blob/main/README.md
情報確認日：2026-10-20、参照コミット：2c9213dda1063f6f8a19a4470eed0b367d14b6ef。実行前に現行バージョンを再確認してください。
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 · ローカル Agent の状態 · 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. ペットとタスク状態を接続: タスク状態とペットのロジックを再利用し、PNG 描画、ボタンでのページ切替、通知音をローカルプログラムで実装します。元のランタイム呼び出しを SDK に接続し、ローカル Codex のパスと状態取得方法を確認して、プライバシー設定を保持します。
3. ローカル Codex の追従を確認: 新規インストールではローカル Codex の追従が初期設定で有効になり、更新時は既存の設定を保持します。追従設定を確認し、テストタスクで作業中・待機中・完了の状態を確認します。必要に応じてアニメーションと音量を調整し、対応が必要な場合は該当 Agent のウィンドウに戻ります。
初回検証：テストと明示したタスクで作業中・待機中・完了を検証し、ページ送りと通知音を確認してください。デモ状態を実際のタスク進捗として扱わないでください。
ビルド、プレビュー、デバイスの表示完了応答、実画面の確認を分けて報告します。起動、停止、アンインストール、更新の手順を示し、既存データを保持してください。対話型アプリは PC 上のプログラムの継続実行が必要です。
アカウント、キー、デバイスアドレス、個人データは端末上でのみ設定し、共有タスクやログに含めないでください。AI にローカル実行環境がなければ、ビルドと接続の計画を渡し、インストール済みとは報告しないでください。