Analyze Images Advanced para LM Studio

Versión 0.6.0 — Busca imágenes locales, analiza una imagen o compara varias juntas y adjunta automáticamente imágenes relevantes antes de la siguiente respuesta del modelo.

Esta bifurcación de Analyze Images funciona con Visit Website Advanced y DuckDuckGo Advanced, que descargan imágenes y metadatos de origen en un directorio de trabajo.

Instalación y primeros pasos

El identificador es yuanjumay/analyze-images-advanced. Para instalar desde LM Studio Hub, utiliza el control de instalación disponible. Esta guía describe la versión 0.6.0; la revisión publicada puede diferir de tu copia local.

Para instalar desde el código local, abre una terminal en el directorio de este complemento. Los ejemplos usan Windows PowerShell; en macOS/Linux sustituye npm.cmd por npm:

Activa el complemento en el chat. Selecciona un modelo local con visión o configura un servicio Strata con visión. Para las herramientas de imágenes locales, configura el directorio de trabajo del chat. Desactiva los complementos y servidores MCP de pruebas de inyección de imágenes anteriores para evitar procesamientos duplicados.

Herramientas

Los nombres de herramientas y las etiquetas de configuración se mantienen en inglés en todas las guías para coincidir con la interfaz.

Herramienta	Función
List Local Images Advanced	Enumerar rutas locales y metadatos disponibles.
Search Local Images Advanced	Buscar por nombre de archivo y metadatos, como descripciones y URL de origen.
Analyze Local Image Advanced	Analizar una imagen local cuya identidad se ha comprobado.
Multi Analyze Local Images Advanced	Analizar o comparar 2–4 imágenes juntas en una sola solicitud de inferencia.

Confirma los nombres exactos con List/Search antes de analizar. Cada imagen distinta requiere un archivo JSON de metadatos asociado, o sidecar, generado por los complementos de descarga compatibles. No deduzcas la identidad a partir de la numeración local o del orden de JSON-LD. Se admiten rutas relativas; se rechazan rutas absolutas y las que salen al directorio superior. Al seleccionar una miniatura se intenta usar su versión de tamaño completo.

Ejemplo de solicitud:

El análisis múltiple recibe imageNames, prompt y, opcionalmente, context. El orden de entrada define Image 1, Image 2, etc. El resultado incluye el análisis conjunto analysis, la correspondencia ordenada images y el número de duplicados eliminados duplicatesRemoved. Se eliminan las imágenes con bytes idénticos y deben quedar al menos dos diferentes. Los lotes inválidos o demasiado grandes se rechazan antes de inferir, sin analizar solo una parte.

Adjuntos automáticos y reintento manual

Con la función automática activada, una URL de página en el mensaje permite obtener imágenes antes de que el modelo principal empiece a generar. También puedes solicitarlo explícitamente, aunque el procesamiento automático de URL esté desactivado:

Solo se procesa la primera URL HTTP(S). Se prioriza la lista JSON-LD Product.image que coincide con la página; si no hay coincidencia, se usa el primer Product. Si no hay imágenes, se recurre a OG/Twitter y después a las imágenes de main/article. Se conservan el orden y la relación con las URL; no se introducen descripciones de página, textos alt o reseñas como si fueran análisis visuales.

Las imágenes de un análisis individual o múltiple correcto también se convierten en candidatas para el siguiente mensaje del usuario. La prioridad es adjuntos manuales actuales → imágenes recientes analizadas en este chat → imágenes de página. Descargar o enumerar imágenes no basta para añadir candidatas. No se pueden insertar imágenes en una inferencia principal ya iniciada: Analyze devuelve sus observaciones como resultado de herramienta y la imagen se adjunta cuando el usuario envía un mensaje posterior.

