Habilidad de Reconstrucción de Lineart en Krita
Empaquetar y ejecutar un pipeline validado y listo para producción de reconstrucción de lineart nativo 1x en Krita a partir de una ilustración rasterizada de referencia.
Esta habilidad es agnóstica al agente: la síntesis matemática de trayectorias, el trazado del esqueleto topológico, la calibración y la validación están estrictamente aislados de la ejecución mediante Krita RPC/MCP/CLI a través de scripts/krita_adapter.py.
Límites Estrictos del Ámbito de Producción
- Solo resolución nativa
1x: No habilite el sobremuestreo2xni la escala combinada2x + adaptive. Tantoadaptive_subdivision.pycomostroke_planner.pyrechazanresolution_scale != 1/supersample_factor != 1. - Solo lineart: Genera tinta nítida
#000000en una capa de pintura dedicadaLineart(RGBA U8,300 dpi,sRGB-elle-V2-srgbtrc.icc). No realiza color plano, sombreado, degradados, oclusión ambiental, pilas de iluminación ni renderizado. - Solo pinceles nativos de Krita: Sintetiza trazos exclusivamente a través de preajustes de pincel calibrados (
d) Ink-3 Gpenyb) Basic-5 Sizepara rellenos gráficos anchos) en lugar de importar superposiciones rasterizadas.
Flujo de Trabajo Principal del Pipeline
-
Análisis de Referencia y Extracción de Tinta (
scripts/ink_analysis.py):- El umbralizado de dos niveles captura tinta sólida oscura (
inv > 42.0) y crestas delicadas de bajo contraste (local_dark > 14.0 & inv > 18.0relativo a Gaussianasigma = 4.0), más anulaciones finas opcionales de recuadro delimitador (region_overrides) para espacios densos y apretados como anillos concéntricos del iris. - Detecta núcleos gráficos negros audaces mediante la Transformada de Distancia Euclidiana (
edt >= 2.8 px, área>= 20 px) y extrae contornos de barrido de iso-distancia (1.35 .. 16.20 px). - Esqueletiza la tinta restante, poda espuelas de cuantización cortas (
<= 4iteraciones), empalma trayectorias colineales a través de uniones de grado>= 3(cos <= -0.68), refina las líneas centrales a precisión de subpíxel (refine_ridge_subpixel), y divide en esquinas agudas (> 72 grados) o tramos máximos de540 px.
- El umbralizado de dos niveles captura tinta sólida oscura (
-
Ajuste de Spline y Densidad de Vértices Adaptativa Validada (
scripts/bezier_core.py,scripts/adaptive_subdivision.py):- Ajusta segmentos Bézier cúbicos por tramos con continuidad G1 utilizando manejadores de tangente óptimos por mínimos cuadrados.
- Refina el muestreo de cuerdas con Subdivisión Recursiva de Bézier Cúbico basada en Cola de Prioridad (validada en el Experimento 2 a
1x), limitando los vértices por trazo al límite duro de128puntos de Krita mientras mantiene tolerancias estrictas en la sagita de la cuerda, la desviación del ángulo de la tangente, el producto curvatura-arco, la fidelidad de la disminución de presión y la longitud de cuerda recta.
-
Calibración de Pinceles y Coordenadas de Krita 6.0.4 (
scripts/pressure_calibration.py,scripts/stroke_planner.py):- Integra el ancho de línea óptico a lo largo de las normales locales con detención en valles (
max_half = 4.8 px) para evitar el ensanchamiento de hebras vecinas. - Selecciona curvas de presión empíricas de doble régimen para
d) Ink-3 Gpen(GPEN_THINcuandobrush_size <= 4.5 px;GPEN_STDcuandobrush_size > 4.5 px) o tablas deb) Basic-5 Sizedefinidas enconfigs/pressure_tables_krita604.json. - Desplaza tanto las muestras de vértices como los puntos de control Bézier en
+0.58 px(PIXEL_CENTER_SHIFT) para alinear las marcas de trazo con los centros de píxel de Krita, y ordena los trazos en las Etapas 1–6 (núcleos gráficos -> siluetas exteriores -> zonas focales -> estructura interior -> hebras finas).
- Integra el ancho de línea óptico a lo largo de las normales locales con detención en valles (
-
Ejecución y Retroalimentación Visual de Bucle Cerrado (
scripts/reconstruct_lineart.py,scripts/refinement.py):- Ejecutar a través de
KritaAdapteren mododry_run(exportación de lote JSON portátil),http_bridge(POST /rpc), okrita_mcp_cli(krita-mcp --call) utilizando lotes de<= 32trazos (estrictamente<= 64por llamadadraw_brush). - Exportar el lienzo renderizado en escala de grises y opcionalmente ejecutar
--feedback-canvas <png>(Etapa 7) para sintetizar micro-trazos dirigidos dondequiera que los trazos de referencia no se hayan capturado (dist >= 1.35 px) o estén oscurecidos.
- Ejecutar a través de
-
Validación y Entrega (
scripts/validate_lineart.py):- Verificar los límites del esquema del manifiesto, calcular
SSIM,PSNR_dB,Contour_F1(1.5 px),Exact_Pixel_F1(0.5 px),Fine_Detail_Recall,Narrow_Gap_Preservationen todo el lienzo y por región, y generar imágenes de diferencias de alineación en rojo/azul/gris oscuro. - Una vez que el lineart pase la validación, se entrega a
krita-flat-colouring.
- Verificar los límites del esquema del manifiesto, calcular
Invocación Rápida desde CLI
Planificar trazos fuera de línea, validar los límites del manifiesto y emitir JSON de lote portátil para MCP de Krita:
python3 skills/krita-lineart-reconstruction/scripts/reconstruct_lineart.py \
--input path/to/reference.png \
--preset skills/krita-lineart-reconstruction/examples/sample_region_preset.json \
--output-manifest out/lineart_manifest.json \
--batch-dir out/batches \
--mode dry_run
Ejecutar en vivo contra una sesión activa de Krita 6.0.4:
python3 skills/krita-lineart-reconstruction/scripts/reconstruct_lineart.py \
--input path/to/reference.png \
--output-manifest out/lineart_manifest.json \
--mode http_bridge \
--doc-name Character_Lineart
Guías de Referencia y Configuraciones
references/architecture.md— Disposición de módulos y límites de aislamiento agnósticos al agente.references/bezier-and-sampling.md— Ajuste de Bézier cúbico G1, Subdivisión Recursiva basada en Cola de Prioridad vs. muestreador heredado, y por qué el sobremuestreo está excluido.references/calibration.md— Calibración de coordenadas+0.58 pxy tablas de doble régimenInk-3 Gpen/Basic-5 Size.references/krita-interface.md— Protocolo de puente nativo de Krita 6.0.4, límites de esquema duros y manejo de errores.references/validation.md— Métricas de fidelidad, retroalimentación residual de bucle cerrado y criterios de aprobación.references/troubleshooting.md— Diagnóstico de detalles faltantes, recorte de vértices y errores de puente.configs/default_config.jsonyconfigs/pressure_tables_krita604.jsonexamples/workflow_example.md