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 파일은 패치되거나 교체되지 않습니다.

• 작은 비디오 파일은 안전한 인라인 미디어 제한에 맞으면 반복 비디오로 렌더링됩니다.

• 48MB가 넘는 비디오는 2560×1440, 30 FPS, 약 10Mbps로 제한된 전체 길이 MP4 파일로 자동 캐시됩니다. 캐시된 결과는 재사용됩니다. 그래도 512MB가 넘는 출력은 디코딩된 애니메이션 시퀀스로 폴백됩니다. Web, Scene 또는 Application 프로젝트는 미리보기 이미지를 사용합니다.

• CDP 액세스는 정확한 Codex 메인 페이지 URL app://-/index.html로 허용 목록이 제한됩니다. 브라우저 탭, WebView, 로그인 페이지, HTTPS 페이지 및 기타 디버그 대상은 절대 검사하거나 수정하지 않습니다.

• 주입된 “皮肤调整” 패널은 로컬 비디오 프로젝트 간 전환과 맞춤 모드, 확대/축소, 위치, 패널 불투명도, scrim, 흐림을 제어합니다.

• 비디오 전환 중에는 트랜스코딩 동안 진행률이 없는 준비 막대가 표시되고, 전송 중에는 0–100% 진행률이 측정되어 표시됩니다. 성공하면 녹색, 실패하면 빨간색으로 변합니다.

• Codex가 포커스되지 않거나 최소화되거나 숨겨져 있으면 비디오 및 프레임 애니메이션이 자동으로 일시 중지되고, Codex가 활성화되면 다시 재개됩니다.

• 트랜스코딩된 파일은 %LOCALAPPDATA%\CodexWallpaperEngineSkin\transcoded에 저장됩니다. 원본 Wallpaper Engine 프로젝트는 절대 수정되지 않습니다.

• 선택한 스킨과 조정 설정은 %LOCALAPPDATA%\CodexWallpaperEngineSkin 아래에 유지됩니다. 작업을 종료해도 레이어가 더 이상 제거되지 않으며, 번들 런처로 시작한 Codex 인스턴스는 마지막으로 활성화된 스킨을 자동으로 복원합니다. codex_skin_remove는 레이어를 제거하고 저장된 기본 설정을 지웁니다.

동적 배경은 실험적입니다. Codex가 지원하는 Appearance 설정은 색상, 글꼴, 대비, 반투명도를 다루지만 현재 공용 배경 미디어 확장 지점을 제공하지 않습니다. 플러그인은 지원되는 폴백으로 네이티브 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를 제공하지 않기 때문에 이는 여전히 필요합니다. 다른 루프백 디버그 포트를 사용하려면 런처에 -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 및 설치된 프로젝트 콘텐츠는 각 소유자에게 귀속됩니다.