Saltar a contenido

Solución de problemas

Versión o descarga no disponible

El XPI publicado y SHA256SUMS se pueden descargar públicamente sin iniciar sesión. Descarga el XPI, no un archivo del código fuente. Si falla la instalación, comprueba la versión de Zotero y SHA256SUMS.

No hay tarea o falta el PDF

Comprueba que el análisis esté activado y guardado, y que el adjunto sea un PDF local. El complemento no descarga archivos ausentes. Usa Analizar adjuntos para elementos ya añadidos. Otros tipos pueden conservar solo metadatos.

Tarea en cola o fallida

Revisa la fase y los detalles. La cola del proveedor no es trabajo local; progreso desconocido no significa finalización. Comprueba servicio, dirección, credenciales, cuota, red y límites. Reintenta la fase fallida en vez de repetir el alta.

Las tareas aceptadas conservan la identidad original. Tras cambiar de servicio, mantén una configuración compatible de dirección/clave para reanudarlas. Desactivar el análisis no cancela solicitudes en curso.

Hay texto pero no búsqueda semántica

Comprueba que los modelos estén activados, guardados y aplicados y que la prueba de embeddings funcione. Revisa la fase semántica de las tareas y los avisos de recuperación. Modelo y dimensiones deben coincidir con el espacio vectorial.

Vectorizar documentos existentes genera embeddings faltantes y puede gastar cuota. Reparar el índice de búsqueda usa los vectores guardados sin generar nuevos embeddings.

Markdown vacío o antiguo

Espera a la publicación, cierra y abre el PDF correcto y pulsa M. El contenido anterior no adopta automáticamente nuevas reglas de análisis: necesita reprocesamiento explícito. Conserva los cambios sin guardar antes de cerrar o reprocesar.

No se guardan los ajustes

Lee los mensajes de validación. Otra ventana o editor externo puede haber cambiado la configuración. Conserva los valores, recarga y reintenta. Probar la conexión no guarda nada.

Falla MCP

  • Revisa el estado y la dirección real.
  • Mantén Zotero abierto y el ordenador activo.
  • El cliente debe estar en el mismo ordenador y admitir Streamable HTTP autenticado.
  • Comprueba token Bearer, caducidad, bibliotecas y permisos.
  • Si el puerto está ocupado, aplica uno libre y actualiza el cliente.

Desplazamiento PDF lento durante automatización

Los clientes Windows UI Automation pueden activar accesibilidad en Zotero y afectar al desplazamiento. Se observó con el asistente computer-use de Codex en pruebas aisladas. Cierra la sesión y el asistente de esa tarea, reinicia Zotero aislado y compara. No demuestra que todas las instalaciones tengan el mismo problema.

Si persiste, sigue Asistencia con una reproducción mínima y datos depurados.