Pro
日本語
サインインアカウント Mac版をダウンロード
Mac版をダウンロード

ヘルプ / インストールとトラブルシューティング

トラブルシューティング

お使いのMacで動きますか? すべてのApple Silicon Macのメモリ、チップ、ディスク容量、レンダリング時間を1ページにまとめました。

Phospheneはレンダリングを拒否するとき、その理由と対処法を表示します。ここでは、実際によく表示されるメッセージを取り上げます。インストールやアップデート中の問題(Pinokioの FATAL error: 行、ディスク容量不足)については、インストール、更新、ディスク容量をご覧ください。

メモリとこのMacのティア

ヘッダーのヘルスチップで、メモリの状況がひと目でわかります。クリックすると、ティア、メモリ、ヘルパー、モデル、キュー、レンダリングの各行が表示されます。ティアをクリックすると、このMacで何が動かせるかを確認できます。

  • 「ヘルパーがOSに強制終了されました: メモリ不足」:macOSがレンダリングを止めました。メモリを多く使うアプリ(ブラウザ、Slack、iOSシミュレータなど)を閉じてもう一度試すか、画質をクイックに切り替えてください。クイックは使用メモリが約半分で済みます。
  • 「画像の事前チェック: … にはNGBのMacが必要です」:その画像エンジンはこのMacには収まりません。メモリ16 GB以下のMacでは、設定のエンジンがより大きなMacを必要とする場合、自動が設定を変えずにFLUX.2 [klein] 4Bを使います。これは参照画像なしのレンダリングが条件です。自動にKleinを使わせるには参照画像を外すか、設定でもっと軽いエンジンを選んでください。*「… に約NGBの空きが必要です」*は、エンジン自体は収まるものの、現在メモリが使われていることを意味します。このチェックでは、macOSが解放できるメモリと、自動が実際に必要とするメモリも考慮されるようになりました。
  • 「学習には24 GB以上のメモリが必要です」:このMacではキャラクターの学習は実行できません。

16〜60 GBのMacでのHailuo H3

H3のフルエンジンには60 GBが必要です。16 GBからは、コンパクトなQ8エンジンで動作します。このエンジンはMac上で一度だけビルドされます(36 GB未満では、レンダリング中にドライブからモデルを読み込みます)。

  • H3がまだインストールされていない場合: Pinokioのサイドバーで Phosphene を開き、Install Hailuo H3 (second video engine, ~75 GB) をクリックします。インストールの最後にコンパクトエンジンが自動でビルドされます(さらに約5分)。
  • H3はインストール済みで、コンパクトエンジンがない場合 「Hailuo H3はこのMacで動作します: メモリ節約モードで … まだビルドされていません」:同じサイドバーの Build Hailuo H3 compact engine をクリックします(約5分、ダウンロードなし)。

どちらの項目も、パネルの実行中はサイドバーに表示されます。

実行したら、設定の Hailuo H3 モデル で「自動」または「コンパクト」を選んでください。16 GB未満ではH3は使えません。すべてのモードに対応しているLTXでレンダリングしてください。

モデルやアドオンがダウンロードされていない

  • 「強化には言語モデルのGemma 3(8.1 GB)が必要です」(アダプターについても同様):新規インストールでは、最初のスタートのあとにバックグラウンドでダウンロードされます。メッセージには、ダウンロード中、待機中、ディスク空き待ちのどれかが表示されます。今すぐダウンロードを押すと、すぐに取得します。
  • 「延長にはLTX-2.5 Highアドオン(Q8モデル)が必要ですが、このMacにはまだダウンロードされていません」:キーフレームとハイ画質でも同様です。モデルウィンドウからインストールしてください(ヘルスチップをクリックして、モデルを選びます)。
  • 「アップスケール&フェイス修正にはLTX-2.5 Pixel Spatial Upscalerアダプターが必要です」:モデルウィンドウからダウンロードし、もう一度レンダリングしてください。
  • 「レンダリング前に停止しました: モデルのウェイトが不完全です」:ダウンロードが中断されました。モデルウィンドウを開いて再開してください。設定のモデルファイルを検証はすべてのファイルを確認し、壊れているものがあれば再ダウンロードを案内します。

アップデートがすぐ止まる

