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

# 劃詞助手

劃詞助手（Selection Assistant）可以令你喺**任何應用入面揀中文字**之後，透過浮動工具欄叫 AI 做翻譯、解釋、優化、總結等操作，唔使將內容貼返去 Cherry Studio。

{% hint style="info" %}
**同** [**快捷助手**](/docs/zhong-wen-fan-ti/cherry-studio/preview/quick-assistant.md) **嘅分別**：

* **快捷助手**：用全局快捷鍵喚起一個**主動輸入**視窗，你打字提問
* **劃詞助手**：揀中文字之後**針對所選內容**彈出工具欄，一鍵執行預設操作
  {% endhint %}

### 平台支援

* ✅ **macOS**：完全支援，但首次啟用需要授予 **輔助功能（Accessibility）權限**
* ✅ **Windows**：完全支援，唔使特殊權限
* ⚠️ **Linux**：只喺 **X11** 模式下完全支援；Wayland 模式下工具欄可能未必跟到所選文字定位。同時需要將當前用戶加入 `input` 組（`sudo usermod -aG input $USER`）以取得按鍵監聽權限

### 啟用劃詞助手

打開 `設定 → 劃詞助手`：

<figure><img src="/files/f900ee0e96e6e1d05139c0db61767a34d421ab70" alt=""><figcaption><p>劃詞助手設定面板</p></figcaption></figure>

1. 打開 **啟用** 開關
2. **macOS** 用戶首次啟用會彈窗請求 **輔助功能權限**：

   <figure><img src="/files/dac9a7223c6770e2821c4e1b86d2728628f6b1f6" alt=""><figcaption><p>首次啟用時嘅輔助功能權限提示</p></figcaption></figure>

   撳 **去設定** → 喺彈出嘅系統設定「私隱與安全性 → 輔助功能」入面搵到 Cherry Studio 並打開開關 → 返回 Cherry Studio 再次啟用。
3. （可選）喺 **工具欄 → 取詞方式** 選擇觸發方式（唔同平台可選項唔同）：
   * **劃詞**：揀中文字後即刻彈出工具欄（預設）
   * **Ctrl 鍵**（只限 Windows）：揀中文字後**再長按 Ctrl 鍵**先彈（避免誤觸）
   * **快捷鍵**：揀中文字後撳快捷鍵再彈，快捷鍵喺 `設定 → 快捷鍵` 入面改

<figure><img src="/files/fe5c7665e1de8bebbac5bc622d845a35e4ec0a8e" alt=""><figcaption><p>啟用後嘅設定面板：取詞方式 / 緊湊模式 / 跟隨工具欄…</p></figcaption></figure>

### 內置操作

劃詞助手提供 7 個內置操作，**預設啟用 5 個**：翻譯 / 解釋 / 總結 / 搜尋 / 複製。工具欄左側嘅 **Cherry 圖示唔係操作按鈕**——佢只係工具欄嘅拖拽手柄，撳住可以移動成條工具欄。

| 操作     | 預設啟用 | 用途                                  |
| ------ | ---- | ----------------------------------- |
| **翻譯** | ✅    | 智能翻譯：優先翻譯做目標語言；如果已經係目標語言，咁就翻譯做備選語言  |
| **解釋** | ✅    | 畀 AI 解釋呢段內容                         |
| **總結** | ✅    | 畀 AI 用一段話總結所選內容                     |
| **搜尋** | ✅    | 用所選文字調用搜尋引擎查詢（預設 Google，可喺每項右側 ⋯ 改） |
| **複製** | ✅    | 複製所選中文字                             |
| **優化** | 待啟用  | 畀 AI 改寫得更順暢 / 更專業，需要喺設定入面拖入啟用區      |
| **引用** | 待啟用  | 將所選中文字以引用形式發送到當前對話，需要喺設定入面拖入啟用區     |

<figure><img src="/files/f9514c4fcbdcb6f528249267501dce0138f0d90b" alt=""><figcaption><p>設定面板嘅「功能」區：上方係已啟用，下方暫存區拖到上方就會啟用</p></figcaption></figure>

### 自訂操作

喺 `設定 → 劃詞助手 → 功能` 入面可以：

* **編輯**內置操作嘅提示詞
* **新增**自訂操作（命名 + 提示詞 + 預設模型）
* **拖拽**調整工具欄入面操作嘅順序
* 將唔常用嘅操作拖到下方暫存區就可以「停用」

### 工具欄 / 結果視窗外觀

工具欄：

* **緊湊模式**：只顯示圖示，唔顯示文字，慳返屏幕空間

結果視窗（`功能視窗` 節）：

* **跟隨工具欄**：視窗貼住工具欄彈出（預設開啟），關閉就會一直居中
* **記住大小**：今次手動調過嘅視窗尺寸，下次保留
* **自動關閉**：撳視窗外面就會關
* **自動置頂**：一直浮喺其他應用之上
* **透明度**：20%–100% 可調

### 搜尋引擎

劃詞助手內置嘅「搜尋」操作可揀預設引擎（Google、Bing、DuckDuckGo 等）。配置入口喺 `設定 → 劃詞助手 → 功能`：搵到 **搜尋** 呢條，撳行尾右側嘅齒輪圖示彈出「搜尋引擎」對話框，可以喺預設入面揀或者加自訂引擎，URL 入面用 `{{queryString}}` 表示搜尋詞位置。

### 應用程式篩選（高級）

可以喺 `設定 → 劃詞助手 → 高級 → 應用程式篩選` 入面設定 **黑名單 / 白名單**，令劃詞助手只會喺指定應用入面生效（白名單），或者唔喺指定應用入面彈出（黑名單）。

* **macOS**：填入應用嘅 Bundle ID（例如 `com.google.Chrome`、`com.apple.mail`）
* **Windows**：填入應用嘅可執行檔案名（例如 `chrome.exe`、`Cherry Studio.exe`）

### 使用嘅模型

劃詞助手預設使用 [全局預設對話模型](/docs/zhong-wen-fan-ti/pre-basic/settings/default-models.md)，亦可以針對每個操作獨立指定模型。

### 提示同技巧

* macOS 上如果工具欄唔出現，檢查 `系統設定 → 私隱與安全性 → 輔助功能` 入面 Cherry Studio 有冇打勾
* 成日因為誤觸揀中文字而彈出工具欄？切去 **Ctrl 鍵** 觸發模式
* 工具欄圖示太多擠屏？開啟 **緊湊模式**
* 想做「翻譯完直接朗讀」呢類串連操作？將「翻譯」結果複製後調用 [快捷助手](/docs/zhong-wen-fan-ti/cherry-studio/preview/quick-assistant.md) 繼續處理

***

### 💡 獲取幫助與提交反饋

如果您喺配置或者使用過程中遇到任何疑問、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:

```
GET https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/cherry-studio/preview/selection-assistant.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.