cxp-character-forge

CXP Character Forge

Usa el script scripts/tripo_proxy.py dentro del directorio de esta habilidad. En la primera instalación, ejecuta python scripts/bootstrap.py para obtener las dependencias de versión fija; lee el README para la configuración. Solo envía la clave a la dirección del proxy configurada por el usuario; no llama al configure oficial de la CLI ascendente.

Tarea y Referencia

Respeta el diseño, proporciones, versión final y uso (estático/animado) confirmados por el usuario. Primero revisa los activos existentes y el registro de tareas para evitar regeneraciones. Para crear un nuevo personaje, primero verifica que el código fuente de Charakuru esté instalado localmente (descargar y descomprimir desde Releases; Node 22+, Blender 5.2, VRM Add-on), ya que sirve como biblioteca de métodos para vistas de tres ángulos, agrupación de retexturizado, restauración de UV, transferencia de pesos, expresiones y física de balanceo. Ver Métodos de Charakuru. Ruta recomendada: ilustraciones de referencia frontal y posterior en pose T → generación completa de una sola vez (solo se llama 1 tarea por vez, sin paralelismo ni repetición; consume muchos créditos) → revisión de malla en gris, inspeccionando y separando cabeza, cabello/flequillo, accesorios y falda (si no se pueden separar, modificar la imagen y regenerar) → rigging rápido y prueba con una animación MMD simple para verificar el esqueleto, permitiendo que la IA ajuste nodos óseos y pesos → retexturizado con Tripo y conversión de vuelta a UV (lo más lento) → expresiones → finalmente, física. Durante la producción, los personajes de estilo anime usan por defecto el material rápido de renderizado 3D a 2D tipo Genshin con revisión de malla en gris (rápido para iterar), y solo en el último paso se usa genshin-blender-render para renderizado fino. Los ojos, la boca y las expresiones son imprescindibles: metodología Charakuru, mantener la forma facial original del objetivo, red completa de expresiones y texturas del personaje de referencia (incluyendo estructura oral). Ver Requisitos de Expresiones, Flujo de Ojos y Cejas. No generes la cabeza y el cuerpo por separado (las costuras del cuello, las proporciones y el tono de piel son difíciles de unir; esto es diferente de la versión original de Charakuru). Para los pasos, experiencia y detalles de MMD, ver Flujo de Personaje. Para la lista de desglose de componentes y cómo texturizar cada uno (Tripo / Proyección Codex / Generación Geométrica / Pintura Plana), ver Texturizado por Componentes; los scripts están en scripts/component_tex/. Para el refinamiento de ojos al coincidir con personajes MMD / Genshin PMX (sombra del párpado superior, pupila en capas, destello brillante), ver Refinamiento de Ojos; scripts en scripts/eye_refine/. Para la simulación de falda y cabello sin interfaz en Houdini, ver houdini-cloth-hair. Para la simulación segmentada de canciones completas, unión con segmentos ya aprobados, simulación de faldas reales multicapa (costuras entre capas, enaguas, aprobación de malla en gris), instalación en Linux remoto, reglas de licencia por máquina y organización por bloques, ver houdini-fullsong-remote; scripts en scripts/houdini_song/.

Primero verifica la postura A/T, proporciones cabeza-cuerpo, dedos, contorno frontal/posterior y occlusiones. Las vistas múltiples deben ser del mismo personaje y la misma postura; las vistas laterales/traseras no fiables no deben forzar la generación. Las caras ocultas son suposiciones de relleno.

Generación y Recuperación

• doctor verifica la configuración offline; doctor --online validación de solo lectura; models, balance consulta modelos y saldo. La configuración de compatibilidad del servicio sigue la convención descrita en API del Proxy.
• Obtén el valor actual del modelo, los parámetros soportados y el precio; no trates modelos históricos o parámetros del proxy como especificaciones oficiales generales. Se puede ejecutar la generación dentro de la autorización de producción existente; solo conecta para pruebas, no envíes tareas de pago.
• Prioriza la generación con textura nativa; revisa el modelo texturizado real lo antes posible. La malla en gris se usa para diagnóstico auxiliar, no puede reemplazar la inspección con textura.
• upload --file reference.png --record uploads/front.json sube la referencia; devolverá un token y el valor actual del modelo para completar en una copia de examples/image-to-model.json.
• submit --request request.json --job jobs/v1 --dry-run verifica offline, luego usa el mismo comando con --execute para enviar.
• wait --job jobs/v1 --timeout 45, código de salida 3 indica que debe seguir esperando; después de éxito, download --job jobs/v1 --extract.
• Reutiliza el job para la misma solicitud; usa un nuevo directorio para parámetros diferentes. Cuando el resultado de POST sea desconocido, primero concilia y luego recupera; no reintentes ciegamente. Distingue entre descarga nativa y conversión de formatos de pago.

Inspección en Blender

Conserva los archivos de generación originales; trabaja en una copia. Renderiza el modelo real desde el frente, los lados, la parte trasera y en rotación para inspeccionar. No trates una imagen generada en 2D como el efecto del modelo. Inspecciona dedos, rostro, costuras de textura, raíces del cabello, adornos para la cabeza, volumen y conexión de la cola, raíces de las alas y penetración de brazos.

Mantén la textura nativa y las proporciones faciales aprobadas por el usuario. El renderizado 3D a 2D no puede reparar geometría errónea o contaminación horneada en las texturas. Los reemplazos locales necesitan ajuste tridimensional e inspección lateral; no se puede confiar solo en la proyección frontal. Los componentes como cola/cabello deben tener raíces continuas y el grosor adecuado.

La entrega estática no necesita rigging forzado. Cuando se requiera animación, ejecuta prereigcheck → rig → flags/animations → retarget, e inspecciona la deformación real. Las expresiones MMD, el mapeo de huesos y la física de ropa/cabello se crean y verifican por separado. Dos cabezas generadas de forma independiente no pueden tratarse directamente como morph keys de parpadeo continuo.

Entrega

Organiza los directorios de entrega por personaje y versión. Las texturas de Blender deben estar incrustadas o con rutas relativas completas. Proporciona GLB, renderizados reales y videos rotatorios según sea necesario. Informa la fase completada, los ángulos inspeccionados y los problemas restantes. Cuando el usuario solo solicite el paquete de modelo, no incluyas videos ni archivos de proceso. Solo reporta las capacidades de animación realmente verificadas.

Regresión offline: python scripts/test_proxy.py. El script verifica el comportamiento de la interfaz, no demuestra calidad de generación, skinning o física aprobados.

Para migración de formas de boca nativas, integración de pistas de expresión VMD, y problemas de fragmentos alrededor de la boca/color de piel, ver Migración y Reparación de Formas de Boca.