Wallpaper Engine Skin for Codex

English | 简体中文

Ein Codex-Plugin, das kompatible Medien aus installierten Wallpaper-Engine-Projekten als Hintergrund der Codex-App selbst verwendet. Es ändert nicht den Windows-Desktop-Hintergrund und benötigt weder DSH noch Cordis.

Projektlinie: Diese Codex-Edition wurde aus der ursprünglichen DSH-Wallpaper-Engine-Integration des Repositorys entwickelt. Die Laufzeit wurde seitdem speziell für Codex neu geschrieben; die früheren DSH/Cordis-Artefakte sind in der Git-Historie erhalten, nicht in der aktuellen Distribution. Siehe NOTICE.md.

So funktioniert es

Das Plugin erkennt lokale Steam-/Wallpaper-Engine-Projekte, bettet kompatible Medien sicher ein und fügt sie über eine lokale Chrome-DevTools-Verbindung hinter der Codex-Oberfläche ein. Der gebündelte Launcher startet die offizielle installierte Codex-Datei mit Debugging, das an 127.0.0.1 gebunden ist; keine Codex-Dateien werden gepatcht oder ersetzt.

• Kleine Videodateien werden als Endlosschleife gerendert, wenn sie in das sichere Inline-Medienlimit passen.

• Videos über 48 MB werden automatisch als MP4-Dateien mit voller Dauer zwischengespeichert, begrenzt auf 2560×1440, 30 FPS und etwa 10 Mbit/s. Zwischengespeicherte Ergebnisse werden wiederverwendet; Ausgaben, die immer noch über 512 MB liegen, fallen auf eine dekodierte Animationssequenz zurück. Web-, Szenen- oder Anwendungsprojekte verwenden ihr Vorschaubild.

• Der CDP-Zugriff ist auf die exakte Codex-Hauptseiten-URL app://-/index.html beschränkt; Browser-Tabs, WebViews, Anmeldeseiten, HTTPS-Seiten und andere Debug-Ziele werden nie untersucht oder modifiziert.

• Das injizierte Bedienfeld „皮肤调整“ kann zwischen lokalen Videoprojekten wechseln und steuert den Anpassungsmodus, Zoom, Position, Panel-Transparenz, Abdunklung und Unschärfe.

• Beim Videowechsel wird während der Transkodierung eine unbestimmte Vorbereitungsleiste angezeigt und während der Übertragung ein gemessener Fortschritt von 0–100 %; Erfolg wird grün, Fehler rot.

• Video- und Frame-Animationen pausieren automatisch, wenn Codex nicht fokussiert, minimiert oder ausgeblendet ist, und werden fortgesetzt, wenn Codex wieder aktiv wird.

• Transkodierte Dateien werden unter %LOCALAPPDATA%\CodexWallpaperEngineSkin\transcoded gespeichert; Quell-Wallpaper-Engine-Projekte werden nie verändert.

• Das ausgewählte Skin und die Anpassungseinstellungen werden unter %LOCALAPPDATA%\CodexWallpaperEngineSkin gespeichert. Das Beenden einer Aufgabe entfernt die Ebene nicht mehr, und eine mit dem gebündelten Launcher gestartete Codex-Instanz stellt das zuletzt aktivierte Skin automatisch wieder her. codex_skin_remove entfernt die Ebene und löscht die gespeicherte Einstellung.

Dynamische Hintergründe sind experimentell: Die unterstützten Darstellungseinstellungen von Codex decken Farben, Schriftarten, Kontrast und Transluzenz ab, bieten aber derzeit keinen öffentlichen Erweiterungspunkt für Hintergrundmedien. Das Plugin kann auch einen nativen codex-theme-v1-Farbthemen-String als unterstützten Fallback generieren.

Related MCP server: ae-agent-lab-demo

Schnellinstallation und Verwendung

Dieses Repository ist die Plugin-Wurzel. Es erfordert Node.js 22 oder neuer und verwendet nur Node.js-Built-ins, daher ist npm install nicht erforderlich.

Fügen Sie diese Zeile in PowerShell ein:

$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

Das Installationsprogramm lädt das Repository herunter oder aktualisiert es, registriert den persönlichen Codex-Marketplace-Eintrag, installiert das Plugin und erstellt eine Verknüpfung Codex Wallpaper Skin auf dem Desktop und im Startmenü. Führen Sie denselben Befehl später erneut aus, um zu aktualisieren.

Wenn normales Codex bereits ausgeführt wird, fragt die Verknüpfung, ob es mit Skin-Unterstützung neu gestartet werden soll. Es schließt nicht mehr still; die Wahl von Nein lässt die aktuelle Aufgabe unberührt.

Nach der Installation:

1. Schließen Sie alle Codex-Fenster.

2. Starten Sie Codex Wallpaper Skin über den Desktop oder das Startmenü.

3. Bitten Sie in einer neuen Codex-Aufgabe darum, kompatible Wallpaper-Engine-Skins aufzulisten und eines anzuwenden.

Der Launcher weigert sich fortzufahren, während Codex bereits ausgeführt wird. Ein normaler Codex-Start hat keinen Debug-Endpunkt und kann kein dynamisches Skin akzeptieren; dies bleibt notwendig, da Codex keine öffentliche Hintergrundbild-API bereitstellt. Um einen anderen Loopback-Debug-Port zu verwenden, übergeben Sie -Port an den Launcher und setzen Sie CODEX_SKIN_CDP_PORT auf denselben Wert für den Plugin-Prozess.

Entwickler können das Repository auch klonen, es manuell in einem lokalen Codex-Marketplace registrieren und scripts/launch-codex-with-skin.ps1 direkt ausführen.

Beispielanfragen

• „Zeige Wallpaper-Engine-Projekte, die ich als Codex-Skin verwenden kann.“

• „Wende den Neon-City-Hintergrund mit mehr Transparenz auf Codex an.“

• „Entferne das Codex-Skin.“

• „Generiere ein dunkles natives Codex-Theme mit blauem Akzent.“

Wenn die Quellenermittlung fehlschlägt, setzen Sie WALLPAPER_ENGINE_HOME auf das Wallpaper-Engine-Verzeichnis oder WALLPAPER_ENGINE_STEAM_ROOT auf das Steam-Root.

Entwicklung

npm run verify

Der MCP-Server kommuniziert über JSON-RPC über stdio. Wallpaper-Engine-Projekte sind schreibgeschützt; beliebige Medienpfade werden nicht akzeptiert.

Repository-Struktur

Legacy-DSH-Bundles, Cordis-Patches, generierte lib/-Artefakte und eingebettete Typarchive sind absichtlich von der aktuellen Codex-Distribution ausgeschlossen.

Lizenz

MIT. Siehe NOTICE.md für die Projektlinie. Wallpaper Engine und installierte Projektinhalte gehören ihren jeweiligen Eigentümern.