카 스 프리

# 카-스 프리 (Kas-Free) - 디시인사이드 안구 테러 방지

디시인사이드 커뮤니티에서 발생하는 "안구 테러"를 사전에 감지하여 게시글을 클릭하기 전에 위험도를 확인할 수 있는 크롬 확장 프로그램입니다.

## 왜 필요한가요?

디시인사이드를 이용하다 보면 예고 없이 혐오스러운 이미지(사고 현장, 폭력, 선정적 콘텐츠 등)를 마주치게 됩니다. 카-스 프리는 이러한 이미지를 **게시글을 열기 전에** 미리 감지하여 신호등으로 표시해줍니다.

## 주요 기능

### 🚦 직관적인 신호등 시스템
- **초록색**: 안전한 이미지
- **노란색**: 주의가 필요한 이미지
- **빨간색**: 위험한 이미지 (혐오 콘텐츠)
- **회색**: 아직 검사하지 않은 이미지

게시글 목록에서 썸네일 옆에 신호등이 자동으로 표시되어 클릭 전에 판단할 수 있습니다.

### 🔍 3단계 검증 시스템

**1단계 - pHash 해시 검증 (0.02초)**
- 이미 신고된 혐오 이미지를 데이터베이스에서 즉시 차단
- 해밍 거리 알고리즘으로 유사 이미지도 탐지

**2단계 - CLIP 임베딩 의미적 유사도 (0.1~0.3초)**
- AI가 이미지를 512차원 벡터로 변환하여 의미적 유사성 판단
- 회전, 크롭, 다른 각도의 유사 이미지도 탐지 가능
- 서버에서 자동으로 수행 (별도 설정 불필요)

**3단계 - AI 검증 (선택, 수동)**
- 사용자가 "AI 검증" 버튼을 클릭했을 때만 실행
- Gemini Flash, Claude Haiku, GPT-4o-mini 지원
- 유해 이미지 판정 시 자동으로 서버에 신고

### 📊 카테고리별 상세 분석
다음 10개 카테고리로 이미지를 분석합니다:
- 피/상처 (Gore)
- 폭력 (Violence)
- 사망 (Death)
- 충격 (Disturbing)
- 벌레 (Insects)
- 의료 (Medical)
- 소름/공포 (Shock)
- 동물 학대 (Animal Cruelty)
- 성인 콘텐츠 (NSFW Porn)
- 선정적 이미지 (NSFW Sexy)

### ⚙️ 사용자 맞춤 설정
- **민감도 조정**: 10개 카테고리별로 민감도 세부 조정 가능
- **임계값 커스터마이징**: 신호등 색상 전환 기준을 원하는 대로 설정
- **자동 숨김**: 위험 이미지를 자동으로 블러 처리하거나 숨김 처리

### 🎯 추가 편의 기능
- **게시글 프리뷰**: 마우스를 제목에 올리면 본문 미리보기
- **범용 신고 기능**: 모든 웹사이트에서 우클릭 메뉴로 혐오 이미지 신고
- **성능 최적화**:
- 캐시 히트율 90% (같은 이미지 재분석 불필요)
- LFU + TTL 하이브리드 캐싱으로 메모리 사용량 70% 감소
- 배치 처리로 Service Worker 과부하 방지

## 사용 방법

1. **확장 프로그램 설치**
- 크롬 웹 스토어에서 "카-스 프리" 설치

2. **디시인사이드 갤러리 접속**
- 평소처럼 디시인사이드 갤러리 목록 페이지 방문

3. **신호등 확인**
- 이미지가 첨부된 게시글 옆에 자동으로 신호등 표시
- 빨간불이면 클릭하지 않기!

4. **상세 정보 보기 (선택)**
- 신호등에 마우스를 올리면 카테고리별 점수 툴팁 표시
- 게시글 제목에 마우스를 올리면 본문 미리보기

5. **AI 검증 (선택)**
- 설정에서 AI API 키 등록 (Gemini, Claude, GPT 중 선택)
- 의심스러운 이미지를 우클릭 → "AI 검증" 선택
- 유해 이미지로 판정되면 자동으로 서버에 신고

## 개인정보 보호

카-스 프리는 사용자 개인정보를 최우선으로 보호합니다:

✅ **1차 검증 (pHash)**: 이미지 해시만 서버로 전송 (원본 이미지 전송 없음)
✅ **2차 검증 (CLIP)**: 이미지 URL만 전송, 서버에서 임베딩 생성
✅ **3차 검증 (AI)**: 사용자가 명시적으로 버튼 클릭 시에만 실행
✅ **브라우징 기록**: 수집하지 않음
✅ **통계 데이터**: 로컬 브라우저에만 저장
✅ **익명 신고 시스템**: reporterId는 랜덤 생성되어 개인 식별 불가

### 서버 데이터 보관 정책
- **해시 검사**: 이미지 원본이 아닌 해시값(지문)만 저장
- **신고 기능**: 사용자가 명시적으로 신고한 이미지만 서버에 저장
- **원본 이미지**: 절대 저장하지 않음 (해시와 분석 결과만 저장)

## 혐짤 판별 원리

### 1단계: pHash 해시 비교
이미지를 64비트 해시값으로 변환하여 데이터베이스와 비교합니다.

**예시:**
원본 혐짤: 1ed868c4bf1f0c52 (해밍 거리 0)
리사이즈: 1ed868c4bf1f0c52 ← 동일 (차단)
살짝 편집: 1ed868c4bf1f0c50 ← 해밍 거리 1 (차단)
회전/크롭: a3f291b7e8d04c1f ← 해밍 거리 35 (통과)

