oneshim-vision
Edge 이미지 처리를 담당하는 크레이트. 스크린 캡처, 델타 인코딩, OCR, PII 필터링을 수행합니다.
주요 기능
스마트 캡처 결정
이벤트의 중요도를 분석하여 캡처 여부와 처리 수준을 자동 결정합니다.
| 중요도 | 처리 |
|---|---|
| 높음 | Full 캡처 + OCR 텍스트 추출 |
| 중간 | 델타 인코딩 (변경 영역만) |
| 낮음 | 썸네일만 생성 |
| 최소 | 메타데이터만 기록 |
델타 인코딩
이전 프레임과 비교하여 변경된 영역만 추출합니다.
- 타일 단위 비교로 변경 감지
- 변경 없으면 전송 데이터 0
- 부분 변경 시 원본 대비 70-90% 데이터 감소
WebP 인코딩
중요도에 따라 적절한 품질로 이미지를 압축합니다.
PII 필터링 (개인정보 보호)
OCR로 추출된 텍스트에서 민감 정보를 자동 마스킹합니다.
| 대상 | 마스킹 결과 |
|---|---|
| 이메일 주소 | [EMAIL] |
| 신용카드 번호 | [CARD] |
| 주민등록번호 | [SSN] |
| 사용자 경로 | [USER_PATH] |
| 전화번호 | [PHONE] |
OCR (텍스트 추출)
화면 캡처에서 텍스트를 추출합니다 (옵션 기능).
- 한국어 + 영어 지원
- 환경변수로 데이터 경로 지정 가능
- Feature flag로 비활성화 가능
처리 파이프라인
플랫폼 지원
| 기능 | macOS | Windows | Linux |
|---|---|---|---|
| 전체 화면 캡처 | ✅ | ✅ | ✅ |
| 활성 창 캡처 | ✅ | ✅ | ⚠️ (X11) |
| OCR | ✅ | ✅ | ✅ |
관련 문서:
- 클라이언트 개요
- oneshim-core - 이미지 페이로드 모델
- oneshim-monitor - 캡처 트리거 이벤트