카-스 프리

디시인사이드에서 혐오 이미지를 사전에 감지하여 안구를 보호합니다.

# 카-스 프리 (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** 인간을 널리 이롭게 하기 위해 제작되었습니다.