BGA Codex 한국어 번역 도우미

Microsoft Edge 확장 프로그램

BGA 한국어 번역을 돕는 도구

빈 번역란의 영어 문구를 Codex로 번역합니다.
게임별 용어를 맞추고, 변수와 태그를 검사한 뒤 BGA에 저장합니다.

Windows · Edge · Codex CLI 필요

boardgamearena.com / translation영어 → 한국어

게임 문구 번역

예시 문구 3개
#영어 원문한국어 번역
01Draw ${count} cards.번역 없음
02Choose a player.번역 없음
03End your turn.번역 없음

이미 번역된 입력란은 건너뜁니다.

동작을 설명하기 위해 재구성한 화면입니다. 예시 버튼은 BGA에 저장하지 않습니다.자동 번역 · 수동 복사/검증 지원

작업 순서

원문 수집번역 기준 검토번역검증·저장

검토와 저장

새 번역 기준은 사용자가 승인합니다.
자동 저장은 검증 오류와 경고가 모두 없을 때 진행합니다.

애플리케이션 아키텍처

자동 번역 모드의 구성과 데이터 흐름

BGA Codex 구성요소와 데이터 흐름Edge의 콘텐츠 스크립트가 BGA 원문을 수집하고 번역을 검증합니다. 서비스 워커가 Native Messaging으로 Windows 호스트와 통신하고 Debugger로 페이지에 입력합니다. 호스트는 번역 기준 검토와 사용자 승인, Codex CLI 실행, 로컬 파일 기록을 담당합니다. 실선 화살표는 요청과 처리, 점선 화살표는 결과와 상태 반환을 표시합니다. 각 상자의 색상 띠는 웹 페이지, Edge 확장, Windows 프로그램, CLI 프로그램, 파일 저장소를 구분합니다. 번역 기준 및 검토 UI는 네이티브 호스트 내부 구성요소이며 별도 프로그램이 아닙니다.Microsoft EdgeWindows · 로컬 프로세스 / 파일웹 페이지BGA 번역 페이지HTML / DOM · 주입된 JS 브리지원문 · 번역 입력란page-bridge.js: 저장 감지Edge 확장콘텐츠 스크립트JavaScript · Content Script원문 수집 · 번역 검증content / core / corpus.jsEdge 확장서비스 워커JavaScript · Service Worker탭 관리 · 호스트 연결 · 입력Windows 프로그램 내부번역 기준 / 검토 UIC# · .NET 8 · Windows FormsGuideManagerTrayHostContext · 사용자 승인CLI 프로그램 · 별도 프로세스Codex CLICodex CLI · PowerShell 7로 실행공식 자료 조사 · 번역codex exec · 보정Windows 프로그램 · EXE네이티브 호스트 · 실행 제어C# · .NET 8 · Native MessagingAutomationCoordinator · CodexRunner · NativeMessaging파일 저장소로컬 파일texts/ : 원문·번역 기준 runs/ : 요청·응답·검증·저장 결과원문 수집저장 상태번역 요청검증 결과번역 후보진행 상태Debugger API검증된 번역 입력포커스 이동 → BGA 저장요청 / 검증 결과후보 / 저장 지시기준확인승인된번역 기준실행프롬프트결과JSON실행 기록 저장기준·결과 읽기Native MessagingJSON · stdin/stdout확장에서 검증 → 호스트에 결과 전달오류·경고가 있으면 Codex에 보정 요청
Edge 확장 · JavaScriptWindows 프로그램 · C# / .NETCLI · 별도 프로세스점선 테두리: 실행 환경실선 화살표: 요청·처리점선 화살표: 결과·상태 반환
자동 번역 모드의 주요 구성과 관계. BGA 로그인·쿠키는 브라우저에 유지됩니다. 표기 참고: C4 다이어그램 지침

설치 방법

Windows에 Edge, PowerShell 7, 로그인된 Codex CLI가 필요합니다.

  1. 프로젝트 폴더에서 PowerShell 7로 실행합니다.
    ./scripts/prepare-dotnet.ps1
    ./scripts/install-host.ps1
  2. Edge의 edge://extensions에서 개발자 모드를 켠 뒤, 압축 풀린 파일 로드로 이 프로젝트 폴더를 선택합니다.
  3. start-bga-automation.cmd를 실행하고 BGA에 로그인합니다.
  4. 번역 도우미 패널에서 자동 번역 시작을 누릅니다.
전체 설치 문서