> ## 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.

# 沉浸式翻譯

> 瀏覽器雙語對照閱讀擴充套件整合指南

# 沉浸式翻譯

沉浸式翻譯是一款優秀的瀏覽器翻譯擴充套件，支援網頁雙語對照閱讀。通過整合 API易，您可以使用強大的 AI 模型獲得更準確、更自然的翻譯效果。

## 快速安裝

### 支援的瀏覽器

* Chrome / Edge / Brave
* Firefox
* Safari

### 安裝步驟

1. 訪問對應瀏覽器的擴充套件商店
2. 搜尋"沉浸式翻譯"或"Immersive Translate"
3. 點選安裝並新增到瀏覽器

或訪問 [官網](https://immersive-translate.owenyoung.com/) 獲取安裝連結。

## 配置 API易

### 1. 開啟設定

點選瀏覽器工具欄的擴充套件圖示，選擇"設定"。

### 2. 配置翻譯服務

1. 在左側選單選擇"翻譯服務"
2. 找到"OpenAI"服務
3. 點選"管理"或"設定"
4. 選擇"自定義 API Key"

### 3. 填寫配置

* **APIKEY**：輸入您的 API易 金鑰
* **自定義 API 介面地址**：`https://api.apiyi.com/v1/chat/completions`
* **自定義模型**：`gpt-3.5-turbo`（可選）

## 核心功能

### 網頁翻譯

#### 自動翻譯

1. 訪問外文網頁
2. 擴充套件自動檢測語言
3. 點選翻譯按鈕開始

#### 手動翻譯

1. 點選工具欄擴充套件圖示
2. 選擇"翻譯本頁"
3. 等待翻譯完成

### 翻譯模式

#### 雙語對照（推薦）

* 保留原文格式
* 譯文顯示在原文下方
* 便於對照學習

#### 僅譯文

* 完全替換原文
* 適合快速閱讀
* 可隨時切換回雙語

### 劃詞翻譯

1. 選中需要翻譯的文本
2. 點擊出現的翻譯按鈕
3. 在彈窗中檢視翻譯結果

## 進階設定

### 自定義提示詞

針對不同內容型別的提示詞：

#### 技術文件

```text theme={null}
作為技術文件翻譯專家，請：
1. 保留所有技術術語的原文
2. 在括號中提供中文解釋  
3. 保持程式碼和命令的原始格式
```

#### 學術論文

```text theme={null}
作為學術翻譯專家，請：
1. 使用學術規範的表達方式
2. 保留引用格式
3. 準確翻譯專業術語
```

#### 文學作品

```text theme={null}
作為文學翻譯專家，請：
1. 保持原文的文學美感
2. 注意文化背景的轉換
3. 保留修辭手法的效果
```

### 翻譯規則

設定特定網站的翻譯行為：

1. 進入"翻譯規則"設定
2. 新增網站域名
3. 選擇行為：
   * 總是翻譯
   * 從不翻譯
   * 智慧判斷

### 樣式定製

自定義譯文顯示樣式：

```css theme={null}
/* 譯文字型 */
.immersive-translate-target {
    font-family: "Microsoft YaHei", sans-serif;
    font-size: 14px;
    color: #333;
}

/* 譯文背景 */
.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` |

## 模型選擇建議

### 按內容型別選擇

<Card title="檢視翻譯場景模型推薦" icon="star" href="/zh-Hant/api-capabilities/model-info">
  檢視最新的模型推薦，瞭解適合不同翻譯場景和內容型別的最佳模型選擇，包括技術文件、學術論文、文學作品等。
</Card>

<Info>
  **為什麼不在此列出具體模型？**

  AI 模型更新迭代速度非常快，為了確保您獲取最準確的模型推薦資訊，我們統一在 [模型推薦頁面](/zh-Hant/api-capabilities/model-info) 維護最新的模型列表、效能資料和使用建議。
</Info>

### 效能與品質平衡

根據文本長度和內容型別，可以在沉浸式翻譯的設定中靈活選擇合適的模型，以達到翻譯品質和成本的最佳平衡。

## 效能最佳化

### 快取設定

* 開啟翻譯快取
* 設定快取時長：24小時
* 定期清理快取

### 批次翻譯

* 調整批次大小：5-10 段落
* 設定合理併發數：2-3
* 最佳化長文本處理

### 觸發條件

* 最小翻譯長度：10 個字元
* 忽略特定元素：導航選單、廣告
* 延遲翻譯：200ms

## 常見問題

### 翻譯失敗

**可能原因：**

* API 金鑰無效
* 網路連線問題
* 頁面結構特殊

**解決方案：**

1. 驗證 API 金鑰
2. 檢查網路連線
3. 嘗試重新整理頁面
4. 檢視瀏覽器控制台錯誤

### 翻譯速度慢

**最佳化方法：**

1. 使用更快的模型
2. 減少單次翻譯文本量
3. 開啟快取功能
4. 檢查網路延遲

### 格式錯亂

**處理方式：**

1. 嘗試不同翻譯模式
2. 調整譯文顯示設定
3. 針對特定網站自定義規則
4. 反饋問題給開發者

## 最佳實踐

### 1. 閱讀體驗最佳化

* 選擇合適的字型和大小
* 調整譯文顏色對比度
* 設定舒適的行間距
* 使用護眼模式

### 2. 學習輔助

* 開啟雙語對照模式
* 使用劃詞翻譯查詢生詞
* 匯出翻譯內容複習
* 新增筆記和標註

### 3. 工作效率

* 設定常訪問網站規則
* 自定義專業領域提示詞
* 使用快捷鍵提高速度
* 批次處理文件

### 4. 成本控制

* 合理選擇翻譯模型
* 設定翻譯長度限制
* 利用快取減少重複翻譯
* 監控 API 使用量

## 高階技巧

### 自定義翻譯指令碼

使用 JavaScript 增強功能：

```javascript theme={null}
// 自動檢測並翻譯特定內容
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. 關閉不必要的標籤頁

需要更多幫助？請檢視 [詳細整合文件](/zh-Hant/scenarios/translation/immersive)。