몰입형 번역

​

빠른 설치

​

지원되는 브라우저

• Chrome / Edge / Brave
• Firefox
• Safari

​

설치 단계

1. 브라우저의 확장 스토어를 방문합니다
2. “Immersive Translate”를 검색합니다
3. 설치를 클릭하여 브라우저에 추가합니다

​

APIYI 구성

​

1. 설정 열기

​

2. 번역 서비스 구성

1. 왼쪽 메뉴에서 “번역 서비스”를 선택합니다
2. “OpenAI” 서비스를 찾습니다
3. “Manage” 또는 “설정”을 클릭합니다
4. “Custom API Key”를 선택합니다

​

3. 구성 입력

• APIKEY: APIYI 키를 입력합니다
• 사용자 정의 API 인터페이스 주소: https://api.apiyi.com/v1/chat/completions
• 사용자 정의 모델: gpt-3.5-turbo (선택 사항)

​

핵심 기능

​

웹 페이지 번역

​

자동 번역

1. 외국어 웹 페이지를 방문합니다
2. 확장 프로그램이 언어를 자동 감지합니다
3. 번역 버튼을 클릭하여 시작합니다

​

수동 번역

1. 도구 모음에서 확장 프로그램 아이콘을 클릭합니다
2. “이 페이지 번역”을 선택합니다
3. 번역이 완료될 때까지 기다립니다

​

번역 모드

​

이중 언어 읽기(권장)

• 원래 형식을 유지합니다
• 번역이 원문 아래에 표시됩니다
• 비교 학습에 편리합니다

​

번역만

• 원문 텍스트를 완전히 대체합니다
• 빠르게 읽기에 적합합니다
• 언제든지 이중 언어로 다시 전환할 수 있습니다

​

단어 선택 번역

1. 번역할 텍스트를 선택합니다
2. 나타나는 번역 버튼을 클릭합니다
3. 팝업에서 번역을 확인합니다

​

고급 설정

​

사용자 지정 프롬프트

​

기술 문서

As a technical documentation translation expert, please:
1. Preserve all technical terms in original language
2. Provide Chinese explanations in parentheses
3. Maintain original format for code and commands

​

학술 논문

As an academic translation expert, please:
1. Use academically standard expressions
2. Preserve citation formats
3. Accurately translate professional terminology

​

문학 작품

As a literary translation expert, please:
1. Maintain literary beauty of original text
2. Be mindful of cultural background conversion
3. Preserve effect of rhetorical devices

​

번역 규칙

1. “번역 규칙” 설정으로 들어갑니다
2. 웹사이트 도메인을 추가합니다
3. 동작을 선택합니다:
   • 항상 번역
   • 절대 번역하지 않음
   • 스마트 판단

​

스타일 사용자 지정

/* Translation font */
.immersive-translate-target {
    font-family: "Microsoft YaHei", sans-serif;
    font-size: 14px;
    color: #333;
}

/* Translation background */
.immersive-translate-target-wrapper {
    background-color: #f5f5f5;
    padding: 5px;
    margin: 5px 0;
    border-radius: 3px;
}

​

특별 기능

​

PDF 번역

• PDF 형식 유지
• 이중 언어 읽기 지원
• 번역본 복사 가능

​

동영상 자막 번역

• YouTube
• Netflix
• Bilibili

1. “동영상 자막 번역”을 활성화합니다
2. 자막 표시 방식을 선택합니다
3. 자막 스타일을 조정합니다

​

전자책 번역

1. EPUB 파일을 업로드합니다
2. 번역 설정을 선택합니다
3. 이중 언어 버전을 다운로드합니다

​

입력창 번역

1. 입력창에 텍스트를 입력합니다
2. 단축키를 눌러 번역을 실행합니다
3. 번역 제안을 확인합니다

​

키보드 단축키

​

모델 선택 권장 사항

​

콘텐츠 유형별 선택

​

성능과 품질의 균형

