Codex 用 Wallpaper Engine スキン

English | 简体中文

インストール済みの Wallpaper Engine プロジェクトから取得した互換性のあるメディアを、Codex アプリ自体の背景として使用する Codex プラグインです。Windows デスクトップの壁紙は変更せず、DSH や Cordis も必要としません。

プロジェクトの系譜: この Codex エディションは、このリポジトリのオリジナルの DSH Wallpaper Engine 統合から開発されました。その後、ランタイムは Codex 専用に書き直されており、旧 DSH/Cordis の成果物は現在の配布物ではなく Git 履歴に保持されています。NOTICE.md を参照してください。

動作の仕組み

このプラグインは、ローカルの Steam/Wallpaper Engine プロジェクトを探索し、互換性のあるメディアを安全に埋め込み、ローカルの Chrome DevTools 接続を介して Codex UI の背後に挿入します。同梱のランチャーは、インストール済みの公式 Codex 実行ファイルを、デバッグを 127.0.0.1 にバインドして起動します。Codex のファイルがパッチ適用または置き換えられることはありません。

• 安全なインラインメディアの上限に収まる小さな動画ファイルは、ループ動画としてレンダリングされます。

• 48 MB を超える動画は、2560×1440、30 FPS、約 10 Mbps に制限された全尺の MP4 ファイルとして自動的にキャッシュされます。キャッシュされた結果は再利用され、それでも 512 MB を超える出力は、デコードされたアニメーションシーケンスにフォールバックします。Web、Scene、Application プロジェクトはプレビュー画像を使用します。

• CDP アクセスは、Codex のメインページ URL app://-/index.html のみに許可リストが適用されます。ブラウザタブ、WebView、ログインページ、HTTPS ページ、その他のデバッグターゲットが検査または変更されることは一切ありません。

• 注入された「皮肤调整」パネルは、ローカルの動画プロジェクトを切り替えたり、フィットモード、ズーム、位置、パネルの不透明度、スクリム、ぼかしを制御したりできます。

• 動画の切り替えでは、トランスコード中に不確定な準備バーが表示され、転送中は 0–100% の測定された進行状況が表示されます。成功すると緑に、失敗すると赤に変わります。

• Codex がフォーカスを失っている間、最小化されている間、または非表示の間、動画とフレームアニメーションは自動的に一時停止し、Codex がアクティブになると再開します。

• トランスコードされたファイルは %LOCALAPPDATA%\CodexWallpaperEngineSkin\transcoded に保存されます。元の Wallpaper Engine プロジェクトが変更されることはありません。

• 選択したスキンと調整設定は %LOCALAPPDATA%\CodexWallpaperEngineSkin に保持されます。タスクを終了してもレイヤーは削除されなくなり、同梱のランチャーで起動した Codex インスタンスは、最後に有効だったスキンを自動的に復元します。codex_skin_remove はレイヤーを削除し、保存された設定をクリアします。

動的背景は実験的な機能です。Codex がサポートする Appearance 設定は、色、フォント、コントラスト、半透明性をカバーしていますが、現在のところ公開された背景メディアの拡張ポイントは提供されていません。このプラグインは、サポートされているフォールバックとして、ネイティブの codex-theme-v1 カラーテーマ文字列を生成することもできます。

Related MCP server: ae-agent-lab-demo

クイックインストールと使用方法

このリポジトリがプラグインのルートです。Node.js 22 以降が必要で、Node.js の組み込みモジュールのみを使用するため、npm install は不要です。

この行を PowerShell に貼り付けてください:

$p = Join-Path $env:TEMP 'install-codex-wallpaper-skin.ps1'; Invoke-WebRequest 'https://raw.githubusercontent.com/JonathandNidhog/dsh-plugin-wallpaper-engine-codex/main/install.ps1' -OutFile $p; powershell -NoProfile -ExecutionPolicy Bypass -File $p

インストーラーは、リポジトリをダウンロードまたは更新し、個人用の Codex マーケットプレイスエントリを登録し、プラグインをインストールし、デスクトップとスタートメニューに Codex Wallpaper Skin ショートカットを作成します。後で同じコマンドを再度実行すると更新できます。

通常の Codex がすでに実行されている場合、ショートカットはスキンサポート付きで再起動するかどうかを確認します。黙って閉じることはなくなり、「いいえ」を選択すると現在のタスクはそのまま残ります。

インストール後:

1. すべての Codex ウィンドウを閉じます。

2. デスクトップまたはスタートメニューから Codex Wallpaper Skin を起動します。

3. 新しい Codex タスクで、互換性のある Wallpaper Engine スキンの一覧表示を依頼し、そのうち 1 つを適用します。

ランチャーは、Codex がすでに実行されている間は続行を拒否します。通常の Codex 起動にはデバッグエンドポイントがなく、動的スキンを受け付けることができません。Codex が公開の背景画像 API を提供していないため、この方法は引き続き必要です。別のループバックデバッグポートを使用するには、ランチャーに -Port を渡し、プラグインプロセスでは CODEX_SKIN_CDP_PORT に同じ値を設定してください。

開発者は、リポジトリをクローンしてローカルの Codex マーケットプレイスに手動で登録し、scripts/launch-codex-with-skin.ps1 を直接実行することもできます。

リクエスト例

• 「Codex スキンとして使用できる Wallpaper Engine プロジェクトを表示して。」

• 「Neon City の背景を、より透明にして Codex に適用して。」

• 「Codex スキンを削除して。」

• 「青いアクセントカラーのダークなネイティブ Codex テーマを生成して。」

ソースの探索が失敗した場合は、WALLPAPER_ENGINE_HOME に Wallpaper Engine のディレクトリを設定するか、WALLPAPER_ENGINE_STEAM_ROOT に Steam のルートを設定してください。

開発

npm run verify

MCP サーバーは、stdio を介した JSON-RPC で通信します。Wallpaper Engine プロジェクトは読み取り専用であり、任意のメディアパスは受け付けられません。

リポジトリ構成

レガシーな DSH バンドル、Cordis パッチ、生成された lib/ アーティファクト、埋め込まれた型アーカイブは、現在の Codex 配布物から意図的に除外されています。

ライセンス

MIT。プロジェクトの系譜については NOTICE.md を参照してください。Wallpaper Engine およびインストール済みプロジェクトのコンテンツは、それぞれの所有者に帰属します。