> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/cherry-studio/preview/translation.md).

# 翻譯

Cherry Studio 嘅翻譯功能為你提供快速、準確嘅文本翻譯服務，支援多種語言之間互譯。

### 介面概覽

<figure><img src="/files/5ee417a0087fe3271e7b99230fb5bf7931c81d36" alt=""><figcaption><p>翻譯頁面：左輸入、右輸出，頂部切換語言同模型</p></figcaption></figure>

頂部操作欄分左右兩組。

**左側（語言同翻譯）：**

1. **來源語言下拉**：預設 `自動偵測`，自動偵測命中後會喺選項入面顯示具體語種
2. **方向切換**（⇆）：互換來源／目標語言（來源語言為【自動偵測】時不可用）
3. **目標語言下拉**
4. **翻譯按鈕**：輸入框為空或未揀模型時會變灰，唔可以撳

**右側（模型同工具）：**

5. **模型選擇**（模型頭像）：切換用嚟翻譯嘅模型
6. **翻譯歷史**（時鐘圖標）：打開歷史面板，可搜尋、按收藏篩選，撳任何記錄一鍵回填到輸入／輸出框
7. **設定**（滑塊圖標）：打開翻譯設定面板

輸入框（左）支援貼文字，亦支援 **拖入或者撳上傳** 檔案——文字檔（`.txt` / `.md`）直接讀入，圖片走 **OCR** 識別，文件（PDF / Word / PPT / Excel 等）直接抽取正文；結果框（右）滑鼠移上去會出現複製按鈕。

{% hint style="info" %}
拖入圖片會先做 OCR 識別文字再翻譯；拖入 PDF / Word 等文件會直接抽取正文。圖片同文字檔上限 5 MB，文件上限 20 MB。
{% endhint %}

### 使用步驟

1. **揀目標語言**
2. **輸入或者貼文字** 到左側框——拖入圖片可直接 OCR 識別後翻譯
3. 撳 **翻譯** 按鈕
4. 複製或者繼續編輯右側結果

### 翻譯設定

撳右上角 **滑塊圖標** 打開翻譯設定面板：

<figure><img src="/files/5d1835e7e087e4e7ca0da216bc099b7bbe958380" alt=""><figcaption><p>翻譯設定面板</p></figcaption></figure>

* **Markdown 預覽**：開啟後翻譯結果會按 Markdown 渲染
* **翻譯完成後自動複製**：結果一生成就複製到剪貼簿
* **滾動同步設定**：左右兩欄滾動聯動
* **自動偵測方法**：自動／算法（franc 本地）／LLM——LLM 偵測更準但會消耗少量 token
* **雙向翻譯設定**：開啟後只喺指定嘅兩種語種之間互譯，頂部語言欄會合併做一個「源 ⇆ 目標」語言對；下方可揀語種對
* **翻譯提示詞**：自訂翻譯用嘅系統提示詞，改動後可以一鍵恢復預設
* **自訂語言**：喺內置語言之外新增、編輯或刪除語言（填寫語言名同語言代碼，如 `zh-cn`）

### 常見問題解答 (FAQ)

* **Q: 翻譯唔準確點算？**
  * A: AI 翻譯雖然強大，但並非完美。對於專業領域或者複雜語境嘅文本，建議做人手校對。你亦可以試吓切換唔同嘅模型。
* **Q: 支援邊啲語言？**
  * A: Cherry Studio 翻譯功能支援多種主流語言，具體支援嘅語言列表請參考 Cherry Studio 嘅官方網站或者應用內說明。
* **Q: 可以翻譯成個檔案／圖片嗎？**
  * A: 可以。輸入框支援直接 **拖入或者撳上傳** 圖片同文件：圖片會經 OCR 識別後再翻譯，PDF / Word / PPT / Excel 等文件會抽取正文後翻譯。若文件特別長，都可以入到對話頁面，將文件做附件發畀翻譯助手處理。
* **Q: 翻譯速度慢點算？**
  * A: 翻譯速度可能受網絡連線、文本長度、伺服器負載等因素影響。請確保你嘅網絡連線穩定，並耐心等待。

***

### 攞幫助同提交意見

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改善建議，請參考 [反饋與建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/cherry-studio/preview/translation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.