// Smart model selection example
const selectModel = (textLength, contentType) => {
  if (textLength < 500) {
    return 'gpt-3.5-turbo'; // Use fast model for short text
  } else if (contentType === 'technical') {
    return 'gpt-4'; // Use accurate model for technical content
  } else if (contentType === 'creative') {
    return 'claude-3-sonnet'; // Use literary model for creative content
  } else {
    return 'gpt-3.5-turbo'; // Default to economical model
  }
};

​

성능 최적화

​

캐시 설정

• 번역 캐시를 활성화합니다
• 캐시 지속 시간 설정: 24시간
• 캐시를 정기적으로 정리합니다

​

일괄 번역

• 배치 크기 조정: 5~10개 문단
• 적절한 동시 실행 수 설정: 2~3
• 긴 텍스트 처리 최적화

​

트리거 조건

• 최소 번역 길이: 10자
• 특정 요소 무시: 탐색 메뉴, 광고
• 지연 번역: 200ms

​

일반적인 문제

​

번역 실패

• 잘못된 API key
• 네트워크 연결 문제
• 특수한 페이지 구조

1. API key를 확인합니다
2. 네트워크 연결을 확인합니다
3. 페이지를 새로고침해 봅니다
4. 브라우저 콘솔 오류를 확인합니다

​

번역 속도가 느림

1. 더 빠른 모델을 사용합니다
2. 번역당 텍스트 양을 줄입니다
3. 캐시 기능을 활성화합니다
4. 네트워크 지연 시간을 확인합니다

​

형식 혼동

1. 다른 번역 모드를 시도합니다
2. 번역 표시 설정을 조정합니다
3. 특정 웹사이트에 대한 규칙을 사용자 지정합니다
4. 개발자에게 문제를 보고합니다

​

모범 사례

​

1. 읽기 경험 최적화

• 적절한 글꼴과 크기를 선택합니다
• 번역 색상 대비를 조정합니다
• 편안한 줄 간격을 설정합니다
• 눈 보호 모드를 사용합니다

​

2. 학습 보조

• 이중 언어 읽기 모드를 활성화합니다
• 어휘 조회를 위해 단어 선택 번역을 사용합니다
• 검토를 위해 번역 내용을 내보냅니다
• 메모와 주석을 추가합니다

​

3. 업무 효율성

• 자주 방문하는 웹사이트에 대한 규칙을 설정합니다
• 도메인별 prompt를 사용자 지정합니다
• 바로가기를 사용해 속도를 높입니다
• 문서를 일괄 처리합니다

​

4. 비용 관리

• 번역 모델을 합리적으로 선택합니다
• 번역 길이 제한을 설정합니다
• 캐시를 사용해 반복 번역을 줄입니다
• API 사용량을 모니터링합니다

​

고급 팁

​

사용자 지정 번역 스크립트

// Auto-detect and translate specific content
if (document.querySelector('.article-content')) {
    window.immersiveTranslate.translate({
        selector: '.article-content',
        fromLang: 'auto',
        toLang: 'zh-CN'
    });
}

​

다른 도구와의 통합

• Readwise: 번역한 하이라이트를 저장합니다
• Notion: 번역 노트를 내보냅니다
• Anki: 어휘 플래시카드를 만듭니다

​

개발자 모드

1. 디버그 모드를 활성화합니다
2. 번역 피드백을 제공합니다
3. 번역 코퍼스에 기여합니다
4. 오픈 소스 개발에 참여합니다

​

문제 해결 가이드

​

확장 프로그램이 로드되지 않음

1. 브라우저 버전 호환성을 확인합니다
2. 충돌하는 확장 프로그램을 비활성화합니다
3. 브라우저 캐시를 지웁니다
4. 확장 프로그램을 다시 설치합니다

​

번역 결과가 표시되지 않음

1. 웹페이지가 번역을 지원하는지 확인합니다
2. 번역 서비스가 올바르게 구성되었는지 확인합니다
3. 광고 차단기에 의해 차단되었는지 확인합니다
4. 다른 번역 서비스를 사용해 봅니다

​

메모리 사용량이 높음

1. 번역 캐시를 정기적으로 정리합니다
2. 동시에 번역하는 페이지 수를 줄입니다
3. 일괄 번역 설정을 조정합니다
4. 불필요한 탭을 닫습니다