picture-backdrop

Fondo de imagen

El escritorio dibuja el fondo de un mod solo como una scene que el propio mod renderiza, y no dibuja ninguna imagen rasterizada en su interior. Por lo tanto, la imagen se traza a rutas vectoriales, se empaqueta bajo límites de tamaño estrictos y silenciosos, y la dibuja un mod pequeño. Lee references/limits.md antes de cambiar nada sobre cómo dibuja el mod; allí se enumera lo que se midió y lo que falla silenciosamente.

Flujo de trabajo

1. Obtén las imágenes. Una imagen, o una clara (día) y una oscura (noche). Un paisaje de alrededor de 1600x1000 funciona; la aplicación recorta con xMidYMid slice, así que mantén el sujeto alejado de la parte superior e inferior. El arte pictórico y suave se traza mucho mejor por carácter que el arte de cel con contornos; las fotos también funcionan. Si el usuario genera el arte, díselo antes de que lo haga.
2. Instala las herramientas en carpetas temporales (no en el mod):

   python -m pip install --target "$TMP/pb-vtracer" vtracer
   mkdir -p "$TMP/pb-svgo" && cd "$TMP/pb-svgo" && npm init -y >/dev/null && npm install svgo@4
   

3. Crea la carpeta del mod en ~/.claude/skills/<id>/ (se carga en cada sesión): copia assets/mod-template/, luego copia make-colors.js y make-colors.d.ts de la habilidad de creación de plugins en su hooks/, sin cambios. Rellena cada __PLACEHOLDER__ (__ID__ es el nombre de la carpeta, en minúsculas con guiones). Para una sola imagen, elimina la otra importación, su escena y aspecto, y apunta auto a la única imagen.
4. Observa la imagen y enumera sus regiones (recórtalas y míralas): el sujeto, la cara, las áreas de piel, cada lado. Escribe una configuración por imagen junto al mod (no dentro de hooks/), usando references/tracing.md para las opciones y configuraciones de región, y assets/example-night.json (una chica sentada a la derecha de una entrada) como modelo. Para un par, asigna a cada configuración "scheme" y ambos presupuestos: {"FULL": 259500, "HALF": 129500}; para una sola imagen solo FULL y sin scheme.
5. Traza, en segundo plano (la ejecución tarda unos minutos):

   python -I scripts/trace_scene.py night.json --vtracer "$TMP/pb-vtracer" --svgo "$TMP/pb-svgo" --preview "$TMP/pb-preview/night.html"
   

   Traza cada región en cada opción una vez, ajusta cada presupuesto (todas las regiones primero, luego detalle por prioridad), y escribe scene-<nombre>.ts. Apunta el out de la configuración a hooks/ del mod.
6. Previsualiza el HTML en el panel del navegador (sirve su carpeta con python -m http.server). Comprueba el sujeto con un recorte 2x, ya que la aplicación amplía la imagen. Arregla lo que parezca incorrecto con la tabla en tracing.md y vuelve a trazar.
7. Colores. Toma muestras de los colores de superficie de las imágenes (el tono dominante de la pared o el cielo; el modo oscuro debe permanecer oscuro) y ejecuta makeColors; su lista de problemas no debe tener ninguna entrada de "El escritorio no pintará".
8. Valida y entrega: claude plugin validate <carpeta del mod>. Dile al usuario que recargue la ventana o inicie una nueva sesión, escriba cualquier mensaje (el tema se establece en el primer mensaje), y pruebe /backdrop day|night|auto. Pídele que mire áreas específicas; su captura de pantalla es la prueba real. Elimina las carpetas de herramientas temporales después.

Reglas que afectan

• Solo SVG con comillas simples, sin ", \ ni acentos graves en ningún Svg: el escape cuenta contra el total.
• Los Svgs de una escena juntos suman ≤ ~259500 caracteres; cada Svg ≤ ~98000. Si se excede, el escritorio no muestra nada y no dice nada; la plantilla registra escenas sobredimensionadas al inicio de la sesión.
• Mantén glass activado; deja tint fuera de un aspecto destinado a ambos modos.
• No uses fondos image, color, gradient o vector, <image>, ni overrideColorScheme: ninguno de ellos dibuja ni tiene efecto.
• Establece el tema en prompt.submit, no en session.start.
• Al mejorar un área, conserva lo que el usuario dijo que le gusta tal como está: asigna a esa área su propia región o prioridad en lugar de reajustar todo. Informa cada cambio con el área que afecta.