GalTransl – AI 기반의 비주얼 노벨(가르게임) 자동 번역 도구

무엇인가요 – GalTransl은 GPT-4, Claude, DeepSeek, Sakura 등 대규모 언어 모델(LLM)을 사용하여 일본어 가르게를 중국어로 자동 번역하는 데스크탑 애플리케이션입니다. 스크립트 추출, 프롬프트 최적화된 LLM 번역, 사전 처리, 캐시, 재삽입을 통합하여 코드를 작성하지 않고도 완전한 "번역 패치"를 생성할 수 있습니다.

주요 기능

• 그래픽 데스크탑 UI (Tauri + React) – 명령줄 필요 없음, 다크 모드 지원, 사용자 정의 배경, 다중 프로젝트 관리 가능.
• LLM 백엔드 – GPT-4, Claude, DeepSeek, Sakura 및 기타 OpenAI 호환 API와 호환되며, 프롬프트 엔지니어링을 통해 번역 품질 향상.
• GPT 사전 – 각 요청 시 캐릭터 프로필, 이름 매핑, 어려운 용어를 LLM에 제공하는 특수 사전으로, 이름, 대명사, 전문 용어의 일관성 유지.
• 사전/사후 번역 사전 – LLM 출력 전후에 규칙 기반 문자열 치환 가능하며, 조건부 논리를 통해 과도한 치환 방지.
• 자동 캐시 및 재개 – 번역 결과는 캐시에 저장되며, 오류를 수정하기 위해 캐시를 편집하고 전체 재번역 없이 재개 가능.
• 풀 파이프라인 통합 – GARbro, KirikiriTools, SExtractor 등으로 스크립트 추출, 게임에 번역된 텍스트 재삽입, "패키지 없음" 및 패키지 형식 모두 지원.
• 자막 및 문서 지원 – .srt, .lrc, .vtt, mtool JSON, t++ Excel, epub 등 지원.
• 로컬 모델 – HuggingFace에서 GalTransl-7B-v3.5 및 GalTransl-14B-v3 모델에 대한 링크 제공. 장치 내 번역 가능 (≥6GB VRAM 필요).

설치 / 빠른 시작

1. 데스크탑 버전 (권장) – Releases 페이지에서 최신 zip 파일을 다운로드하여 압축 해제 후 GalTransl Desktop.exe를 더블클릭. 백엔드 서비스가 자동으로 시작되며, Python, Node, Rust 설치 필요 없음.
2. 개발자 / CLI 버전 – 리포지토리 복제 후 Python 3.11.9 설치, pip install -r requirements.txt (또는 제공된 배치 파일) 실행, Node.js 및 Rust 설치 후 run_desktop_dev.bat 실행 (CLI용은 run_GalTransl_terminal.bat 사용). 자세한 절차는 README의 "환경 준비" 섹션 참조.

일반 워크플로우

1. 게임 리소스 아카이브 식별 및 압축 해제 (GARbro, KirikiriTools 등 사용).
2. 스크립트를 name-message JSON 형식으로 추출 (GUI 도구 GalTransl_DumpInjector.exe가 도움).
3. 데스크탑 UI에서 프로젝트 생성, 추출된 JSON 파일 지정, LLM 백엔드 설정 (API 키, 엔드포인트, 모델).
4. 사전 설정 – 캐릭터 이름 및 반복되는 용어용 프로젝트 전용 GPT 사전 추가, 필요 시 사전/사후 사전 추가.
5. 번역 시작 – UI에서 실시간 진행 상황 표시. 결과는 자동으로 캐시됨.
6. 검토 및 수정 – VS Code 또는 EmEditor에서 transl_cache 파일(.JSON) 열고 pre_zh / proofread_zh 필드 편집 후 프로젝트 재실행하여 최종 json_cn 재생성.
7. 삽입 – 제공된 인젝터 도구로 번역된 JSON을 게임 스크립트에 재삽입 후 게임 테스트 (엔진이 지원하면 "패키지 없음" 로딩도 가능).

라이선스 – 리포지토리는 README에 표시된 배지에 따라 라이선스됨 (정확한 SPDX 식별자는 GitHub 페이지에 표시). 프로젝트는 HuggingFace에 GalTransl-7B-v3.5 및 GalTransl-14B-v3 모델 체크포인트를 호스팅하며, 각각의 라이선스에 따라 사용 가능.

---

GalTransl은 비주얼 노벨 스크립트 처리와 현대 LLM 번역 사이의 다리 역할을 하며, 사용자 친화적인 GUI와 사전 기반 품질 제어 도구를 제공하여 AI 지원 팬 번역의 신뢰성과 재현 가능성을 높입니다.