Analyze Images Advanced for LM Studio

버전 0.6.0 — 로컬 이미지를 찾고, 한 장을 분석하거나 여러 장을 함께 비교하며, 모델이 다음 응답을 생성하기 전에 관련 이미지를 자동으로 첨부합니다.

Analyze Images의 확장 포크입니다. 이미지와 출처 메타데이터를 작업 폴더에 저장하는 Visit Website Advanced, DuckDuckGo Advanced와 함께 사용할 수 있습니다.

설치 및 시작

플러그인 ID는 yuanjumay/analyze-images-advanced입니다. LM Studio Hub에서 설치할 때는 페이지의 설치 기능을 사용하세요. 이 문서는 0.6.0을 설명하며, 공개된 리비전은 로컬 버전과 다를 수 있습니다.

로컬 소스에서 설치하려면 이 플러그인의 폴더에서 실행하세요. 예시는 Windows PowerShell 기준이며, macOS/Linux에서는 npm.cmd 대신 npm을 사용하세요.

채팅에서 플러그인을 활성화하고 이미지 입력을 지원하는 로컬 모델이나 Strata 엔드포인트를 설정하세요. 로컬 이미지 도구를 사용하려면 채팅의 작업 폴더를 지정해야 합니다. 중복 처리를 피하려면 이전 이미지 주입 테스트 플러그인과 테스트 MCP 서버를 비활성화하세요.

도구

실제 화면과 일치하도록 모든 언어의 안내서에서 도구 이름과 설정 라벨은 영어로 유지합니다.

도구	용도
List Local Images Advanced	로컬 이미지 경로와 사용 가능한 메타데이터 목록.
Search Local Images Advanced	파일명, 캡션, 출처 페이지 URL 등의 메타데이터로 검색.
Analyze Local Image Advanced	확인된 로컬 이미지 한 장 분석.
Multi Analyze Local Images Advanced	2–4장을 한 번의 추론 요청으로 함께 분석하거나 비교.

분석 전에 List/Search로 정확한 파일명을 확인하세요. 서로 다른 분석 대상마다 sidecar JSON 메타데이터 파일이 필요하며, 호환되는 다운로드 플러그인이 이 파일을 생성합니다. 로컬 번호나 JSON-LD 이미지 순서만으로 파일을 추측하지 마세요. 상대 경로를 지원하고 절대 경로와 상위 폴더로 벗어나는 경로는 거부합니다. 썸네일을 선택하면 해당 원본 크기의 이미지를 우선 찾습니다.

요청 예시:

다중 분석의 인수는 imageNames, prompt, 선택 사항인 context입니다. 입력 순서가 Image 1, Image 2 등에 대응합니다. 결과에는 공동 분석문 analysis, 순서와 출처를 나타내는 images, 중복 제거 수 duplicatesRemoved가 포함됩니다. 바이트가 완전히 같은 이미지는 하나로 정리하며, 서로 다른 이미지가 최소 두 장 남아야 합니다. 잘못된 입력이나 크기 초과가 있으면 일부 이미지만으로 추론을 시작하지 않습니다.

자동 첨부와 수동 재시도

페이지 이미지 자동 첨부를 켜면 메시지의 페이지 URL에서 이미지를 가져와 주 모델의 추론이 시작되기 전에 첨부합니다. URL 자동 처리를 꺼도 다음 형식으로 명시적으로 실행할 수 있습니다.

첫 번째 HTTP(S) URL만 처리합니다. 페이지와 일치하는 JSON-LD Product.image를 우선하며, 일치 항목이 없으면 첫 Product를 사용합니다. 이미지가 없으면 OG/Twitter 이미지, 그다음 main/article 내부 이미지 순으로 찾습니다. 출처의 순서와 URL 대응을 유지하고, 페이지 설명·alt 텍스트·리뷰를 이미지 분석 결과로 주입하지 않습니다.

단일 또는 다중 분석에 성공한 이미지도 다음 사용자 메시지의 후보가 됩니다. 우선순위는 이번 수동 첨부 → 이 채팅의 최근 Analyze 대상 → 페이지 이미지입니다. 다운로드나 목록 조회만으로는 후보에 등록되지 않습니다. 이미 실행 중인 주 모델 추론에 실제 이미지를 삽입할 수는 없습니다. Analyze는 분석문을 즉시 도구 결과로 반환하고, 이미지는 이후 사용자가 메시지를 보낼 때 첨부합니다.

중복은 시각적 유사도가 아닌 이미지 바이트의 완전 일치로 판단합니다. 수동 첨부를 우선하며, 과거에 첨부했더라도 이번에 직접 다시 첨부한 이미지는 유지합니다. 이미 자동 첨부된 이미지는 검사하는 기록 범위에서 건너뜁니다. 실패한 후보는 재시도할 수 있고, 자동 처리에 실패하면 수동 첨부로 보완할 수 있습니다. 수동 이미지를 비교용으로 읽을 수 없으면 유지한 채 자동 추가를 미룹니다. 이미 보낸 메시지는 수정하지 않습니다.

설정

기존 채팅에 저장된 설정이 기본값보다 우선합니다.

