AI Blackhole ディレクター は何をしますか?
このスキルは、ユーザーがローカルの AI Blackhole Studio パノラマディレクターセッションを操作するのを支援します。
エントリポイント
デフォルトのワークフローはローカルです:
scripts/local_import.pyを使用して、ローカル画像を一時的なローカルディレクターセッションにコピーします。- ローカル静的サーバーを起動します。
- 生成された
http://127.0.0.1:<port>/panorama-viewer.html?image=...URL を開きます。
このスキルには、assets/panorama-director-deploy-v1.2.zip に director パッケージが含まれています。--web-dir が指定されない場合、ヘルパーはこのバンドルされたパッケージを展開して使用できます。
このスキルのデフォルトパスとして https://aiblackhole.net/panorama-viewer を使用しないでください。パブリックサイトは診断または共有の参照用として残すことができますが、ローカルデプロイが主要なモードです。
コアワークフロー
- ユーザーがローカル画像パスを指定した場合、
references/local-import.mdを読み、scripts/local_import.pyを実行します。 - ブラウザ制御が利用可能な場合はヘルパー出力URLをブラウザで開き、利用できない場合はユーザーにURLを提供します。
- ブラウザ制御が利用可能な場合、ページが読み込まれ、
document.bodyにpanorama-loadedクラスがあることを確認します。 - ユーザーの次のタスクを特定します:
- ディレクターを使用する
- 機能を学ぶ
- ローカルディレクターファイルをカスタマイズまたはパッケージ化する
- 機能ガイダンスについては、
references/feature-guide.mdを読んでください。 - ローカルサーバー、アセット、画像、ルート、またはブラウザの問題については、
references/troubleshooting.mdを読んでください。 - 指示は実用的でユーザー向けに保ってください。画像の自動開封にはローカルヘルパーを優先してください。
ローカル画像インポート
ユーザーがローカル画像パスを指定し、自動的に開きたい場合は、次を使用します:
python <skill-dir>/scripts/local_import.py "<image-path>" --open
ユーザーが画像なしでローカルディレクターをデプロイ/開封したいだけの場合は、次を使用します:
python <skill-dir>/scripts/local_import.py --open
ユーザーが明示的にカスタムディレクターWebフォルダーを使用したい場合にのみ、--web-dir を渡してください。
ヘルパー出力URLを使用してローカルセッションを開きます。画像は一時的なローカルWebセッションにコピーされ、公開ウェブサイトにアップロードされないことを説明します。
ブラウザチェック
ブラウザ制御が利用可能な場合、以下を確認します:
- 生成されたローカルURLが読み込まれること。
- アップロード/インポートされた画像名がファイルメタデータ領域に表示されること。
- 読み込み後に空のアップロード状態が非表示になっていること。
document.body.dataset.viewModeがパノラマ画像の場合はpanorama、通常画像の場合はflatであること。- 主要操作が機能すること:キャラクター追加、オブジェクト追加、オクルーダー追加、選択変形、サイドバー表示/非表示、スクリーンショット保存。
オプションのパブリック参照
過去の公開URLは次のとおりです:
https://aiblackhole.net/panorama-viewer
自動ローカルファイルインポートには使用しないでください。公開ウェブページは任意のローカルファイルパスを読み取ることができません。代わりにローカルヘルパーを使用してください。
トラブルシューティングの順序
ローカルセッションの場合、以下を確認します:
- ローカルサーバープロセスが実行中であること。
- 生成された
imports/<image>URL が HTTP 200 を返すこと。 panorama-viewer.htmlとpanorama-director.jsがローカルWebフォルダーに存在すること。- ポートが以前のセッションで占有されていないこと。
- 画像の読み込みに失敗する場合のブラウザコンソール/ネットワークエラー。
禁止事項
- ローカルファイルを公開サイトに強制的にアップロードしないでください。
- このスキルのデフォルトパスとして公開ウェブサイトを使用しないでください。
- 明示的なユーザーの承認なしにライブデプロイを変更しないでください。
- サーバープロセス、ポート、ルート、アセットパス、ブラウザコンソールの基本を確認する前に、ローカル読み込みエラーがアプリによって引き起こされたと想定しないでください。