Habilidade de Reconstrução de Lineart no Krita
Empacotar e executar uma pipeline validada e pronta para produção de reconstrução de lineart nativo 1x do Krita a partir de uma ilustração raster de referência.
Esta habilidade é agnóstica a agentes: a síntese matemática de trajetória, o rastreamento do esqueleto topológico, a calibração e a validação são estritamente isolados da execução do Krita RPC/MCP/CLI por meio do scripts/krita_adapter.py.
Limites Rigorosos do Escopo de Produção
- Resolução nativa
1xapenas: Não habilite supersampling2xou escalonamento combinado2x + adaptive. Tantoadaptive_subdivision.pyquantostroke_planner.pyrejeitamresolution_scale != 1/supersample_factor != 1. - Apenas lineart: Gera tinta
#000000nítida em uma camada de pintura dedicadaLineart(RGBA U8,300 dpi,sRGB-elle-V2-srgbtrc.icc). Não realiza coloração plana, sombreamento, gradientes, oclusão ambiente, pilhas de iluminação ou renderização. - Apenas pincéis nativos do Krita: Sintetiza traços exclusivamente por meio de predefinições de pincel calibradas (
d) Ink-3 Gpeneb) Basic-5 Sizepara preenchimentos gráficos amplos) em vez de importar sobreposições rasterizadas.
Fluxo de Trabalho Principal da Pipeline
-
Análise da Referência e Extração de Tinta (
scripts/ink_analysis.py):- A limiarização em dois níveis captura tinta escura sólida (
inv > 42.0) e cristas delicadas de baixo contraste (local_dark > 14.0 & inv > 18.0relativo a Gaussianasigma = 4.0), além de substituições opcionais de bounding box fina (region_overrides) para lacunas densas e apertadas, como anéis concêntricos da íris. - Detecta núcleos gráficos pretos ousados via Transformada de Distância Euclidiana (
edt >= 2.8 px, área>= 20 px) e extrai contornos de varredura de isodistância (1.35 .. 16.20 px). - Esqueletiza a tinta restante, poda curvas de quantização curtas (
<= 4iterações), emenda trajetórias colineares em junções de grau>= 3(cos <= -0.68), refina linhas centrais para precisão subpixel (refine_ridge_subpixel) e divide em cantos agudos (> 72 deg) ou extensão máxima de540 px.
- A limiarização em dois níveis captura tinta escura sólida (
-
Ajuste de Spline e Densidade de Vértices Adaptativa Validada (
scripts/bezier_core.py,scripts/adaptive_subdivision.py):- Ajusta segmentos Bézier cúbicos contínuos G1 com alças tangentes de mínimos quadrados ótimos.
- Refina a amostragem de cordas com Subdivisão Recursiva de Bézier Cúbico Baseada em Fila de Prioridade (validada no Experimento 2 em
1x), limitando vértices por traço ao limite rígido de128pontos do Krita, mantendo tolerâncias restritas na flecha de corda, deflexão do ângulo tangente, produto curvatura-arco, fidelidade de taper de pressão e comprimento de corda reta.
-
Calibração de Pincel e Coordenadas do Krita 6.0.4 (
scripts/pressure_calibration.py,scripts/stroke_planner.py):- Integra a largura da linha óptica ao longo das normais locais com parada em vale (
max_half = 4.8 px) para evitar inchaço de fios vizinhos. - Seleciona curvas de pressão empíricas de regime duplo
d) Ink-3 Gpen(GPEN_THINquandobrush_size <= 4.5 px;GPEN_STDquandobrush_size > 4.5 px) ou tabelasb) Basic-5 Sizedefinidas emconfigs/pressure_tables_krita604.json. - Desloca amostras de vértices e pontos de controle Bézier em
+0.58 px(PIXEL_CENTER_SHIFT) para alinhar dabbs de traço com centros de pixel do Krita e ordena traços nos Estágios 1–6 (núcleos gráficos -> silhuetas externas -> zonas focais -> estrutura interna -> fios finos).
- Integra a largura da linha óptica ao longo das normais locais com parada em vale (
-
Execução e Feedback Visual em Malha Fechada (
scripts/reconstruct_lineart.py,scripts/refinement.py):- Execute via
KritaAdapteremdry_run(exportação de lote JSON portátil),http_bridge(POST /rpc) oukrita_mcp_cli(krita-mcp --call) usando lotes de<= 32traços (rigorosamente<= 64por chamadadraw_brush). - Exporte a tela renderizada em escala de cinza e, opcionalmente, execute
--feedback-canvas <png>(Estágio 7) para sintetizar microtraços direcionados onde os traços de referência foram perdidos (dist >= 1.35 px) ou subescurecidos.
- Execute via
-
Validação e Entrega (
scripts/validate_lineart.py):- Verifique os limites do esquema do manifesto, calcule
SSIM,PSNR_dB,Contour_F1(1.5 px),Exact_Pixel_F1(0.5 px),Fine_Detail_Recall,Narrow_Gap_Preservationem toda a tela e regionalmente, e gere PNGs de diferença de alinhamento em vermelho/azul/cinza escuro. - Uma vez que o lineart passe na validação, entregue para
krita-flat-colouring.
- Verifique os limites do esquema do manifesto, calcule
Invocação Rápida via CLI
Planeje traços offline, valide os limites do manifesto e emita JSON de lote MCP portátil do 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
Execute ao vivo contra uma sessão ativa do 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
Guias de Referência e Configurações
references/architecture.md— Layout do módulo e limites de isolamento agnósticos a agentes.references/bezier-and-sampling.md— Ajuste de Bézier cúbico G1, Subdivisão Recursiva Baseada em Fila de Prioridade vs. amostrador legado e por que o supersampling é excluído.references/calibration.md— Calibração de coordenada+0.58 pxe tabelas de regime duploInk-3 Gpen/Basic-5 Size.references/krita-interface.md— Protocolo de ponte nativa do Krita 6.0.4, limites rígidos de esquema e tratamento de erros.references/validation.md— Métricas de fidelidade, feedback de resíduos em malha fechada e critérios de aprovação.references/troubleshooting.md— Diagnóstico de detalhes ausentes, corte de vértices e erros de ponte.configs/default_config.json&configs/pressure_tables_krita604.jsonexamples/workflow_example.md