La detección de duplicados usa bytes idénticos, no similitud visual. Los adjuntos manuales tienen prioridad y se conservan si el usuario decide volver a adjuntarlos, aunque estén en el historial. Se omiten las imágenes ya adjuntadas automáticamente dentro del historial inspeccionado. Las candidatas fallidas pueden reintentarse; si falla la automatización, adjunta la imagen manualmente. Si una imagen manual no puede leerse para compararla, se conserva y se posponen las adiciones automáticas. No se reescriben mensajes anteriores.

Configuración

La configuración guardada en un chat tiene prioridad sobre los valores predeterminados.

Etiqueta	Valor predeterminado	Significado
Image analysis backend	Auto	Strata para el modelo auxiliar de interfaz reconocido; en otros casos, el modelo local de visión cargado.
Strata analysis model	`strata`	Modelo para el análisis independiente en Strata.
Automatically attach page images	Activado	Procesar la primera URL antes de inferir.
Attach analyzed images on the next turn	Activado	Adjuntar las imágenes de Analyze elegibles en el siguiente mensaje del usuario.
Default page URL	Vacío	URL alternativa para `@inject-url` sin dirección.
Maximum attached images	2	Cupos automáticos menos las imágenes manuales actuales; configurable de 1 a 4.
Start image number	1	Posición inicial de las imágenes de página, contando desde 1.
Strata analysis Base URL	`http://127.0.0.1:8080/v1`	Dirección del servicio, en la configuración global.
Strata analysis API key (optional)	Vacío	Credencial global.

La configuración de Strata es independiente de la del complemento generador. El modo explícito Strata (separate request) omite la selección de modelo local. Ambos análisis esperan la respuesta completa de Strata; el múltiple envía todas las imágenes en una sola solicitud. El modelo auxiliar de interfaz no ejecuta esa inferencia. Si se analizan cuatro imágenes y el límite de adjuntos es dos, las candidatas pendientes se adjuntan en orden de entrada a lo largo de los siguientes mensajes del usuario.

Formatos, límites y resolución de problemas

Las herramientas locales reconocen JPG/JPEG, PNG, WebP, GIF, BMP, TIFF/TIF y AVIF. Las descargas de página aceptan tipos MIME PNG/JPEG/WebP/GIF.
La inserción directa y el análisis local conservan los bytes JPEG/PNG y convierten otros formatos a PNG. Las solicitudes Strata mantienen la ruta WebP existente. La conversión conserva las dimensiones, aplica la orientación y usa el primer fotograma de una animación; admite hasta 40 megapíxeles de entrada.

Esto no significa que Gemma no admita WebP en general. En un entorno probado, el mismo WebP funcionó mediante la subida normal del SDK, pero falló al insertarlo directamente con base64:; el PNG convertido sí funcionó en esa ruta. La conversión evita ese problema específico. Si falla un chat antiguo tras actualizar, prueba en uno nuevo o adjunta PNG/JPEG manualmente. Consulta la documentación de entrada de imágenes y el informe de compatibilidad GUI/API.

Los fallos automáticos se muestran en el estado y la información de depuración, conservando los adjuntos correctos. Un fallo explícito de @inject-url detiene el preprocesamiento. La función automática no guarda imágenes ni sidecars en el directorio de trabajo; utiliza las herramientas de descarga cuando necesites archivos locales.

Desarrollo y documentación

Las pruebas usan mensajes reales del SDK, conversión de imágenes, archivos y HTTP, con respuestas de modelo/controlador sustituidas. Verifican el transporte y el comportamiento, no la calidad de comparación visual de un modelo real. La visión y el uso de varias imágenes también dependen del modelo y del servicio seleccionados.

El README.md en inglés es la guía pública principal; las otras cuatro versiones cubren el mismo contenido. Consulta la política de publicación e idiomas. Añadir traducciones no publica el complemento.

Créditos y licencia

Bifurcación de Analyze Images. Proyecto original/revisado: vadimfedenko/analyze-images. Cambios de la versión Advanced: Yuan Jumay. MIT; conserva los avisos originales de derechos de autor y licencia.