figlens
문서 메뉴 · 시맨틱 검색
언어 한국어

선택형 시맨틱 검색

실험적 기능입니다. figlens search <file> <query> --mode semantic|hybrid는 로컬 모델로 레이어를 의미 기준으로 순위 매깁니다. 기본값 --mode text는 그대로이며 모델이 필요 없습니다.

  • 최초 1회 설정. BAAI/bge-m3 리비전 5617a9f61b028005a4858fdac845db406aefb181(MIT, config.json, pytorch_model.bin, tokenizer.json)를 직접 내려받으세요. figlens는 내려받지 않습니다. figlens models configure bge-m3 --model DIR [--runtime FILE]는 파일을 SHA-256으로 검증하고, figlens-embed 런타임을 오프라인으로 한 번 실행(--runtime이 없으면 figlens 실행 파일 옆에서 찾음)한 뒤 설정 디렉터리의 models.json에 프로파일을 기록합니다. models list|status로 확인하고, models remove bge-m3는 프로파일을 지우되 파일은 남깁니다.
  • 비주얼 프로필. figlens models configure siglip-base --model DIR는 google/siglip-base-patch16-224 리비전 7fd15f0689c79d79e38b1c2e2e2370a7bf2761ed(Apache-2.0; config.json, preprocessor_config.json, model.safetensors)를 같은 방식으로 확인하고 비주얼 검색용 이미지 모델로 등록합니다.
  • 이미지 검색(실험적). figlens search --workspace DIR --image shot.png는 workspace의 유닛을 생김새로 정렬합니다. --image-ref '{"sourceId":…,"snapshotId":…,"nodeId":…}'는 결과에 저장된 렌더를 대신 쓰고, --crop x,y,w,h는 둘 다 잘라냅니다. 검색어를 더하면 hybrid가 됩니다. 비주얼 레이어는 figlens index visual이 만듭니다(검색은 만들지 않으며 단일 .fig 검색은 이미지를 거부합니다). 이미지 프로필이 없거나 실패하면 픽셀 해시로만 정렬하고 query.usedModes에 그렇게 표시합니다. 검색 이미지는 저장되지 않습니다. 정렬 규칙은 아직 검증 중이므로 결과는 단서로 보세요. MCP: search의 image(root 안의 경로), imageRef, crop.
  • 모드. semantic은 각 레이어를 이름, 텍스트, 컴포넌트 속성, 범위 중 가장 잘 맞는 청크로 순위 매깁니다. hybrid는 텍스트와 시맨틱 순위를 합칩니다(Reciprocal Rank Fusion). 프로파일이 없으면 semantic은 mode_unavailable로 실패하고, hybrid는 텍스트 결과와 이유를 반환합니다. coverage.layers.semantic은 ready, partial, unavailable을 보고하며, 부분 페이지에는 nextCursor가 없습니다. 모델은 CPU에서 실행되며 Ctrl-C는 현재 요청을 멈춥니다. 각 MCP/뷰어 프로세스는 사용 후에도 텍스트 모델과 이미지 모델을 하나씩 메모리에 유지할 수 있습니다. 한 Linux ARM 측정에서 텍스트만 약 2.5 GiB, 두 모델의 최고 메모리 사용량 합계는 약 3.5 GiB였으며 코어와 인덱스 작업자는 제외했습니다. 측정값이며 메모리 상한이 아닙니다.
  • 제한. 레이어 이름, 유효 텍스트, 인스턴스의 컴포넌트 속성 값(정확히 해석할 수 없는 값은 제외하고 개수를 보고), 각 레이어의 페이지와 컨테이너 이름을 임베딩합니다. --workspace/--id 검색은 각 소스의 저장된 모델 레이어를 읽으며 디자인 텍스트를 임베딩하지 않습니다. 레이어는 figlens index embed로 만듭니다(MCP 서버는 텍스트 빌드 뒤에 큐에 넣습니다). 없는 소스는 pending이고 페이지는 부분 결과입니다. 이 기능의 고정 테스트 세트에서 모델은 동의어·목적 질의의 품질 기준을 넘지 못했습니다(top-1 오답률 0.25, 기준 0.20). 결과는 참고용으로 보세요.
  • MCP. models 도구(list, status, configure, remove)와 search의 mode가 있습니다. configure는 figlens 옆의 figlens-embed만 실행하며, 모델 디렉터리와 파일은 서버 root 안에 있어야 합니다. 호출을 취소하면 실행 중인 검색이나 설정이 멈춥니다.

이 페이지는 저장소의 docs/README-ko.md에서 생성되었습니다.