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

# 沉浸式翻譯

> 沉浸式翻譯瀏覽器擴展集成指南

## 一、簡介

沉浸式翻譯是一款優秀的瀏覽器翻譯擴展，支援網頁雙語對照閱讀。通過集成 MixRoute，可調用強大的 AI 模型，獲得更準確、自然的翻譯效果。

## 二、快速安裝

### 支援的瀏覽器

* Chrome / Edge / Brave
* Firefox
* Safari

### 安裝步驟

1. 訪問對應瀏覽器的擴展商店
2. 搜索「沉浸式翻譯」或「Immersive Translate」
3. 點擊「安裝」並添加到瀏覽器工具欄
4. 或訪問 [沉浸式翻譯官網](https://immersivetranslate.com/)

## 三、配置 MixRoute

<Steps>
  <Step title="打開設定">
    點擊瀏覽器工具欄的擴展圖標，選擇「設定」
  </Step>

  <Step title="選擇翻譯服務">
    在左側選單點擊「翻譯服務」，找到「OpenAI」
  </Step>

  <Step title="填寫配置">
    * **APIKEY**：您的 MixRoute API 密鑰
    * **自訂 API 接口地址**：`https://api.mixroute.ai/v1/chat/completions`
    * **自訂模型**：可選填（如 `gpt-5.4-mini`）
  </Step>
</Steps>

## 四、核心功能

### 1. 網頁翻譯

**自動翻譯**

* 訪問外文網頁時自動檢測語言
* 點擊工具欄「翻譯」按鈕完成整頁翻譯

**手動翻譯**

* 點擊擴展圖標，選擇「翻譯本頁」

### 2. 翻譯模式

<CardGroup cols={2}>
  <Card title="雙語對照（推薦）" icon="columns">
    保留原文格式，譯文顯示在原文下方，適合對照學習、核對專業術語
  </Card>

  <Card title="僅譯文" icon="file-lines">
    完全替換原文，適合快速閱讀
  </Card>
</CardGroup>

### 3. 劃詞翻譯

* 選中文本，點擊彈出的「翻譯」按鈕
* 支援複製、發音等功能

## 五、進階設定

### 1. 自訂提示詞

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

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

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

### 2. 翻譯規則

為特定網站設定自動翻譯：

1. 進入「翻譯規則」設定
2. 添加網站域名（如 `en.wikipedia.org`）
3. 選擇行為：總是翻譯 / 從不翻譯 / 智能判斷

### 3. 樣式定製

```css theme={null}
.immersive-translate-target {
    font-family: "Microsoft JhengHei", sans-serif;
    font-size: 14px;
    color: #333;
}

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

## 六、特色功能

### 1. PDF 翻譯

* 支援線上 PDF 文檔翻譯
* 保持原格式，雙語對照顯示

### 2. 影片字幕翻譯

支援 YouTube、Netflix、Bilibili 等：

1. 開啟「影片字幕翻譯」功能
2. 選擇字幕顯示方式
3. 調整字幕樣式

### 3. 電子書翻譯

* 上傳 EPUB 格式電子書
* 選擇翻譯語言和模式
* 下載雙語版本

### 4. 輸入框翻譯

* 在輸入框輸入文本
* 按 `Alt + S` 觸發翻譯
* 一鍵替換為譯文

## 七、快捷鍵

| 功能      | 預設快捷鍵     |
| ------- | --------- |
| 翻譯/顯示原文 | `Alt + T` |
| 切換翻譯模式  | `Alt + M` |
| 翻譯選中文本  | `Alt + S` |
| 打開設定    | `Alt + O` |

## 八、性能優化

### 1. 快取設定

* 開啟「翻譯快取」功能
* 設定快取時長（建議 24 小時）

### 2. 批量翻譯

* 調整批量大小（5-10 段落/批）
* 設定合理並發數（2-3 個）

### 3. 觸發條件

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

## 九、常見問題

<AccordionGroup>
  <Accordion title="翻譯失敗">
    * 驗證 API 密鑰是否正確
    * 檢查網路連接
    * 刷新頁面或切換翻譯模式
    * 打開控制台（F12）查看錯誤日誌
  </Accordion>

  <Accordion title="翻譯速度慢">
    * 切換更快模型（如 `gpt-5.4-mini`）
    * 減少單次翻譯文本量
    * 開啟快取功能
    * 檢查網路延遲
  </Accordion>

  <Accordion title="格式錯亂">
    * 切換「雙語對照」與「僅譯文」模式
    * 調整譯文布局樣式
    * 為網站添加自訂翻譯規則
  </Accordion>
</AccordionGroup>

## 十、最佳實踐

### 閱讀體驗優化

* 選擇清晰字體（微軟正黑體、思源黑體）
* 提高譯文與原文顏色對比度
* 設定行間距 1.5 倍

### 學習輔助

* 使用「雙語對照」模式對照學習
* 用劃詞翻譯查詢專業術語
* 導出翻譯內容用於複習

### 成本控制

* 日常瀏覽用 `gpt-5.4-mini`
* 重要文檔用 `gpt-5.5` 或 Claude
* 利用快取減少重複翻譯