Gestión de etiquetas
¿Qué es el vocabulario de etiquetas?
El vocabulario de etiquetas es un sistema de etiquetado estandarizado utilizado para la anotación coherente de literatura. A diferencia de las etiquetas de forma libre nativas de Zotero, las etiquetas en un vocabulario controlado siguen convenciones de nomenclatura unificadas, lo que facilita las estadísticas y la recuperación.
Facetas
Cada etiqueta pertenece a una faceta (dimensión). Actualmente se admiten las siguientes facetas:
| Faceta | Descripción | Ejemplo |
|---|---|---|
field | Campo de investigación | field:natural_language_processing |
topic | Tema de investigación | topic:transformer_architecture |
method | Método de investigación | method:reinforcement_learning |
model | Modelo utilizado | model:gpt-4 |
ai_task | Tipo de tarea de IA | ai_task:text_summarization |
data | Conjunto de datos | data:imagenet |
tool | Herramienta | tool:python |
status | Tarea pendiente del workflow | status:need-analysis |
Formato de etiqueta: ^[a-z_]+:[a-zA-Z0-9/_.-]+$, máximo 120 caracteres.
Pestaña Vocabulary
En la página Synthesis Workbench → Tags → Vocabulary, puedes:
- View: Todas las etiquetas canónicas definidas, mostrando estado, faceta, alias y recuento de uso
- Add: Crear nuevas etiquetas canónicas
- Edit: Modificar metadatos de etiquetas
- Deprecate: Marcar una etiqueta como obsoleta, especificando opcionalmente una etiqueta de reemplazo
- Import JSON: Importar un vocabulario de etiquetas desde un archivo JSON (admite vista previa antes de confirmar)
- Export JSON: Exportar el vocabulario actual a un archivo JSON
Los cinco estados de workflow integrados se inicializan cuando el plugin arranca. Su tag, faceta, fuente, estado de obsolescencia y reemplazo no pueden modificarse ni eliminarse; las notas siguen siendo editables y los alias continúan usando la vía de gobierno normal. Las entradas personalizadas status:* conservan los mismos controles de gestión que las demás entradas personalizadas del vocabulario. Las importaciones pueden actualizar notas y alias integrados, pero omitir un integrado o cambiar su identidad protegida no puede eliminarlo ni reemplazarlo.
Estados de etiqueta:
active: Activadeprecated: Obsoleta (tiene una etiqueta de reemplazo)warning: Advertencia (puede necesitar revisión)
Pestaña Staged (etiquetas pendientes)
El skill tag-regulator analiza automáticamente los metadatos de la literatura y genera sugerencias de etiquetas controladas, mostradas en la página Staged.
Flujo de aprobación
- Revisar la lista de etiquetas sugeridas
- Para cada etiqueta, puedes:
- Promote: Añadir la etiqueta al vocabulario canónico
- Discard: Rechazar la sugerencia
- Clear Staged: Descartar todas las sugerencias en lote
Formato de importación/exportación
El vocabulario de etiquetas admite importación/exportación en formato JSON (formato TagVocab), lo que permite:
- Migración de sistemas de etiquetas entre bibliotecas
- Compartir convenciones de etiquetas en equipo
- Respaldo y control de versiones
Workflow relacionado
status representa tareas pendientes de workflows, no el progreso de lectura. Un elemento puede tener cero o varios estados. Las cinco definiciones integradas:
status:need-metadata-curationstatus:need-fulltextstatus:need-markdownstatus:need-analysisstatus:need-deep-reading
No es necesario ejecutar Tag Bootstrapper para crearlas. Tag Bootstrapper solo añade entradas personalizadas al vocabulario, mientras que Tag Regulator puede auditar etiquetas controladas ordinarias pero no puede añadir ni eliminar estados de workflow integrados en elementos de literatura. Ninguno de los dos workflows puede inferir un estado integrado a partir del tema, idioma, metadatos o texto completo de un artículo.
| Evento | Añadir al elemento | Eliminar del elemento |
|---|---|---|
| Search crea un elemento | Markdown, análisis y deep reading; metadatos/fulltext cuando el resultado los requiere | — |
| Search reutiliza un elemento | Solo metadatos/fulltext explícitamente requeridos por este resultado | — |
| Metadata Curator tiene éxito o verifica que no hay cambios | — | Metadata curation |
| MinerU escribe y adjunta Markdown | — | Markdown y fulltext |
| Literature Analysis escribe artefactos formales | — | Análisis |
| Literature Deep Reading escribe y adjunta HTML | — | Deep reading |
Las ejecuciones fallidas, omitidas, canceladas o no aplicadas no borran el estado. Si un artefacto tiene éxito pero la limpieza de estado falla, el artefacto se conserva y la ejecución reporta una advertencia parcial. Adjuntar un PDF manualmente no elimina status:need-fulltext automáticamente.