📖상세가이드 ▼상세가이드 접기 ▲
💡1. 도구 개요 및 필요성 (Overview & Purpose)
Every-Forge 텍스트 & 인코딩 워크벤치는 RFC 4648 규격의 Base64(표준/URL-Safe/Hex), UTF-8 멀티바이트 바이트 스트림 변환, CRLF/LF 개행 정규화, 대소문자 및 프로그래밍 명명 규칙(CamelCase/snake_case) 변환을 100% 클라이언트 메모리 격리 환경에서 실시간으로 처리하는 종합 엔지니어링 툴킷입니다.
- 브라우저의 V8 엔진 샌드박스 내부에서 동작하여 민감한 API 토큰, 데이터베이스 덤프, 패스워드 등의 유출 위험(Zero-Transit)을 원천 차단합니다.
- 한글(EUC-KR/CP949) 및 특수 다국어 문자가 포함된 문자열을 깨짐 없이 완벽하게 UTF-8 바이트 배열 및 Base64로 상호 인코딩합니다.
- Windows(CRLF)와 Linux/macOS(LF) 간의 줄바꿈 비호환 문제를 원클릭으로 정규화하여 깃(Git) 커밋 diff 오염을 방지합니다.
- 실시간 글자 수(Chars), 라인 수(Lines), UTF-8 바이트 크기(Bytes) 및 EOL 상태 텔레메트리를 제공합니다.
⚙️2. 계산 공식 및 알고리즘 동작 원리 (Algorithm & Formulation)
1. RFC 4648 Base64 비트 패킹: 3바이트(24비트)의 2진 데이터를 6비트씩 4개의 정수로 분할하여 64개 색인 문자로 매핑 (2^6 = 64).
2. 패딩 규칙(=): 입력 데이터가 3의 배수가 아닐 경우, 부족한 비트 수에 따라 말단에 '=' 패딩 문자 1개 또는 2개를 부착.
3. 멀티바이트 UTF-8 처리: JS 내장 btoa()의 Latin-1 한계를 극복하기 위해 TextEncoder/TextDecoder TypedArray 파이프라인 적용.
4. EOL 정규화 알고리즘: 정규식 /\r\n|\r|\n/g 를 통해 Windows CRLF(\r\n) 및 Unix LF(\n)를 일관되게 치환.
📋3. 단계별 실무 활용 가이드 (Step-by-Step Guide)
- 1단계: 상단 툴바에서 원하는 변환 카테고리(CASE, EOL, CHARSET, CODEC)를 선택합니다.
- 2단계: 좌측 [Input] 영역에 원본 텍스트를 입력하거나 'Paste' 버튼을 누릅니다. (Ctrl+Enter 단축키 지원)
- 3단계: 우측 [Output] 영역에 변환된 데이터가 실시간으로 렌더링되며, 상단 툴바에서 Base64, Hex, URL, HTML Entity 버튼을 눌러 즉시 변경할 수 있습니다.
- 4단계: 'Swap to Input' 버튼으로 출력 결과를 입력으로 역전환하여 양방향 디코딩 작업을 연속 수행할 수 있습니다.
- 5단계: 'Copy Output' 버튼을 클릭하여 클립보드에 복사합니다.
❓4. 자주 묻는 질문 및 오류 해결 (FAQ & Troubleshooting)
자바스크립트 기본 btoa() 함수는 8비트 Latin-1 범위만 지원하여 한글(가~힣) 입력 시 오류가 발생합니다. Every-Forge는 UTF-8 바이트 스트림 변환 엔진을 거쳐 안전하게 인코딩합니다.
일반 Base64의 '+'와 '/' 문자는 URL 파라미터나 쿼리 스트링에서 특수문자로 오작동할 수 있습니다. URL Safe Base64는 '+'를 '-', '/'를 '_'로 치환하고 패딩(=)을 제거합니다.
모든 처리가 서버로 전송되지 않고 사용자의 로컬 브라우저 RAM 메모리에서 Web Worker/비동기 스트림으로 처리되므로 완벽히 안전하며 데이터 유출이 없습니다.