라벨	기본값	의미
Image analysis backend	Auto	알려진 UI 보조 모델이면 Strata, 그 외에는 로드된 로컬 비전 모델 사용.
Strata analysis model	`strata`	독립 Strata 분석에 사용할 모델명.
Automatically attach page images	켜짐	추론 전에 첫 URL 처리.
Attach analyzed images on the next turn	켜짐	조건에 맞는 Analyze 이미지를 다음 사용자 메시지에 첨부.
Default page URL	비어 있음	URL 없는 `@inject-url`의 대체 주소.
Maximum attached images	2	이번 수동 이미지 수를 차감한 자동 첨부 슬롯. 1–4로 설정 가능.
Start image number	1	페이지 이미지 선택 시작 위치. 1부터 계산.
Strata analysis Base URL	`http://127.0.0.1:8080/v1`	전역 엔드포인트 설정.
Strata analysis API key (optional)	비어 있음	전역 인증 정보 설정.

Strata 설정은 생성기 플러그인의 설정과 별개입니다. **Strata (separate request)**를 명시적으로 선택하면 로컬 모델을 선택하지 않습니다. 단일·다중 분석 모두 Strata 응답이 완료될 때까지 기다리며, 다중 분석은 모든 이미지를 한 요청에 담아 보냅니다. UI 보조 모델이 해당 추론을 수행하지 않습니다. 네 장을 분석하고 첨부 상한이 두 장이면, 아직 첨부하지 않은 이미지를 입력 순서대로 두 장씩 이후 사용자 메시지에 첨부합니다.

형식, 제한 및 문제 해결

로컬 도구는 JPG/JPEG, PNG, WebP, GIF, BMP, TIFF/TIF, AVIF를 인식합니다. 페이지 다운로드는 PNG/JPEG/WebP/GIF MIME 유형을 받습니다.
직접 인라인 첨부와 로컬 분석은 JPEG/PNG 바이트를 유지하고 다른 형식을 PNG로 변환합니다. Strata 요청은 기존 WebP 경로를 유지합니다. 변환은 크기를 줄이지 않고 방향 정보를 적용하며, 애니메이션의 첫 프레임을 사용합니다. 변환 입력은 4,000만 픽셀까지입니다.
이미지당 8 MiB, 자동 첨부 또는 다중 분석 배치의 합계는 16 MiB까지이며 변환 후에도 적용됩니다. 자동 첨부 제한 때문에 서로 다른 수동 이미지를 삭제하지 않습니다.
페이지 HTML은 3 MiB, 네트워크 가져오기는 합계 45초까지입니다. 정적 HTML만 처리하며 JavaScript 실행, 로그인, 재귀 탐색, 일반적인 srcset 처리는 하지 않습니다.
다음 메시지로의 전달은 최근 64개 메시지에서 24시간 이내의 후보 최대 8개를 확인합니다. 작업 폴더 공유 큐가 아니라 해당 채팅의 기록을 사용합니다. 기록 삭제·압축이나 파일 변경으로 전달이 불가능할 수 있고, 검사 범위 밖의 오래된 이미지는 다시 자동 첨부될 수 있습니다.
비교용 읽기 예산은 전송당 32 MiB이며, 파일 해시를 최대 256개 캐시합니다. 이미지 버퍼는 상주 큐에 보관하지 않습니다.
이미지 바이트는 채팅 내부의 인라인 데이터로 보존되므로 Base64 부분의 저장량은 원본의 약 4/3입니다. 과거의 깨진 임시 참조나 기존 WebP 첨부를 자동 복구하지 않습니다.

Gemma가 WebP를 전반적으로 지원하지 않는다는 뜻은 아닙니다. 검증한 한 환경에서 같은 WebP는 일반 SDK 업로드로 성공했지만 원시 base64: 직접 첨부로 실패했고, PNG 변환 후에는 직접 첨부도 성공했습니다. 변환은 이 경로의 호환성 대책입니다. 업데이트 후에도 과거 채팅에서 실패하면 새 채팅에서 다시 시도하거나 PNG/JPEG를 수동 첨부하세요. 공식 이미지 입력 문서와 GUI/API 호환성 보고를 참고하세요.

자동 처리 실패는 상태·디버그 정보로 알리며 성공한 첨부는 유지합니다. 명시적 @inject-url이 실패하면 전처리를 중단합니다. 페이지 자동 첨부는 작업 폴더에 이미지나 sidecar를 저장하지 않으므로, 로컬 파일이 필요하면 다운로드 도구를 사용하세요.

개발 및 문서

테스트는 실제 SDK 메시지, 이미지 변환, 파일, HTTP를 사용하고 모델·컨트롤러 응답은 대체합니다. 실제 모델의 비교 품질이 아니라 전송과 동작을 확인합니다. 이미지 및 다중 이미지 지원은 선택한 모델과 백엔드에도 달려 있습니다.

영어 README.md가 기본 공개 안내서이며 나머지 네 언어도 같은 범위를 설명합니다. 공개 및 언어 유지 정책을 참고하세요. 번역 추가만으로 플러그인이 공개되지는 않습니다.

크레디트 및 라이선스

Analyze Images의 포크입니다. 원본/개선 프로젝트: vadimfedenko/analyze-images. Advanced 포크 수정: Yuan Jumay. MIT. 원본 저작권 및 라이선스 고지를 유지하세요.