一部のMacでは、4.19.7より前のバージョンのPinokioのアップデートが、最初の1秒で止まりました。Pinokioのターミナルが、アップデート自身のコマンド内の「error:」という文字列をエラーと誤認したためです(#114)。Pinokioは今お使いのバージョンのアップデートスクリプトを実行するので、修正が効くのは一度アップデートしたあとになります。

代わりにPhosphene内からアップデートしてください。アップデートのバナー(またはヘッダーのバージョン表示)の今すぐアップデートをクリックし、アップデート完了と表示されるまで待ってから再起動します。または、Phospheneフォルダ(~/pinokio/api/<your Phosphene folder>)でターミナルを開いて git pull を実行し、Pinokioでもう一度アップデートを押してください。修正済みの新しいスクリプトが実行されます。それ以降は、ボタンが正常に動作します。

「アップデートを押してください」: パネルより古いエンジン

「このインストールのエンジンはLTX-2.5のテキストエンコーダーより古いものです … アップデートを押してください。最初のクリックでパネルだけが動いた場合は、もう一度押してください。」

パネルは更新されたものの、その下のエンジンが更新されていません。PinokioのPhospheneサイドバーでアップデートをクリックしてください。何も変わらないようなら、もう一度クリックします。古いバージョンが始めたアップデートは、まず自分自身を更新するためです。H3の場合、*「インストール済みのHailuo H3ランナーはこのパネルより古いです」*と出たら、Install Hailuo H3 をもう一度実行してください。ディスク上のウェイトはすべて保持されます。

アップデートしたのにパネルが古いバージョンのように動くなら、まだ古いコードで動いています。その場合、ヘッダーのバージョン表示がPhospheneを再起動になります。それをクリックするか、Pinokioで停止してからスタートしてください。

GPUウォッチドッグ

「macOSのGPUウォッチドッグがMetalコマンドバッファを強制終了しました」:実行時間が長すぎたGPUタスクを、macOS自身が止めました。これはドライバレベルの強制終了で、Phospheneのバグではなく、M1とM2のMacで特によく起こります。Phospheneは同じジョブを、短いGPUステップ(GPU処理を小さく区切るため、少し遅くなります)で、すぐに一度だけやり直します。そのサイズは記憶され、このMacでの次回のレンダリングも短いステップで始まり、キューの行にもそう表示されます。短いステップでもmacOSに止められた場合、そのサイズはこのMacで24時間(または次のアップデートまで)一時停止され、カードに小さいサイズで再試行が表示されます。繰り返し起こる場合、メッセージにGitHubのissueへのリンクが表示されます。チップ、macOSのバージョン、クラッシュログがあると、とても助かります。

キャラクターの学習が失敗した

「training exited with code 1」:学習が完了する前に終了しました。本当の原因はログタブで確認してください。メモリ不足による強制終了(RAMの多いMacに切り替えるか、あれば小さいプリセットを使います)、LTX-2.3の学習用ダウンロードの不足(学習タブの事前チェックカードからダウンロードできます)、非常に長いキャプションでのキャプションエンコードのタイムアウトなどが考えられます。24 GB未満での学習は必ず失敗します。そのMacでは実行できません。

パネルがオフラインと表示される

*「Phosphene offline」*と表示され、生成を押しても何も起こらない場合、パネルのプロセスが応答していません。入力していた内容は失われません。プロンプトはそのまま残り、パネルが再び動き出すと、ページは自動で再接続してキューを再開します。数秒たっても戻らない場合は、PinokioのPhospheneサイドバーから起動してください。

キューが自動で一時停止した

「キューを一時停止しました: 直近のNレンダリングが同じ原因で失敗しました」:同じ問題で3回連続してレンダリングが失敗すると、Phospheneは、再試行しても直らない問題でキューの残りを消費し続けるのをやめます。メッセージが示す原因を直してから再開を押してください。残りを破棄してやり直すならキューをクリアを押します。

再起動後のキュー

パネルを再起動すると、キューは再開されます。パネルが止まったときに一時停止していたキューは、自動でまた動き出し、ログにもそう記録されます。

ログの読み方

下部パネルのログタブには、レンダリングのログが表示されます。レンダリングが異常終了したとき、step: で始まる最後の行が到達したステージを示します。この行は、報告に含めると最も役立つ情報です。Pinokioのターミナルにも同じ出力が表示されます。

問題を報告する

ヘッダーのバグボタンからバグを報告を開きます。何が起きましたか?に一、二文で書いてください(10文字以上必要です。ログからはあなたが見たものまでは分かりません)。バージョン、Macの詳細、直近のログ(エラー行は通常の行より前に配置)が自動で入力され、GitHubのissueが新しいタブで開くので、仕上げて送信してください。そこで送信するまで、何も送られません。issueは github.com/mrbizarro/phosphene/issues にあります。

出典:webapp/docs/troubleshooting.md(公開リポジトリ)。公開前にこのウェブサイト向けに確認済みです。英語の原文から翻訳しています。編集を提案する。