Скин Wallpaper Engine для Codex

English | 简体中文

Плагин Codex, который использует совместимые медиафайлы из установленных проектов Wallpaper Engine в качестве фона самого приложения Codex. Он не меняет обои рабочего стола Windows и не требует DSH или Cordis.

Происхождение проекта: эта редакция Codex разработана на основе оригинальной интеграции DSH Wallpaper Engine из этого репозитория. С тех пор среда выполнения была переписана специально для Codex; прежние артефакты DSH/Cordis сохранены в истории Git, а не в текущем дистрибутиве. См. NOTICE.md.

Как это работает

Плагин обнаруживает локальные проекты Steam/Wallpaper Engine, безопасно встраивает совместимые медиафайлы и вставляет их за интерфейсом Codex через локальное подключение Chrome DevTools. Встроенный лаунчер запускает официальный установленный исполняемый файл Codex с отладкой, привязанной к 127.0.0.1; файлы Codex не пропатчиваются и не заменяются.

• Небольшие видеофайлы воспроизводятся как зацикленное видео, если они укладываются в безопасный лимит встроенных медиафайлов.

• Видео размером более 48 МБ автоматически кэшируются как MP4-файлы полной длительности с ограничением 2560×1440, 30 FPS и примерно 10 Мбит/с. Кэшированные результаты используются повторно; выходные файлы, всё ещё превышающие 512 МБ, заменяются декодированной анимационной последовательностью. Проекты Web, Scene или Application используют своё изображение предпросмотра.

• Доступ CDP ограничен точным URL главной страницы Codex app://-/index.html; вкладки браузера, WebView, страницы входа, HTTPS-страницы и другие цели отладки никогда не проверяются и не изменяются.

• Внедрённая панель «皮肤调整» позволяет переключаться между локальными видеопроектами и управляет режимом подгонки, масштабом, положением, непрозрачностью панели, затемнением и размытием.

• При переключении видео отображается индикатор подготовки без определения прогресса во время транскодирования и измеряемый прогресс 0–100% во время передачи; успех окрашивается в зелёный, а сбой — в красный.

• Видео и покадровая анимация автоматически приостанавливаются, когда Codex не в фокусе, свёрнут или скрыт, и возобновляются, когда Codex становится активным.

• Транскодированные файлы хранятся в %LOCALAPPDATA%\CodexWallpaperEngineSkin\transcoded; исходные проекты Wallpaper Engine никогда не изменяются.

• Выбранный скин и настройки регулировки сохраняются в %LOCALAPPDATA%\CodexWallpaperEngineSkin. Завершение задачи больше не удаляет слой, а экземпляр Codex, запущенный с помощью встроенного лаунчера, автоматически восстанавливает последний включённый скин. codex_skin_remove удаляет слой и очищает сохранённую настройку.

Динамические фоны являются экспериментальными: поддерживаемые настройки внешнего вида Codex охватывают цвета, шрифты, контраст и полупрозрачность, но в настоящее время не предоставляют публичную точку расширения для фоновых медиафайлов. Плагин также может генерировать нативную строку цветовой темы codex-theme-v1 в качестве поддерживаемого запасного варианта.

Related MCP server: Codex Image Control MCP Server

Быстрая установка и использование

Этот репозиторий является корнем плагина. Он требует 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 и применить один из них.

Лаунчер отказывается продолжать работу, пока Codex уже запущен. Обычный запуск Codex не имеет конечной точки отладки и не может принять динамический скин; это остаётся необходимым, поскольку Codex не предоставляет публичный API фоновых изображений. Чтобы использовать другой порт отладки loopback, передайте -Port лаунчеру и установите CODEX_SKIN_CDP_PORT в то же значение для процесса плагина.

Разработчики также могут клонировать репозиторий, вручную зарегистрировать его в локальном маркетплейсе Codex и запустить scripts/launch-codex-with-skin.ps1 напрямую.

Примеры запросов

• «Покажи проекты Wallpaper Engine, которые я могу использовать как скин Codex.»

• «Примени фон Neon City к Codex с большей прозрачностью.»

• «Удали скин Codex.»

• «Сгенерируй тёмную нативную тему Codex с синим акцентом.»

Если обнаружение источников не удаётся, установите WALLPAPER_ENGINE_HOME в каталог Wallpaper Engine или установите WALLPAPER_ENGINE_STEAM_ROOT в корень Steam.

Разработка

npm run verify

MCP-сервер взаимодействует через JSON-RPC по stdio. Проекты Wallpaper Engine доступны только для чтения; произвольные пути к медиафайлам не принимаются.

Структура репозитория

Устаревшие пакеты DSH, патчи Cordis, сгенерированные артефакты lib/ и встроенные архивы типов намеренно исключены из текущего дистрибутива Codex.

Лицензия

MIT. См. NOTICE.md о происхождении проекта. Wallpaper Engine и содержимое установленных проектов принадлежат их соответствующим владельцам.