Skin de Wallpaper Engine para Codex

Inglés | 简体中文

Un plugin de Codex que usa medios compatibles de proyectos instalados de Wallpaper Engine como fondo de la propia aplicación de Codex. No cambia el fondo de escritorio de Windows y no requiere DSH ni Cordis.

Linaje del proyecto: esta edición de Codex se desarrolla a partir de la integración original de DSH Wallpaper Engine del repositorio. El runtime se ha reescrito desde entonces específicamente para Codex; los artefactos anteriores de DSH/Cordis se conservan en el historial de Git, no en la distribución actual. Ver NOTICE.md.

Cómo funciona

El plugin descubre proyectos locales de Steam/Wallpaper Engine, incrusta de forma segura los medios compatibles y los inserta detrás de la interfaz de Codex a través de una conexión local de Chrome DevTools. El lanzador incluido inicia el ejecutable oficial instalado de Codex con depuración vinculada a 127.0.0.1; no se parchean ni reemplazan archivos de Codex.

• Los archivos de video pequeños se renderizan como video en bucle cuando caben dentro del límite seguro de medios en línea.

• Los videos de más de 48 MB se almacenan automáticamente en caché como archivos MP4 de duración completa limitados a 2560×1440, 30 FPS y aproximadamente 10 Mbps. Los resultados en caché se reutilizan; las salidas que aún superen los 512 MB recurren a una secuencia de animación decodificada. Los proyectos Web, Scene o Application usan su imagen de vista previa.

• El acceso CDP está permitido solo para la URL exacta de la página principal de Codex app://-/index.html; las pestañas del navegador, WebViews, páginas de inicio de sesión, páginas HTTPS y otros objetivos de depuración nunca se inspeccionan ni modifican.

• El panel “皮肤调整” inyectado puede cambiar entre proyectos de video locales y controla el modo de ajuste, zoom, posición, opacidad del panel, scrim y desenfoque.

• El cambio de video muestra una barra de preparación indeterminada durante la transcodificación y un progreso medido del 0–100% durante la transferencia; el éxito se vuelve verde y el fallo rojo.

• El video y la animación de fotogramas se pausan automáticamente cuando Codex no está enfocado, minimizado u oculto, y se reanudan cuando Codex vuelve a estar activo.

• Los archivos transcodificados se almacenan en %LOCALAPPDATA%\CodexWallpaperEngineSkin\transcoded; los proyectos fuente de Wallpaper Engine nunca se modifican.

• El skin seleccionado y los ajustes de configuración persisten en %LOCALAPPDATA%\CodexWallpaperEngineSkin. Finalizar una tarea ya no elimina la capa, y una instancia de Codex iniciada con el lanzador incluido restaura automáticamente el último skin habilitado. codex_skin_remove elimina la capa y borra la preferencia guardada.

Los fondos dinámicos son experimentales: los ajustes de Apariencia compatibles de Codex cubren colores, fuentes, contraste y translucidez, pero actualmente no ofrecen un punto de extensión público para medios de fondo. El plugin también puede generar una cadena de tema de color nativo codex-theme-v1 como respaldo compatible.

Related MCP server: ae-agent-lab-demo

Instalación y uso rápido

Este repositorio es la raíz del plugin. Requiere Node.js 22 o superior y solo usa los módulos integrados de Node.js, por lo que npm install no es necesario.

Pegue esta línea en 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

El instalador descarga o actualiza el repositorio, registra la entrada del marketplace personal de Codex, instala el plugin y crea un acceso directo Codex Wallpaper Skin en el escritorio y en el menú Inicio. Ejecute el mismo comando nuevamente más tarde para actualizar.

Si Codex normal ya está en ejecución, el acceso directo pregunta si se debe reiniciar con soporte de skin. Ya no se cierra silenciosamente; elegir No deja la tarea actual intacta.

Después de la instalación:

1. Cierre todas las ventanas de Codex.

2. Inicie Codex Wallpaper Skin desde el escritorio o el menú Inicio.

3. En una nueva tarea de Codex, pida listar los skins compatibles de Wallpaper Engine y aplique uno.

El lanzador se niega a continuar mientras Codex ya esté en ejecución. Un inicio normal de Codex no tiene un punto final de depuración y no puede aceptar un skin dinámico; esto sigue siendo necesario porque Codex no expone una API pública de imagen de fondo. Para usar otro puerto de depuración de loopback, pase -Port al lanzador y establezca CODEX_SKIN_CDP_PORT al mismo valor para el proceso del plugin.

Los desarrolladores también pueden clonar el repositorio, registrarlo manualmente en un marketplace local de Codex y ejecutar scripts/launch-codex-with-skin.ps1 directamente.

Ejemplos de solicitudes

• “Muestra proyectos de Wallpaper Engine que pueda usar como skin de Codex.”

• “Aplica el fondo Neon City a Codex con más transparencia.”

• “Elimina el skin de Codex.”

• “Genera un tema nativo oscuro de Codex con acento azul.”

Si falla el descubrimiento de fuentes, establezca WALLPAPER_ENGINE_HOME al directorio de Wallpaper Engine, o establezca WALLPAPER_ENGINE_STEAM_ROOT a la raíz de Steam.

Desarrollo

npm run verify

El servidor MCP se comunica mediante JSON-RPC sobre stdio. Los proyectos de Wallpaper Engine son de solo lectura; no se aceptan rutas de medios arbitrarias.

Estructura del repositorio

Los paquetes DSH heredados, los parches de Cordis, los artefactos generados en lib/ y los archivos de tipos incrustados se excluyen intencionalmente de la distribución actual de Codex.

Licencia

MIT. Ver NOTICE.md para el linaje del proyecto. Wallpaper Engine y el contenido de los proyectos instalados pertenecen a sus respectivos propietarios.