build-vesperfall-review-assets

Vesperfall レビューアセットの構築

カタログメディア、インポートしたファイル、プロシージャルファクトリー、将来のコントラクトを混同せず、レビュー可能なアセットのペアを1つ作成します。

ワークフロー

1. モデルのパスを選ぶ前に、リポジトリの実態を確認します。
   • 同梱されている PNG、FBX、GLB、テクスチャ、ランタイムファクトリー、および宣言済みだが存在しないパスを特定します。
   • 実際のランタイムソースである場合は、同梱の FBX／GLB を優先します。
   • 画像からコードで再構築する場合にのみ $img2threejs を使用します。インポートしたジオメトリを img2threejs として表記しないでください。
   • コードに将来の URL が宣言されているだけで、GLB やテクスチャが存在すると主張しないでください。
2. 透過カタログ用リファレンスを作成します。
   • 本番用ポートレートがすでにアセットの実体と一致する場合は、再利用するか、そこから派生させます。
   • プロジェクトのコントラクトで別途定められている場合を除き、カタログ用コピーを 512×512 RGBA に正規化します。
   • 角の透過を維持し、床、ハロー、影を焼き込まないでください。
   • プロジェクト固有の出力は public/asset-catalog/<category>/ に保存します。
3. ライブモデルのプレビューを構築します。
   • 読み込みとモデル構築は、アセット専用の小さなモジュールにまとめます。
   • userData にソースパスまたはファクトリー、アクション数、ソケット、レビュー専用かどうかを保持し、ランタイムの来歴を維持します。
   • 装備は名前付きソケットに取り付けます。マテリアル、レンダラー、ミキサー、イベント、アニメーションフレームは破棄可能にします。
   • 計測した境界ボックスに基づいてフレームを設定します。接地位置は最も低い武器の先端ではなく、足や接地ジオメトリを基準にします。
4. カタログ表示を組み合わせます。
   • カード／グリッド：キャンバスを使わず、透過 PNG のみを表示します。
   • 選択中のインスペクター：ライブモデルのキャンバスを1つ表示し、形式を正確に示します。
   • 独立したプレビューまたはムーブセットのルートへのボタンを追加します。
   • WebGL／モデルの読み込みが完了するまでは、フォールバックメディアを表示しておきます。
5. 独立したレビュー用ルートを構築します。
   • クリップが存在する場合は、実際のアクションライブラリを公開します。
   • 再起動、一時停止／再生、アクション選択、ドラッグ回転、ソースパス、来歴を用意します。
   • プロシージャルモーションでは、ランタイム、コントラクト、候補アクションを個別に明示します。
6. コミット前に検証します。
   • scripts/validate_pair.py <png> <model-source> を実行します。
   • 正確なパス、RGBA の寸法、プレビューの種類、ルートを対象とするインベントリテストを追加します。
   • アニメーションに伴って接地位置が変化する場合は、すべてのモーション／接地点を決定論的にテストします。
   • ビルド、Lint、全テスト、git diff --check を実行します。
   • Codex のアプリ内ブラウザーのみを使用します。デスクトップとモバイル、カードの PNG／キャンバスなし、インスペクターのモデル／キャンバス1つ、プレビューへのナビゲーション、接地、スクロール、オーバーフロー、メディアの読み込みエラー、コンソールの警告／エラーを検証します。
7. 対象を絞った作業をコミットし、デプロイ調整の前にその正確な SHA を引き継ぎます。

カタログの種類、来歴に関する表現、またはレビュー用ルートの動作を変更する場合は、references/catalog-contract.md を読んでください。

必須の報告事項

以下を報告してください。

• PNG のパス、寸法、アルファチャンネルの有無
• モデルのソースまたはプロシージャルファクトリー
• モデルがインポート済み、ランタイムプロシージャル、レビュー専用再構築のいずれか
• プレビューのルートと利用可能なアクション
• テスト／ビルド／ブラウザーでの検証結果
• 正確なコミット SHA