> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Immersive Translate

> Руководство по интеграции расширения для двуязычного чтения в браузере

Immersive Translate — отличное расширение для перевода в браузере, которое поддерживает двуязычное чтение веб-страниц. Благодаря интеграции с APIYI вы можете использовать мощные AI-модели, чтобы получать более точные и естественные результаты перевода.

## Краткая установка

### Поддерживаемые браузеры

* Chrome / Edge / Brave
* Firefox
* Safari

### Шаги установки

1. Откройте магазин расширений вашего браузера
2. Найдите «Immersive Translate»
3. Нажмите кнопку установки и добавьте расширение в браузер

Или перейдите на [официальный сайт](https://immersive-translate.owenyoung.com/), чтобы получить ссылки для установки.

## Настройка APIYI

### 1. Откройте настройки

Нажмите значок расширения на панели инструментов браузера и выберите «Настройки».

### 2. Настройте службу перевода

1. Выберите «Службы перевода» в левом меню
2. Найдите службу «OpenAI»
3. Нажмите «Управление» или «Настройки»
4. Выберите «Пользовательский ключ API»

### 3. Заполните конфигурацию

* **APIKEY**: Введите ваш ключ APIYI
* **Пользовательский адрес интерфейса API**: `https://api.apiyi.com/v1/chat/completions`
* **Пользовательская модель**: `gpt-3.5-turbo` (необязательно)

## Основные функции

### Перевод веб-страниц

#### Автоматический перевод

1. Откройте веб-страницу на иностранном языке
2. Расширение автоматически определяет язык
3. Нажмите кнопку перевода, чтобы начать

#### Ручной перевод

1. Нажмите значок расширения на панели инструментов
2. Выберите «Перевести эту страницу»
3. Дождитесь завершения перевода

### Режимы перевода

#### Двуязычное чтение (рекомендуется)

* Сохраняет исходный формат
* Перевод отображается под оригиналом
* Удобно для сравнительного изучения

#### Только перевод

* Полностью заменяет исходный текст
* Подходит для быстрого чтения
* Можно в любой момент вернуть двуязычный режим

### Перевод выделенного слова

1. Выделите текст для перевода
2. Нажмите появившуюся кнопку перевода
3. Просмотрите перевод во всплывающем окне

## Дополнительные настройки

### Пользовательские подсказки

Подсказки для разных типов контента:

#### Техническая документация

```text theme={null}
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
```

#### Академические статьи

```text theme={null}
As an academic translation expert, please:
1. Use academically standard expressions
2. Preserve citation formats
3. Accurately translate professional terminology
```

#### Литературные произведения

```text theme={null}
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. Выберите поведение:
   * Всегда переводить
   * Никогда не переводить
   * Умное определение

### Настройка стиля

Настройте стиль отображения перевода:

```css theme={null}
/* 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-документов:

* Сохраняет формат PDF
* Поддерживает двуязычное чтение
* Можно копировать перевод

### Перевод субтитров видео

Поддерживает основные видеосайты:

* YouTube
* Netflix
* Bilibili

Способ настройки:

1. Включите «Перевод субтитров видео»
2. Выберите способ отображения субтитров
3. Настройте стиль субтитров

### Перевод электронных книг

Поддерживает EPUB-электронные книги:

1. Загрузите файл EPUB
2. Выберите настройки перевода
3. Скачайте двуязычную версию

### Перевод в поле ввода

Перевод в реальном времени в веб-полях ввода:

1. Введите текст в поле ввода
2. Нажмите сочетание клавиш, чтобы запустить перевод
3. Просмотрите варианты перевода

## Сочетания клавиш

Часто используемые сочетания (настраиваемые):

| Функция                     | Сочетание по умолчанию |
| --------------------------- | ---------------------- |
| Перевести/Показать оригинал | `Alt + T`              |
| Переключить режим перевода  | `Alt + M`              |
| Перевести выделенный текст  | `Alt + S`              |
| Открыть настройки           | `Alt + O`              |

## Рекомендации по выбору модели

### Выбор по типу контента

| Тип контента              | Рекомендуемая модель | Причина                             |
| ------------------------- | -------------------- | ----------------------------------- |
| Новостные статьи          | gpt-3.5-turbo        | Быстро, точно                       |
| Техническая документация  | gpt-4                | Точная терминология                 |
| Научные статьи            | claude-3-opus        | Хорошее понимание                   |
| Литературные произведения | claude-3-sonnet      | Хороший литературный стиль          |
| Ежедневные веб-страницы   | gpt-3.5-turbo        | Высокое соотношение цены и качества |

### Баланс производительности и качества

```javascript theme={null}
// 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
* Проблемы с сетевым подключением
* Особая структура страницы

**Решения:**

1. Проверьте ключ API
2. Проверьте сетевое подключение
3. Попробуйте обновить страницу
4. Проверьте ошибки в консоли браузера

### Низкая скорость перевода

**Методы оптимизации:**

1. Используйте более быстрые модели
2. Уменьшите объем текста за один перевод
3. Включите функцию кэша
4. Проверьте задержку сети

### Путаница в формате

**Способы обработки:**

1. Попробуйте другие режимы перевода
2. Настройте параметры отображения перевода
3. Настройте правила для конкретных сайтов
4. Сообщите о проблеме разработчикам

## Лучшие практики

### 1. Оптимизация восприятия при чтении

* Выбирайте подходящий шрифт и размер
* Настраивайте контраст цветов перевода
* Устанавливайте комфортный межстрочный интервал
* Используйте режим защиты зрения

### 2. Помощь в обучении

* Включите двуязычный режим чтения
* Используйте перевод по выделению слов для поиска значений слов
* Экспортируйте содержимое перевода для проверки
* Добавляйте заметки и аннотации

### 3. Повышение эффективности работы

* Настраивайте правила для часто посещаемых веб-сайтов
* Настраивайте prompts для конкретных доменов
* Используйте сочетания клавиш для повышения скорости
* Обрабатывайте документы пакетно

### 4. Контроль затрат

* Разумно выбирайте модели перевода
* Устанавливайте ограничения на длину перевода
* Используйте кэш для сокращения повторных переводов
* Отслеживайте использование API

## Продвинутые советы

### Пользовательский скрипт перевода

Используйте JavaScript для расширения функциональности:

```javascript theme={null}
// 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. Закройте ненужные вкладки

Нужна дополнительная помощь? Пожалуйста, ознакомьтесь с [Подробной документацией по интеграции](/ru/scenarios/translation/immersive).