> 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/chat.md).

# 對話-助手

對話介面係 Cherry Studio 最常用嘅頁面，但佢嘅結構包含 **兩個層次**：助手 → 對話。理解呢個結構有助於更高效咁使用各類對話功能。

{% hint style="info" %}
如果仲分唔清助手、智能體、技能等概念，可以先睇下方嘅 [助手庫](#助手库) 小節同 [智能體](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md) 頁面。
{% endhint %}

## 助手同對話嘅關係

簡單類比：

* **助手 = 一個角色**（例如「產品文檔助理」、「代碼 reviewer」）
* **對話 = 同呢個角色嘅一段交流**（例如禮拜一討論「重構方案」、禮拜二討論「bug 報告」）

即係話：**一個助手底下可以建立多個對話**，所有對話共用呢個助手嘅人設同參數（提示詞、模型、temperature 等），唔使每次重新設定 AI 嘅角色同風格。

### 助手

助手為 AI 設定固定角色 —— 由系統提示詞 + 模型參數預設組成。

* **系統預設助手**：通用助手，未設特別提示詞，可直接使用
* **更專門嘅助手**：喺下方 [助手庫](#助手库) 瀏覽現成預設，或者自己建立

### 對話

每個助手底下可建立多個對話（即多段獨立聊天）。各對話之間互相獨立，但共享所屬助手嘅設定。

適用場景示例：

* 同一個「代碼助手」底下分別開「項目 A 重構」、「項目 B bug」兩個對話，獨立管理
* 同一個「翻譯助手」底下開多個對話，分別處理唔同文章

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-c0347e9ea478e7cfcc09a52a4e811114d470158b%2Fimage%20(5)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>每個助手底下可展開多個對話（圖中「市場營銷」助手底下展開咗兩個對話）</p></figcaption></figure>

## 助手庫

助手列表入面嘅助手從邊度嚟？除咗系統預設助手，你可以從 **助手庫** 添加，或者自己建立。助手庫係一個 **助手預設市場**，提供大量「角色 + 提示詞 + 參數」模板，添加之後就會出現喺對話頁嘅助手列表入面。

{% hint style="warning" %}
**唔好同智能體撈亂**：助手庫產出嘅係上面講嘅 [對話助手](#助手)（一個角色預設）；[智能體](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md)（入口【啟動台】→【工作】）就係另一套可以自主調用工具、讀寫文件、跨步驟完成任務嘅系統。兩者係唔同嘅嘢，配置入口亦都唔同：助手喺對話頁管理，智能體喺【工作】入面。
{% endhint %}

### 進入助手庫

1. 喺對話頁左側助手列表頂部，撳 **展示方式** 圖標（漏斗形），喺彈出選單中揀【管理助手】。
2. 喺打開嘅「管理助手」頁面右上角，撳【助手庫】按鈕，即可進入助手預設市場。

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-2f8ed53507a33b3fc50fc99c9c2a4e61d6bd8c3e%2Fcherry-agents-store-writing.png?alt=media" alt=""><figcaption><p>助手庫 —— 按用途分類（帶數量徽標）瀏覽助手卡片，頂部提供搜尋框</p></figcaption></figure>

### 喺助手庫中搵助手

* **分類篩選**：按 `全部` / `精選` 同多個用途分類（職業、商業、工具、語言、辦公、通用、寫作、編程、情感、教育、創意、學術、設計、藝術、娛樂、生活 等）篩選，分類名旁邊嘅數字係該類助手數量
* **搜尋**：頂部搜尋框可喺所有分類入面按關鍵字搵
* **預覽**：撳助手卡片可睇到該助手嘅系統提示詞、推薦模型、參數預設

### 加入到我嘅助手

* 撳助手卡片上嘅 **添加** 按鈕，即可將呢個預設加入你嘅助手列表
* 之後喺對話頁助手列表入面就可以睇到呢個助手

### 創建自己嘅助手

喺「管理助手」頁面右上角撳【新建助手】，會打開同 [編輯助手](#bian-ji-zhu-shou) 相同嘅對話框，可分標籤頁填寫：

* **基礎**：頭像、名稱、描述、該助手嘅預設模型、分組
* **模型**：溫度、Top-P、最大 Token 數等模型參數（詳見下方 [助手設定](#zhu-shou-she-zhi)）
* **提示詞**：決定該助手嘅角色同行為；輸入框右上角嘅閃電按鈕即【AI 優化提示詞】，可用 [全局預設助手模型](/docs/zhong-wen-fan-ti/pre-basic/settings/default-models.md) 將當前內容改寫得更有結構
* **知識庫**：關聯已建好嘅 [知識庫](/docs/zhong-wen-fan-ti/knowledge-base/knowledge-base.md)
* **MCP**：為該助手啟用 MCP 工具

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-4f6c5730cb72b5f171e1a0b57874b4570364063f%2Fcherry-agents-create-form.png?alt=media" alt=""><figcaption><p>新建 / 編輯助手對話框，左側為 基礎 / 模型 / 提示詞 / 知識庫 / MCP 五個標籤頁</p></figcaption></figure>

{% hint style="info" %}
**模型選擇**：既可以喺 **基礎** 標籤頁為助手指定一個預設模型，亦可以隨時喺對話頁面頂部嘅模型下拉選單中臨時切換。未指定助手預設模型時，將使用 [全局預設對話模型](/docs/zhong-wen-fan-ti/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing)。
{% endhint %}

### 導入與管理

「管理助手」頁面右上角提供三個動作按鈕：

* **新建助手**：打開 [編輯助手對話框](#bian-ji-zhu-shou) 由零開始建立一個助手
* **助手庫**：進入上面介紹嘅助手預設市場
* **導入助手**：打開「從外部導入」對話框，導入人哋分享嘅助手

「管理助手」頁面本身用嚟集中管理已添加嘅助手，支援批量刪除、批量匯出。

【從外部導入】對話框提供三種一次性導入方式，導入完成後助手即出現喺你嘅助手列表入面：

* **文件上傳**：拖入或者選擇一個 JSON 文件
* **剪貼板**：直接貼上助手嘅 JSON 文本
* **URL 導入**：填入 JSON 鏈接（出於安全考慮，現時只支援 GitHub Gist、raw\.githubusercontent.com 等來源）

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-97516d3645f4666c0e7a17e5b57cbca587d40a22%2Fcherry-agents-import-dialog.png?alt=media" alt=""><figcaption><p>從外部導入對話框 —— 文件上傳 / 剪貼板 / URL 導入</p></figcaption></figure>

### 幾時用助手庫，幾時用智能體？

| 場景                       | 推薦                                                                                                                                                                         |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 個人化「角色」快速對話（寫作、翻譯、技術問答等） | **助手庫**                                                                                                                                                                    |
| 畀 AI 自主調用工具、讀寫文件、跨步驟完成任務 | [**智能體**](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md)                                                                                                           |
| 定時執行、跨平台消息推送             | **智能體 +** [**定時任務**](/docs/zhong-wen-fan-ti/advanced-basic/automation/scheduled-heartbeat.md) **+** [**頻道**](/docs/zhong-wen-fan-ti/advanced-basic/automation/channels.md) |

## 對話框內按鈕

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-a3dc0076fd301932a3c134f8277941f09c837946%2Fchat-input-toolbar.png?alt=media" alt=""><figcaption><p>輸入框工具列預設只放 4 個常用工具，其餘功能都喺【+】輸入快捷面板入面</p></figcaption></figure>

輸入框下方嘅工具列 **預設只顯示 4 個常用工具**，其餘功能收喺尾端嘅 **【+】輸入快捷面板** 入面。想改預設顯示邊啲工具，撳【+】→【自定義工具列】。

### 預設工具列

| 名稱            | 作用                                                                           |
| ------------- | ---------------------------------------------------------------------------- |
| **新對話**       | 喺當前助手內建立一個新對話                                                                |
| **網絡搜尋**      | 將網頁搜尋結果作為上下文返回畀模型，需先喺 聯網模式 中配置；部分模型亦可改用「模型內置」搜尋                              |
| **知識庫**       | 將一個已建好嘅 [知識庫](/docs/zhong-wen-fan-ti/knowledge-base/knowledge-base.md) 作為上下文 |
| **+（輸入快捷面板）** | 打開下面呢組更多工具同操作                                                                |

### 輸入快捷面板（+）

撳 **+**，或者直接喺輸入框入面輸入 `/`，都會打開呢個面板。面板支援 <kbd>↑↓</kbd> 選擇、<kbd>Tab</kbd> / <kbd>回車</kbd> 確認、<kbd>ESC</kbd> 關閉。

| 名稱        | 作用                                                                                                      |
| --------- | ------------------------------------------------------------------------------------------------------- |
| **上傳附件**  | 上傳圖片或文檔；圖片需要模型支援視覺能力，文檔會被解析為上下文                                                                         |
| **生成圖片**  | 畀當前對話模型生成圖片；需先喺【設定】→【預設模型】中配置畫圖模型。專門嘅生圖請去 [繪畫](/docs/zhong-wen-fan-ti/cherry-studio/preview/drawing.md) |
| **提示詞管理** | 插入同管理預設提示詞，詳見 [輸入工具欄與效率工具](/docs/zhong-wen-fan-ti/advanced-basic/workbench/composer-efficiency.md)      |
| **MCP**   | 睇下並啟用當前對話可用嘅 MCP 伺服器                                                                                    |
| **引用筆記**  | 從 [筆記](/docs/zhong-wen-fan-ti/cherry-studio/preview/notes.md) 中揀一篇作為附件引用                                |
| **清除上下文** | **保留消息**，但畀模型「忘記」之前嘅對話（截斷上下文）                                                                           |
| **自訂工具欄** | 選擇預設工具列上顯示邊啲工具                                                                                          |

已添加到輸入框嘅圖片會顯示為附件標記。滑鼠移過去可快速預覽；撳附件，或者用鍵盤聚焦後按 <kbd>Enter</kbd> / <kbd>Space</kbd>，可打開完整圖片預覽。

{% hint style="info" %}
**「清除上下文」唔會刪消息**：消息仍然留喺對話入面，只係畀模型由而家開始重新認識你，唔再記得之前嘅內容。
{% endhint %}

### 輸入框右側

* **展開 / 收起**（輸入框右上角）：放大輸入框，方便輸入長文
* **思考**（右下角下拉，顯示為「預設」）：調整模型嘅推理強度，只喺所選模型支援推理時可調；唔支援嘅模型會提示「當前模型唔支援調整推理強度」
* **發送**：發送消息（預設 <kbd>Enter</kbd>，可喺 [快捷鍵](/docs/zhong-wen-fan-ti/pre-basic/settings/key-shortcut.md) 中改）

### 通過鍵盤觸發

輸入框嘅提示入面已經寫明咗兩個快捷輸入：

* **`/`**：打開輸入快捷面板，揀工具或者操作（同撳 **+** 等價）
* **`@`**：引用一個已有話題，將佢嘅內容帶入當前對話

{% hint style="info" %}
喺【設定】→【外觀】→【輸入設定】中打開 **顯示預估 Token 數** 後，輸入框亦都會顯示預估嘅 Token 消耗，作參考（唔同模型分詞方式唔同，實際計費以模型供應商為準）。
{% endhint %}

## 對話設定

對話介面嘅 **消息顯示** 同 **輸入相關** 偏好而家統一放喺 `設定 → 外觀` 入面，對所有助手嘅所有對話全局生效；**模型參數** 就按助手分開設定。

### 消息顯示與輸入設定

以下偏好都喺 `設定 → 外觀` 入面調整，完整說明見 外觀：

* **消息顯示**：消息樣式（氣泡 / 簡潔）、使用襯線字體、消息字體大小、思考內容自動摺疊、顯示消息大綱、代碼顯示行號 / 代碼塊可摺疊 / 代碼塊可換行、代碼風格、數學公式渲染等
* **輸入相關**：發送快捷鍵、顯示預估 Token 數、Markdown 渲染輸入消息、刪除消息前確認等

### 模型參數

溫度、Top-P、最大 Token 數、流式輸出、上下文管理、自定義參數等 **模型參數係按助手設定嘅**，位於 [編輯助手](#bian-ji-zhu-shou) 對話框嘅「模型」標籤頁，具體見下方 [助手設定](#zhu-shou-she-zhi)。

## 助手設定

喺助手列表中 **右鍵撳** 需要設定嘅助手，喺彈出選單中揀【編輯助手】，就可以打開助手編輯對話框。

### 編輯助手

{% hint style="info" %}
助手設定作用於該助手底下嘅所有對話。
{% endhint %}

編輯對話框左側分為五個標籤頁：

* **基礎**：頭像、名稱、描述、該助手嘅預設模型、分組
* **模型**：溫度、Top-P、最大 Token 數、流式輸出、上下文管理、自定義參數等模型參數
* **提示詞**：即係 prompt，可以參照 [智能體](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md) 頁面嘅提示詞寫法來編輯內容
* **知識庫**：關聯已建好嘅 [知識庫](/docs/zhong-wen-fan-ti/knowledge-base/knowledge-base.md)
* **MCP**：為該助手啟用 MCP 伺服器

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-1e750565c0e9cb0ae343c2161a594236e1961ecf%2Fimage%20(6)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>編輯助手對話框（基礎標籤頁）</p></figcaption></figure>

#### 預設模型（基礎標籤頁）

喺「基礎」標籤頁可為該助手固定一個預設模型；唔設定時就跟隨 [全局預設對話模型](/docs/zhong-wen-fan-ti/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing)。

{% hint style="info" %}
助手嘅預設模型優先級高過全局預設對話模型。當唔設定助手預設模型時，助手預設模型 = 全局預設對話模型。你亦可以隨時喺對話頁面頂部嘅模型下拉選單中臨時切換模型。
{% endhint %}

#### 模型參數（模型標籤頁）

以下參數都喺「模型」標籤頁中調整。

#### <mark style="color:blue;">**`溫度 (Temperature)`**</mark> ：

溫度參數控制模型生成文本嘅隨機性同創造性程度（預設值為 0.7）。具體表現為：

* 低溫度值(0-0.3)：
  * 輸出更確定、更專注
  * 適合代碼生成、數據分析等需要準確性嘅場景
  * 傾向於選擇最有可能嘅詞彙輸出
* 中等溫度值(0.4-0.7)：
  * 平衡咗創造性同連貫性
  * 適合日常對話、一般性寫作
  * 推薦用於聊天機械人對話(0.5 左右)
* 高溫度值(0.8-1.0)：
  * 產生更具創造性同多樣性嘅輸出
  * 適合創意寫作、腦力激盪等場景
  * 但可能降低文本嘅連貫性

#### <mark style="color:blue;">**`Top P (核採樣)`**</mark>：

預設值為 1，值越細，AI 生成嘅內容越單調，亦越容易理解；值越大，AI 回覆嘅詞彙範圍越大，越多樣化。

核採樣透過控制詞彙選擇嘅概率閾值嚟影響輸出：

* 較小值(0.1-0.3)：
  * 只考慮最高概率嘅詞彙
  * 輸出更保守、更可控
  * 適合代碼註釋、技術文檔等場景
* 中等值(0.4-0.6)：
  * 平衡詞彙多樣性同準確性
  * 適合一般對話同寫作任務
* 較大值(0.7-1.0)：
  * 考慮更廣泛嘅詞彙選擇
  * 產生更豐富多樣嘅內容
  * 適合創意寫作等需要多樣化表達嘅場景

{% hint style="info" %}

* 呢兩個參數可以獨立使用或者組合使用
* 根據具體任務類型選擇合適嘅參數值
* 建議通過實驗搵到最適合特定應用場景嘅參數組合
* 以上內容僅供參考同了解概念，所給參數範圍未必適合所有模型，具體可參考模型相關文檔給出嘅參數建議。
  {% endhint %}

#### <mark style="color:blue;">**`上下文管理`**</mark>

控制隨請求一齊發送畀模型嘅歷史上下文點樣處理。開啟後此助手使用自定義嘅上下文管理設定（如自動壓縮較長歷史、按閾值截斷），關閉時跟隨全局設定。上下文越長，模型記住嘅信息越多，但消耗嘅 token 亦都越多。

#### <mark style="color:blue;">**`最大工具調用輪次`**</mark>

限制助手喺一次回覆中連續調用工具嘅輪數。新建助手預設使用 100 輪，可喺 1–1000 之間設定；已有助手會保留原來嘅值，舊配置常見為 20 輪。

如果出現「達到工具調用輪次上限」一類提示，可適當提高呢項，或者將任務拆細後重試。輪數越高，工具鏈運行可能越耐，亦可能消耗更多 Token；普通對話唔使主動調高。

#### <mark style="color:blue;">**`開啟消息長度限制 (MaxToken)`**</mark>

單次回答最大 [Token](https://docs.cherry-ai.com/question-contact/knowledge#shen-me-shi-tokens) 數，喺大語言模型中，max token（最大令牌數）係一個關鍵參數，佢直接影響模型生成回答嘅質量同長度。

> 例如：喺 CherryStudio 當中填好 key 後測試模型係咪連通時，只需要知道模型有冇正確返回消息而唔需要特定內容，呢種情況下設定 MaxToken 為 1 就得。

多數模型嘅 MaxToken 上限為 32k Tokens，當然亦都有 64k，甚至更多，具體需要去對應介紹頁面查看。

具體設定幾多取決於自己嘅需要，當然亦可以參考以下建議。

{% hint style="success" %}
建議：

* 普通聊天：500-800
* 短文生成：800-2000
* 代碼生成：2000-3600
* 長文生成：4000 及以上 (需要模型本身支援)
  {% endhint %}

{% hint style="warning" %}
一般情況下模型生成嘅回答會被限制喺 MaxToken 嘅範圍內，當然亦都可能會出現被截斷（例如寫長代碼時）或者表達唔完整等情況，特殊情況下亦都需要根據實際情況靈活調整。
{% endhint %}

#### <mark style="color:blue;">**`流式輸出（Stream）`**</mark>

流式輸出係一種數據處理方式，佢容許數據以連續嘅流形式傳輸同處理，而唔係一次過發送晒所有數據。呢種方式令數據可以喺生成後即時被處理同輸出，大大提高咗即時性同效率。

喺 CherryStudio 客戶端等類似環境下簡單嚟講就係打字機效果。

關閉後(非流)：模型生成完信息後成段一次過輸出（諗像一下微信收到消息嘅感覺）；

打開時：逐字輸出，可以理解為大模型每生成一個字就即刻發送畀你，直到全部發送完。

{% hint style="info" %}
如果某些特殊模型唔支援流式輸出需要將呢個開關關閉，例如 **一開始** 只支援非流嘅 o1-mini 等。
{% endhint %}

#### <mark style="color:blue;">**`自定義參數`**</mark>

喺請求體（body）中加入額外請求參數，例如 `presence_penalty` 等欄位，一般人一般情況下用唔到。

> 上述 top-p、maxtokens、stream 等參數就係呢啲參數之一。

填法：參數名稱—參數類型（文本、數字等）—值，參考文檔：[撳前往](https://openai.apifox.cn/doc-3222739)

{% hint style="info" %}
各個模型供應商都或多或少有自己獨有嘅參數，需要去供應商嘅文檔中搵使用方法
{% endhint %}

{% hint style="info" %}

* 自定義參數優先級高過內置參數。即係自定義參數如果同內置參數重複，咁自定義參數會覆蓋內置參數。

> 例如：自定義參數中設定 `model` 為 `gpt-4o` 後，喺對話中無論揀邊個模型都使用嘅係 `gpt-4o` 模型。

* 使用 <kbd>參數名稱:undefined</kbd> 嘅設定可排除參數。
  {% endhint %}

***

### 攞幫助同提交意見

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