Definizione della metrica Rule e la sua funzione nella suite AesCode Infographics
La metrica Rule nel benchmark AesCode Infographics è definita come la media di tre verifiche deterministiche: Text, Bound e Chart. Queste verifiche valutano aspetti strutturali e semantici del codice generato che possono essere estratti in modo programmatico dal codice sorgente, dal DOM o dalla renderizzazione nel browser.
A differenza delle metriche visive, che si affidano a un giudice VLM (Vision-Language Model) per valutare proprietà non analizzabili come la gerarchia o lo stile, Rule si concentra sulla correttezza verificabile. La sua funzione è garantire che il codice soddisfi i requisiti esatti di contenuto, contenimento nel canvas e struttura dei dati, fornendo una base oggettiva prima di valutare la qualità estetica.
La media di Text, Bound e Chart riunisce in un'unica cifra verifiche distinte, non tre versioni dello stesso test. Text si occupa della presenza delle stringhe richieste; Bound, di quanto il contenuto rimanga all'interno del canvas e rispetti il rapporto d'aspetto previsto; Chart, di tabelle e grafici che presentino la struttura e i dati attesi. Interpretare Rule richiede quindi ricordare quale tipo di requisito osserva ciascun componente, anziché trattare il valore aggregato come una descrizione esaustiva del risultato.
La divisione tra verifiche programmatiche e giudizio visivo risponde al tipo di evidenza disponibile. Una stringa attesa può essere cercata nel testo renderizzato, e certi limiti o dati possono essere confrontati con informazioni geometriche o strutturate. Al contrario, decidere se la gerarchia di un'infografica è chiara o se il suo stile è coerente non si riduce a verificare una condizione esatta del codice. Rule fornisce così una base delimitata di correttezza verificabile; non trasforma automaticamente quei requisiti in una misura del valore globale del design.
Il fatto che i tre componenti vengano mediati facilita la disponibilità di una metrica riassuntiva, ma non elimina la necessità di distinguerli durante l'analisi di un risultato. Un punteggio aggregato può nascondere che le verifiche di testo, limiti e grafici non si comportino necessariamente allo stesso modo di fronte a una stessa uscita. Il valore deve essere letto insieme alla definizione dei suoi componenti e all'ambito di ciascuna verifica: descrive il rispetto di quelle condizioni specifiche, non qualsiasi proprietà che possa essere rilevante per la valutazione di un'infografica.
Componenti della metrica Rule
Dettaglio delle tre sotto-metriche che compongono il punteggio Rule.
| Componente | Descrizione | Fonte di verifica |
|---|---|---|
| Text | Verifica la presenza esatta delle stringhe di testo richieste. | OCR e analisi del testo nella renderizzazione. |
| Bound | Misura il contenimento nel canvas e la corrispondenza del rapporto d'aspetto. | Geometria dei pixel e stili calcolati. |
| Chart | Verifica la struttura, il sottotipo e i dati di tabelle e grafici (ECharts). | Parsing HTML e dati strutturati. |
Metodologia di esecuzione: come vengono applicate le regole di verifica
L'harness di valutazione di AesCode richiede una renderizzazione in un browser (Chromium tramite Playwright) e l'uso di PaddleOCR per estrarre il testo. Ogni punteggio viene calcolato a partire da questa renderizzazione, non solo dal codice sorgente, il che assicura che la metrica rifletta il risultato visivo finale.
Il processo implica il confronto del grafico di design obiettivo (derivato dal prompt e dall'immagine di riferimento) con il grafico candidato generato dal modello. Le proprietà con evidenza strutturata nel codice o misurabile nella renderizzazione vengono assegnate ai verificatori deterministici. Se un canale come PaddleOCR fallisce o non è presente, il canale restituisce zero invece di astenersi, il che può corrompere la ricompensa se non gestito correttamente.
La renderizzazione è un passaggio centrale perché l'oggetto della verifica non è solo il testo HTML/CSS prodotto, ma il risultato che quel codice riesce a mostrare nel browser. L'estrazione successiva consente di confrontare l'uscita visibile con il contenuto richiesto e di misurare aspetti del canvas. Pertanto, il punteggio dipende dal fatto che il processo di rendering e gli strumenti di lettura forniscano l'evidenza attesa dai verificatori; esaminare solo il codice sorgente non riproduce completamente la procedura descritta.
Il grafico obiettivo e il grafico candidato svolgono funzioni diverse nel confronto: il primo esprime ciò che deve essere verificato a partire dal prompt e dall'immagine di riferimento, mentre il secondo rappresenta il risultato generato dal modello. Le regole deterministiche si applicano alle proprietà per le quali esiste un segnale strutturato o misurabile. Questa assegnazione delimita l'ambito di Rule: non ogni differenza tra i due grafici diventa una verifica automatica, specialmente quando si tratta di qualità visive che non si rappresentano tramite i requisiti osservabili di Text, Bound o Chart.
Il trattamento di un errore di PaddleOCR come punteggio zero fa sì che la disponibilità del canale faccia parte dell'interpretazione del risultato. Se non si separa un problema di estrazione da un'assenza reale del testo, il valore restituito può riflettere il guasto dello strumento oltre al rispetto del modello. La stessa attenzione si applica all'esecuzione del browser e agli altri passaggi dell'harness: un valore riproducibile presuppone che la valutazione sia stata completata con gli strumenti necessari, e non deve essere letto senza considerare quella condizione.
L'ordine delle operazioni aiuta a capire perché la metrica si riferisca a una renderizzazione specifica: prima si ottiene un'uscita in Chromium; poi si estraggono testo e geometria; quindi si applicano i verificatori di contenuto, limiti e dati; infine si mediano i loro punteggi. Se cambia l'evidenza disponibile in una di queste fasi, può cambiare il valore calcolato. La descrizione del flusso non autorizza ad attribuire a Rule una valutazione diretta dell'intera immagine, ma solo delle proprietà che i passaggi indicati riescono a verificare.
Flusso di verifica deterministica
Passaggi tecnici per calcolare la metrica Rule nell'harness.
- 01Renderizzare il codice HTML/CSS generato in un browser headless (Chromium).
- 02Estrarre testo e geometria dei pixel dalla renderizzazione.
- 03Eseguire il verificatore Text per controllare le stringhe esatte.
- 04Eseguire il verificatore Bound per validare i limiti del canvas.
- 05Eseguire il verificatore Chart/Table per validare i dati strutturati.
- 06Calcolare la media dei tre punteggi per ottenere Rule.
Confronto con le metriche visive: stabilità e riproducibilità
Nel benchmark di 300 istanze di infografiche, i punteggi basati su regole (Rule) sono costantemente più alti e stabili rispetto ai punteggi visivi per i modelli di codice chiuso valutati. Questa stabilità è dovuta alla natura deterministica delle verifiche: non dipendono dalla soggettività di un modello linguistico visivo.
Tuttavia, questa stabilità non implica una superiorità assoluta nella valutazione della qualità. Mentre Rule misura la correttezza strutturale, le metriche visive (Content, Layout, Style) catturano la percezione umana del design. I modelli più deboli mostrano un calo più marcato nelle metriche visive rispetto alla conformità alle regole, il che suggerisce che Rule può essere meno sensibile ai difetti estetici sottili.
La stabilità menzionata corrisponde al benchmark descritto e ai modelli a codice chiuso valutati nelle sue 300 istanze; non stabilisce una proprietà universale di Rule per qualsiasi raccolta di casi o configurazione. All'interno di quel quadro, le verifiche deterministiche tendono a produrre punteggi più alti e stabili rispetto a quelli visivi. La differenza si comprende perché entrambi i canali osservano cose diverse: uno verifica requisiti delimitati e l'altro giudica dimensioni del design che non vengono catturate da quelle regole.
La divergenza tra i punteggi non significa che uno di essi invalidi l'altro. Un'uscita può adattarsi alle stringhe e ai limiti richiesti e, tuttavia, offrire una gerarchia visiva scadente o colori inappropriati. In quel caso, Rule fornisce evidenza favorevole solo sugli aspetti verificati, mentre un punteggio visivo basso segnala problemi nelle dimensioni valutate da quel canale. La lettura congiunta consente di localizzare il tipo di differenza senza trasformare la conformità strutturale in una valutazione estetica.
Il calo più marcato dei modelli deboli nelle metriche visive rispetto alla conformità alle regole suggerisce una sensibilità diversa tra i canali, non un'equivalenza tra i punteggi. Rule può trascurare difetti estetici sottili proprio perché le sue verifiche sono orientate al contenuto, al contenimento e alla struttura dei dati. Pertanto, una differenza tra Rule e Visual è informativa sull'ambito di ciascuna metrica, ma non consente di inferire da sola che un modello sia competente in modo generale né di fissare una soglia di competenza che il benchmark non fornisce.
Limiti della metrica Rule per valutare la qualità estetica reale
La metrica Rule ha limiti intrinseci per valutare la qualità estetica reale. Non cattura proprietà come la tipografia, l'uso del colore, la gerarchia visiva o la coesione del design, che sono essenziali per la percezione di un 'buon design'. Questi aspetti vengono valutati attraverso il canale Visual, che utilizza una rubrica specifica per campione (VGR) e un giudice VLM.
Inoltre, la comparabilità tra modelli può essere compromessa se la metrica Rule non cattura la percezione umana del design. Un modello può avere una Rule alta ma una Visual bassa, il che indica che il codice è strutturalmente corretto ma esteticamente carente. Pertanto, Rule deve essere interpretata come una metrica di correttezza, non di qualità estetica.
Il limite di Rule non è un difetto accidentale che si corregga interpretando il valore con maggiore fiducia: deriva dal fatto che i suoi test si occupano di condizioni verificabili, mentre la tipografia, il colore, la gerarchia e la coesione appartengono a dimensioni che la metrica non cattura. Un'uscita può soddisfare ciò che è stato verificato e risultare comunque poco attraente o poco coeso. Per questo motivo, il punteggio esprime conformità strutturale all'interno del quadro definito, non un'approvazione generale del design.
Il canale Visual completa Rule affrontando proprietà che non si risolvono con le verifiche deterministiche e utilizzando una rubrica specifica del campione insieme a un giudice VLM. Questa complementarità non significa che le metriche siano intercambiabili né che un valore visivo debba correggere o sostituire il valore Rule. Ogni risultato risponde a una domanda diversa: se vengono rispettate determinate condizioni strutturali e di contenuto, da un lato, e come vengono valutate le dimensioni visive esaminate, dall'altro.
Per confrontare i risultati è opportuno mantenere esplicita questa separazione concettuale. Una Rule alta non garantisce che la tipografia, i colori o la gerarchia siano adeguati; una Visual bassa non dimostra da sola che siano fallite le verifiche di contenuto, contenimento o struttura dei grafici. Quando entrambi i valori divergono, la conclusione prudente è che i canali stanno segnalando aspetti diversi del risultato. Non c'è base qui per trasformare quella divergenza in una categoria universale di qualità né per affermare che esista un livello di Rule che assicuri un design attraente.
Impatto sulla comparabilità tra modelli e conclusioni
L'uso di Rule come metrica separata consente una valutazione più granulare dei modelli di generazione di codice. Separando la correttezza dalla qualità visiva, i team possono identificare se un modello fallisce per errori strutturali o per limitazioni estetiche. Questo è cruciale per l'integrazione in pipeline di produzione, dove la correttezza è un prerequisito per la qualità.
I risultati di AesCode mostrano che i modelli di codice chiuso tendono ad avere punteggi più alti in Rule che in Visual, con Style che è la dimensione più debole. Questo suggerisce che la correttezza strutturale è più facile da ottenere rispetto alla qualità estetica, e che le metriche deterministiche come Rule sono utili ma insufficienti per una valutazione completa della qualità del design.
Separare Rule da Visual offre una diagnosi più granulare perché consente di distinguere, all'interno delle dimensioni misurate, tra requisiti strutturali verificabili e valutazione visiva. Questa distinzione può aiutare a identificare se un risultato presenta errori nelle verifiche di codice, contenuto o limiti, o se le sue difficoltà emergono nelle dimensioni estetiche. Tuttavia, la granularità dipende dal fatto che ogni punteggio venga interpretato secondo la sua definizione; la media Rule non identifica da sola quale dei suoi tre componenti spieghi un risultato né sostituisce l'esame del canale visivo.
Nel benchmark di 300 istanze con immagine di riferimento, i valori della tabella mostrano Rule sopra Visual per i modelli selezionati. Questo confronto specifico accompagna l'osservazione che Style è la dimensione più debole, ma non deve essere estrapolato oltre i modelli, le istanze e la configurazione descritti. Non trasforma nemmeno i valori in una scala comune di qualità estetica: Rule e Visual corrispondono a valutazioni diverse, in modo che la loro distanza serva a descrivere il modello osservato, non a stabilire da sola una misura universale di superiorità.
L'utilità della metrica dipende anche dal mantenere visibile il suo ambito quando viene utilizzata per confrontare i modelli. Se le regole coprono solo stringhe, limiti e struttura di tabelle o grafici, le differenze in Rule descrivono le prestazioni in quelle verifiche e non tutti i possibili motivi per cui un'infografica può risultare migliore o peggiore. Per una lettura completa dei risultati, è necessario considerare simultaneamente le metriche visive menzionate, in particolare perché la qualità estetica può variare senza che le verifiche strutturali cambino in modo equivalente.
La conclusione supportata dai risultati è delimitata: nell'insieme descritto, i modelli a codice chiuso tendono a ottenere punteggi Rule maggiori rispetto a Visual, mentre Style emerge come la dimensione più debole. Questo suggerisce che il rispetto delle condizioni strutturali possa essere più raggiungibile rispetto al raggiungimento della qualità estetica valutata dal canale visivo, ma non dimostra che la correttezza sia sempre più facile in qualsiasi situazione. Rule è utile per rendere esplicito un tipo di conformità ed è insufficiente, per progettazione, per riassumere da sola la qualità del design.
Confronto dei punteggi Rule e Visual in modelli selezionati
Punteggi medi nel benchmark di 300 istanze (con immagine di riferimento).
| Modello | Rule | Visual | Overall |
|---|---|---|---|
| GPT-5.5 | 85.80 | 76.76 | 81.28 |
| Claude Opus 4.8 | 83.55 | 77.23 | 80.39 |
| AesCode-8B | 90.07 | 75.80 | 82.94 |
| AesCode-32B | 94.33 | 77.44 | 85.89 |
Continua a esplorare
Fonti consultate
Correzioni e trasparenza
Se trovi un dato errato o non aggiornato, inviaci la pagina e la fonte da verificare.
Proponi una correzione