Gestione dei Tag

Cos'è il Vocabolario dei Tag?

Il Vocabolario dei Tag è un sistema di tag standardizzato utilizzato per l'annotazione coerente della letteratura. A differenza dei tag a forma libera nativi di Zotero, i tag in un vocabolario controllato seguono convenzioni di denominazione unificate, il che facilita le statistiche e il recupero.

Facet

Ogni tag appartiene a un Facet (dimensione). I seguenti facet sono attualmente supportati:

Facet	Descrizione	Esempio
field	Campo di ricerca	field:natural_language_processing
topic	Argomento di ricerca	topic:transformer_architecture
method	Metodo di ricerca	method:reinforcement_learning
model	Modello utilizzato	model:gpt-4
ai_task	Tipo di compito AI	ai_task:text_summarization
data	Dataset	data:imagenet
tool	Strumento	tool:python
status	Attività workflow in sospeso	status:need-analysis

Formato dei tag: ^[a-z_]+:[a-zA-Z0-9/_.-]+$, massimo 120 caratteri.

Scheda Vocabulary

Nella pagina Synthesis Workbench → Tags → Vocabulary, è possibile:

• Visualizzare: Tutti i tag canonici definiti, con stato, facet, alias e conteggio di utilizzo
• Aggiungere: Creare nuovi tag canonici
• Modificare: Modificare i metadati dei tag
• Deprecare: Contrassegnare un tag come deprecato, specificando opzionalmente un tag sostitutivo
• Importare JSON: Importare un vocabolario di tag da un file JSON (supporta l'anteprima prima della conferma)
• Esportare JSON: Esportare il vocabolario corrente in un file JSON

I cinque stati workflow integrati vengono inizializzati all'avvio del plugin. Il loro tag, facet, fonte, stato di deprecazione e sostituzione non possono essere modificati o eliminati; le note rimangono modificabili e gli alias continuano a utilizzare il percorso di governance normale. Le voci personalizzate status:* mantengono gli stessi controlli di gestione delle altre voci personalizzate del vocabolario. Le importazioni possono aggiornare note e alias integrati, ma l'omissione di un integrato o la modifica della sua identità protetta non può rimuoverlo o sostituirlo.

Stati dei tag:

• active: Attivo
• deprecated: Deprecato (ha un tag sostitutivo)
• warning: Avviso (potrebbe richiedere revisione)

Scheda Staged (Tag in sospeso)

Lo skill tag-regulator analizza automaticamente i metadati della letteratura e genera suggerimenti di tag controllati, mostrati nella pagina Staged.

Flusso di approvazione

1. Esaminare l'elenco dei tag suggeriti
2. Per ciascun tag, è possibile:
   • Promuovi: Aggiungere il tag al vocabolario canonico
   • Scarta: Rifiutare il suggerimento
   • Cancella tutti i pending: Scartare in blocco tutti i suggerimenti

Formato di importazione/esportazione

Il vocabolario dei tag supporta l'importazione/esportazione in formato JSON (formato TagVocab), consentendo:

• Migrazione dei sistemi di tag tra librerie
• Condivisione in team delle convenzioni di tag
• Backup e controllo versione

Workflow correlato

status indica attività workflow in sospeso, non l'avanzamento della lettura. Un elemento può avere zero o più stati. Le cinque definizioni integrate:

• status:need-metadata-curation
• status:need-fulltext
• status:need-markdown
• status:need-analysis
• status:need-deep-reading

Non è necessario eseguire Tag Bootstrapper per crearle. Tag Bootstrapper aggiunge solo voci di vocabolario personalizzate, mentre Tag Regulator può verificare tag controllati ordinari ma non può aggiungere o rimuovere stati workflow integrati sugli elementi di letteratura. Nessuno dei due workflow può inferire uno stato integrato dall'argomento, dalla lingua, dai metadati o dal testo completo di un articolo.

Evento	Aggiungere all'elemento	Rimuovere dall'elemento
Search crea un elemento	Markdown, analisi e deep reading; metadati/fulltext quando il risultato li richiede	—
Search riutilizza un elemento	Solo metadati/fulltext esplicitamente richiesti da questo risultato	—
Metadata Curator riesce o verifica che non ci sono cambiamenti	—	Metadata curation
MinerU scrive e allega Markdown	—	Markdown e fulltext
Literature Analysis scrive artefatti formali	—	Analisi
Literature Deep Reading scrive e allega HTML	—	Deep reading

Le esecuzioni fallite, saltate, annullate o non applicate non cancellano lo stato. Se un artefatto riesce ma la pulizia dello stato fallisce, l'artefatto viene mantenuto e l'esecuzione segnala un avviso parziale. Allegare manualmente un PDF non rimuove automaticamente status:need-fulltext.