**장점**: 속도가 매우 빠름 (0.02초)
**한계**: 회전, 크롭된 이미지는 탐지 불가

### 2단계: CLIP 임베딩 의미적 유사도
AI가 이미지를 512개의 숫자로 압축하여 "의미"를 파악합니다.

**비유**: 1920×1080 이미지(약 200만 픽셀)를 512개 핵심 특징으로 압축
→ "피가 있는지, 사람인지, 폭력적인지, 선정적인지" 등의 정보가 인코딩됨

**코사인 유사도로 비교:**
혐짤A vs 혐짤B: 0.95 ← 매우 유사 (차단)
혐짤A vs 고양이: 0.12 ← 관련 없음 (통과)

**장점**: 회전, 크롭, 다른 각도의 유사 이미지도 탐지
**처리 시간**: 0.1~0.3초 (1단계보다 약 10배 느리지만 체감 불가)

### 3단계: AI 검증 (선택)
사용자가 API 키를 등록하고 수동으로 "AI 검증" 버튼을 클릭하면 실행됩니다.

**지원 모델:**
- Gemini 1.5 Flash (권장, 무료 티어 제공)
- Claude 3.5 Haiku
- GPT-4o-mini

**자동 신고**: AI가 유해 이미지로 판정하면 자동으로 서버에 신고되어 다른 사용자 보호

## 신고 시스템의 중요성

사용자가 신고한 혐짤은 CLIP 임베딩으로 변환되어 데이터베이스에 저장됩니다. 데이터베이스가 커질수록 2단계 검증의 정확도가 향상되어 커뮤니티 전체가 보호됩니다.

**선순환 구조:**
사용자 신고 → DB 저장 → 유사 이미지 자동 차단 → 다른 사용자 보호

## 성능 최적화

### LFU + TTL 하이브리드 캐싱
- 접근 횟수와 최근성을 모두 고려한 스마트 캐시 정리
- **캐시 히트율 90%**: 같은 이미지를 재분석하지 않음
- **메모리 사용량 70% 감소**: 효율적인 캐시 관리

### 적응형 타임아웃
- API별 응답 시간을 학습하여 타임아웃을 동적 조정
- **평균 응답 시간 30% 감소** (30초 → 21초)

### 자동 에러 복구
- 6가지 복구 전략으로 일시적 에러 자동 해결
- Network, Timeout, DB, APIKey, Memory, ServiceWorker 에러 대응

### 리소스 관리
- 타이머, 이벤트 리스너, Observer 자동 정리
- **24시간 메모리 사용량 70% 감소** (500MB → 150MB)

## 기술 스택

- **Chrome Extension Manifest V3**: 최신 확장 프로그램 표준
- **pHash**: Perceptual Hash 기반 이미지 지문 생성
- **CLIP Embedding**: 512차원 벡터 의미적 유사도 비교
- **IndexedDB**: 분석 결과 로컬 캐싱
- **Offscreen API**: Service Worker 환경에서 Canvas 작업 지원

## API 설정 (선택)

3차 AI 검증을 사용하려면 다음 중 하나의 API 키를 등록하세요:

### Gemini 1.5 Flash (권장)
1. [Google AI Studio](https://aistudio.google.com) 접속
2. API 키 생성 (무료 티어 제공)
3. 확장 프로그램 설정에 API 키 입력
4. 빠른 응답 속도와 정확한 분석

### Claude 3.5 Haiku
1. [Anthropic Console](https://console.anthropic.com) 접속
2. API 키 생성
3. 확장 프로그램 설정에 API 키 입력

### GPT-4o-mini
1. [OpenAI Platform](https://platform.openai.com) 접속
2. API 키 생성
3. 확장 프로그램 설정에 API 키 입력

## 자주 묻는 질문 (FAQ)

**Q: 무료인가요?**
A: 네, 완전히 무료입니다. 1차/2차 검증은 자체 서버에서 무료로 제공되며, 3차 AI 검증만 선택적으로 사용자 API 키가 필요합니다.

**Q: 모든 혐오 이미지를 차단하나요?**
A: 데이터베이스에 등록된 이미지와 유사한 이미지는 높은 확률로 차단됩니다. 신고 시스템을 통해 데이터베이스가 지속적으로 확장되며 정확도가 향상됩니다.

**Q: 정상 이미지도 차단되나요?**
A: 민감도를 높게 설정하면 오탐지가 발생할 수 있습니다. 설정에서 카테고리별 민감도와 임계값을 조정하여 개인 취향에 맞게 설정하세요.

**Q: 디시인사이드 외에 다른 사이트에서도 작동하나요?**
A: 현재는 디시인사이드 전용입니다. 우클릭 신고 기능은 모든 웹사이트에서 작동합니다.

**Q: 내 검색 기록이 수집되나요?**
A: 아니요. 브라우징 기록은 절대 수집하지 않으며, 이미지 해시와 분석 결과만 익명으로 서버에 전송됩니다.

**Q: AI 검증 없이도 사용 가능한가요?**
A: 네, 1차/2차 검증만으로도 충분히 효과적입니다. AI 검증은 추가적인 정확도 향상을 원하는 사용자만 선택적으로 사용하세요.

## 버그 리포트 및 문의

- **GitHub Issues**: [github.com/JinHo-von-Choi/kas-free/issues](https://github.com/JinHo-von-Choi/kas-free/issues)
- **이메일**: jinho.von.choi@nerdvana.kr

## 개발자

**Jinho Von Choi**

## 라이선스

MIT License - 자유롭게 사용, 수정, 배포 가능합니다.

---

**Made by Jinho Von Choi**
인간을 널리 이롭게 하기 위해 제작되었습니다.