# PDF 文件翻譯

## 功能說明

MaiAgent 提供 AI 驅動的 PDF 文件翻譯功能，可將知識庫中的 PDF 檔案翻譯為指定語言。翻譯完成後會產出兩種版本：

* **翻譯版**：僅包含目標語言的翻譯內容
* **雙語對照版**：原文與譯文並排顯示，方便對照閱讀

支援的語言包括：繁體中文、簡體中文、英文、日文、韓文、西班牙文、法文、德文、葡萄牙文、俄文、阿拉伯文、義大利文、荷蘭文、波蘭文、土耳其文。

{% hint style="info" %}
目前僅支援 PDF 格式的文件翻譯，且 PDF 必須包含可提取的文字內容（不支援純掃描/圖片型 PDF）。
{% endhint %}

***

## 如何翻譯 PDF 文件

### 1. 進入文件詳情頁

在知識庫的 <mark style="color:blue;">文件</mark> 頁籤中，點擊要翻譯的 PDF 檔案，進入文件詳情頁面。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c25ea420c6a3df82d97e6ee4ac83ee619bcf71aa%2Ftranslation-file-detail.png?alt=media" alt=""><figcaption><p>PDF 文件詳情頁，右上角可見「翻譯 PDF」按鈕</p></figcaption></figure>

### 2. 開啟翻譯設定

點擊右上角的 <mark style="color:blue;">翻譯 PDF</mark> 按鈕。若該檔案已有翻譯紀錄，會先顯示翻譯結果彈窗，可點擊 <mark style="color:blue;">再次翻譯</mark> 開啟設定；若為首次翻譯，則直接開啟翻譯設定彈窗。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-ca576108f13bea31d838d218ff27140a68be0249%2Ftranslation-settings.png?alt=media" alt=""><figcaption><p>翻譯設定彈窗</p></figcaption></figure>

### 3. 設定翻譯參數

| 欄位          | 說明                                         |
| ----------- | ------------------------------------------ |
| **來源語言**    | 原文的語言，預設為「自動偵測」，系統會自動判斷                    |
| **目標語言**    | 翻譯的目標語言（必填）                                |
| **大語言模型**   | 選擇用於翻譯的 LLM 模型                             |
| **自訂術語/提示** | （選填）引導翻譯風格或指定術語對照，例如：「請把 Hermione 翻譯成『妙麗』」 |

{% hint style="info" %}
自訂提示最多可輸入 5,000 字元，適合用於指定專有名詞、品牌名稱或特定翻譯風格。
{% endhint %}

### 4. 開始翻譯

點擊 <mark style="color:blue;">確認</mark> 後，系統會在背景執行翻譯任務。翻譯過程中狀態會即時更新，完成後會自動顯示結果。

***

## 查看翻譯結果

翻譯完成後，點擊 <mark style="color:blue;">翻譯 PDF</mark> 按鈕即可開啟翻譯結果彈窗，包含三個頁籤：

### 結果預覽

預覽雙語對照版的 PDF，原文與譯文並排顯示。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-f30168f3aac5876927fa5f63fe15c02f6b90031c%2Ftranslation-results-modal.png?alt=media" alt=""><figcaption><p>翻譯結果 — 雙語對照版 PDF 預覽</p></figcaption></figure>

### 下載檔案

提供三種檔案下載選項：

* **原始檔案**：下載未翻譯的原始 PDF
* **翻譯版**：僅包含目標語言的翻譯 PDF
* **雙語對照版**：原文與譯文並排的 PDF

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e7468c0ff54c46958a254298ce8a978da98fbec9%2Ftranslation-download.png?alt=media" alt=""><figcaption><p>下載檔案 — 支援三種格式</p></figcaption></figure>

### 處理詳情

顯示翻譯任務的完整統計資訊：

* **翻譯配置**：來源/目標語言、使用的 LLM 模型
* **處理統計**：Token 消耗量、LLM 呼叫次數、處理時間拆分
* **檔案資訊**：原始與翻譯後的檔案大小、字元數
* **時間戳記**：建立、開始、完成時間與最終狀態

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e071d5f2e6f041577af361763713afb8a88ee68b%2Ftranslation-details.png?alt=media" alt=""><figcaption><p>處理詳情 — Token 消耗與時間統計</p></figcaption></figure>

***

## 翻譯版本管理

同一份 PDF 檔案可執行多次翻譯（例如翻成不同語言或使用不同模型），每次翻譯都會保留為獨立版本。

在翻譯結果彈窗上方的 <mark style="color:blue;">選擇翻譯版本</mark> 下拉選單中，可切換不同版本查看結果。版本格式為：`日期 | 來源語言 → 目標語言 | 使用模型`。

如需再次翻譯，點擊 <mark style="color:blue;">再次翻譯</mark> 按鈕即可開啟新的翻譯設定。