> 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/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="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-e9a35150d2021b1b599a48f431c12174bc65ce40%2Fcherry-selection-assistant.png?alt=media" alt=""><figcaption><p>劃詞助手設定面板</p></figcaption></figure>

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

   <figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-120588d64a41612ada1cfb9b45e378987047a64a%2Fcherry-selection-accessibility-dialog.png?alt=media" alt=""><figcaption><p>首次啟用時嘅輔助功能權限提示</p></figcaption></figure>

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

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-a4ed15b4c8a2cbacd6d05a6421a45b8b50b5dbc2%2Fcherry-selection-toolbar-settings.png?alt=media" alt=""><figcaption><p>啟用後嘅設定面板：取詞方式 / 緊湊模式 / 跟隨工具欄…</p></figcaption></figure>

### 內置操作

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

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

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-8a0b2431eca76cf6f2ea85ac40f55d21bbb8a6dc%2Fcherry-selection-actions-list.png?alt=media" 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/cherry-studio/preview/selection-assistant.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.
