インストール後にテーマが表示されない
まず Dream Skin が実際に起動していることを確認してください。どちらのプラットフォームでも、インストールと起動は別の手順です。
次の順序で確認
- プラットフォーム用の起動コマンドまたはデスクトップランチャーをもう一度実行します。
- 必要に応じて検証スクリプトを実行し、結果を保持します。
- Codex が Dream Skin に記録されたローカル CDP ポートに接続していることを確認します。
- 機密値を公開せずに、対応している state/log ディレクトリを確認します。
- Codex 更新後は、再試行する前に互換性を比較します。
それでも解決しない場合： 注入マーカーまたは想定されるレンダラーターゲットがない場合は、復元してから、別の変更を試す前に上流の Issue を確認してください。
背景画像が表示されない
Codex UI を含むプレビュー用スクリーンショットではなく、純粋な背景アセットを選んだことを確認してください。
次の順序で確認
- 信頼できる JPG、PNG、WebP を使用します。macOS のローカルフローでは HEIC と TIFF も対応します。
- 2560 × 1440 を推奨し、異常に大きいファイルは縮小します。
- 準備後のファイルは 16 MB 以内、各辺 16384px 以内、5000 万画素以内にします。
- macOS では Customize、Windows ではトレイから画像を選び直します。
- 必要に応じて検証し、スクリーンショットを保持します。
それでも解決しない場合： このサイトで画像を変換またはアップロードしないでください。ローカルでのデコードに失敗する場合は、ソースの詳細を保持して上流を確認してください。
CPU 使用率が予想以上に高い
原因を決めつける前に、まず基本の外観へ復元し、CPU 使用率を比較してください。
次の順序で確認
- OS、Codex のバージョン、Dream Skin のコミット、影響を受けるルートを記録します。
- 復元して通常どおり Codex を再起動した後も問題が続くか確認します。
- 検証やリロードを繰り返すループは避けます。
- 現在の上流のパフォーマンス Issue を確認します。
それでも解決しない場合： このサイトがローカルの性能バグを修復することはできません。問題が Dream Skin に起因すると判断できる場合にのみ、伏せ字にした再現情報を共有してください。
config.toml の解析でインストールが停止した
複雑または複数行の TOML では、インストーラーの安全な拒否パスが発動することがあります。これは停止条件であり、ファイルを書き換えてよいという意味ではありません。
次の順序で確認
- config.toml を削除、空にする、作り直すことはしません。
- 複雑な TOML に正規表現による書き換えを適用しません。
- 正確なエラーを保持し、操作中にファイルが変更されたか記録します。
- プラットフォーム用に文書化された復元手順、または明示的なバックアップ復旧パスを使用します。
それでも解決しない場合： 伏せ字にしたエラーとともに上流の Issue を確認してください。API キー、Base URL、MCP シークレット、設定ファイル全体を公開してはいけません。
大きな画像が失敗する、またはメモリを使いすぎる
再試行前に元画像のサイズを縮小してください。非常に大きい画像や圧縮が特殊な画像では、デコード時に過剰なメモリを消費することがあります。
次の順序で確認
- 可能であれば 2560 × 1440 のマスターを書き出します。
- 一般的で信頼できる画像形式を使用します。
- ファイルサイズを減らし、準備後のアセットを 16 MB 未満に保ちます。
- 各辺を 16384px 未満、総画素数を 5000 万未満に保ちます。
- 出所不明または不審なファイルは避けます。
それでも解決しない場合： ローカルで引き続き失敗する場合も、このサイトへアップロードしないでください。上流で診断するため、機密でない寸法、形式、サイズだけを記録してください。
Codex 更新後にレイアウトが崩れた
まず復元してください。Dream Skin は変化するデスクトップレンダラーを対象とするため、アプリ更新後には上流側の互換性対応が必要になることがあります。
次の順序で確認
- プラットフォームの復元ワークフローを実行します。
- Codex の更新日を現在の上流リリースノートと比較します。
- 新しい互換バージョンがあるか上流リポジトリを確認します。
- 新しいスクリプトと変更内容を確認してから再インストールします。
それでも解決しない場合： 一時的な回避策として WindowsApps、app.asar、macOS のアプリバンドル、署名にパッチを当てないでください。
診断レポート用テンプレート
共有前にユーザー名、API キー、Base URL、トークン、非公開プロジェクトのパス、個人画像を削除してください。
Platform:
OS version:
Codex version:
Dream Skin commit/version:
Theme:
Install or start command used:
Verification command result:
Expected:
Actual:
Reproduction steps:
Sensitive values removed: yes/no問題の再現に必要な最小限の情報だけを共有してください。