> 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 最常用嘅頁面，但其結構包含**兩個層次**：助手 → 話題。理解呢個結構有助於更高效咁使用各類對話功能。

> 推薦先閱讀 [概念入門](/docs/zhong-wen-fan-ti/advanced-basic/concepts-101.md) 了解助手 / 智能體 / 技能等相關概念。

## 助手與話題嘅關係

簡單類比：

* **助手 = 一個角色**（如"產品文檔助理"、"code reviewer"）
* **話題 = 同該角色嘅一段對話**（如星期一討論"重構方案"、星期二討論"bug 報告"）

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

### 助手

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

* **系統預設助手**：通用助手，未設特別提示詞，可直接使用
* **更專項嘅助手**：喺 [助手廣場](/docs/zhong-wen-fan-ti/cherry-studio/preview/assistants.md) 瀏覽現成預設，或者自己建立

### 話題

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

適用場景示例：

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

<figure><img src="/files/1285c8f1c6f5faaf0773ba342ec194ab317a6c9c" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/e20805316d25e962a9d512c353f7b6575e2369be" alt=""><figcaption></figcaption></figure>

## 對話框內按鈕

<figure><img src="/files/698c516865b3b0b26e5b985f503b005a26eb9d49" alt=""><figcaption><p>Cherry Studio 對話框工具欄（v1.9.9 實拍）</p></figcaption></figure>

Cherry Studio 嘅對話框工具欄入面嘅工具具體順序可以由你長按拖拽自己調整。

### 左側工具

| 圖示                                                   | 名稱          | 作用                                                                              |
| ---------------------------------------------------- | ----------- | ------------------------------------------------------------------------------- |
| ![](/files/f86ec242ebb0107d0cf62c81e2e6574fbd8f34b1) | **新話題**     | 喺當前助手內建立一個新話題                                                                   |
| ![](/files/c6f312c66d6f71ebeb5b21ec5ad3e3c07c7eee60) | **上傳附件**    | 上傳圖片或文檔；圖片需要模型支援視覺能力；文檔會自動解析做上下文                                                |
| ![](/files/f87d8c5f9715e4cf457fd2db291d38229c03c1bf) | **網絡搜尋**    | 將網頁搜尋結果作為上下文返畀模型，需要先喺 [連網模式](/docs/zhong-wen-fan-ti/pre-basic/websearch.md) 中配置 |
| ![](/files/8d92c42494be4c5bb32cf395d7d683bc9f7d9f20) | **知識庫**     | 將一個已建立好嘅 [知識庫](/docs/zhong-wen-fan-ti/knowledge-base/knowledge-base.md) 作為上下文   |
| ![](/files/f17849d5463cd36e08adf2d93e7d8e40dfe49643) | **MCP 伺服器** | 啟用 [MCP](/docs/zhong-wen-fan-ti/advanced-basic/mcp.md) 工具畀模型調用                  |
| ![](/files/3379556701e296ff83db174f4f189c9daec4e833) | **提及模型**    | 暫時切換接落嚟嘅回覆模型，保留上下文                                                              |
| ![](/files/379d43cae3b95fb5cacaa21ea0ca95505174d1d9) | **快捷短語**    | 調用預設模板，詳見 [快捷短語](/docs/zhong-wen-fan-ti/advanced-basic/quick-phrase.md)         |
| ![](/files/5457ad8634a054789acb0bae788d14992d16fe60) | **清空消息**    | **刪除**呢個話題下所有消息（不可恢復）                                                           |
| ![](/files/81afb390b311d9e821988828d2a6bedc44742c31) | **展開 / 收起** | 令輸入框變得更大或者恢復，方便輸入長文                                                             |
| ![](/files/57fc67631f3150ed81b84eca84ab82ca66b40d4d) | **清除上下文**   | **保留消息**但令模型「忘記」之前嘅對話（截斷 token 上下文）                                             |

{% hint style="warning" %}
**「清空消息」 vs 「清除上下文」** 係兩件唔同嘅事：

* **清空消息**：物理刪除全部消息內容，不可恢復
* **清除上下文**：消息仍然喺度，只係令模型由呢一刻開始重新認識你，佢唔再會記得之前嘅對話
  {% endhint %}

### 右下角工具

| 圖示                                                   | 名稱     | 作用                                                                                    |
| ---------------------------------------------------- | ------ | ------------------------------------------------------------------------------------- |
| ![](/files/90161534f4f0ff3e49e60841c314cb4641debb23) | **翻譯** | 將輸入框內容直接翻譯做目標語言（喺 `設定 → 預設模型` 中配置預設翻譯模型）                                              |
| ![](/files/95e4ae98e218e440dcffbe8e19c2e25389ef3893) | **發送** | 發送消息（預設 Enter；可喺 [快捷鍵](/docs/zhong-wen-fan-ti/pre-basic/settings/key-shortcut.md) 中改） |

### 只喺符合條件時顯示嘅工具

以下工具唔喺預設工具欄入面，**只係當所選模型 / 助手支援時先會出現**：

| 圖示                                                   | 名稱        | 作用                                                                                    |
| ---------------------------------------------------- | --------- | ------------------------------------------------------------------------------------- |
| ![](/files/7e7c046fdeef67b65b29ab4ea78f526b8719982c) | **生成圖片**  | 所選對話模型支援生圖時出現。專門嘅生圖模型請去 [繪畫](/docs/zhong-wen-fan-ti/cherry-studio/preview/drawing.md) |
| ![](/files/bd395aacd8f0bb12d6587520d33da8e7bf83dfda) | **思考模式**  | 所選模型支援深度推理時出現（如 GPT-5 系列、Claude Opus4.8、Qwen-3.7-plus 等）                              |
| ![](/files/e61ed9c04b9a2d400852425d8954602bdb0451a3) | **網頁上下文** | 所選模型支援原生 URL 輸入時出現                                                                    |
| ![](/files/8e1ef8b87f8e7fd47ab0883b9ad14f3b7513128c) | **斜槓命令**  | 喺 Cherry Agent 會話中出現，提供 `/clear`、`/exit` 等內建命令                                        |

### 透過鍵盤觸發嘅能力

除咗撳按鈕之外，亦可以直接喺輸入框入面撳特定鍵叫出對應面板：

* **`@`**：叫出模型選擇器（同上面「提及模型」按鈕等價）
* **`/`**：叫出斜槓命令面板，可快速插入快捷短語、翻譯、工具調用等

### 對話框右下角：Token 計數

![](/files/690980e4e38502b6f3974ed44f8d5bfeaacd52a4)

輸入框右下角仲會顯示 **預估 Token 數**，包含四個數值：`當前上下文數` / `最大上下文數`（∞ 表示無限）/ `當前上下文 Token 數` / `預估 Token 數`。

{% hint style="info" %}
呢度只係預估值，唔同模型嘅 Tokenizer 唔同，實際收費以模型提供商為準。
{% endhint %}

## 對話設定

<figure><img src="/files/5b4a8d8fcb74b6a8d825322ae7a98731b514e173" alt=""><figcaption></figcaption></figure>

### 模型設定

模型設定同助手設定入面嘅 `模型設定` 參數同步，詳見 [助手設定](#bian-ji-zhu-shou)。

{% hint style="info" %}
喺對話設定入面，只有該模型設定作用於當前助手，其餘設定作用於全局。例如：設定消息樣式做氣泡之後，喺任何助手嘅任何話題下都係氣泡樣式。
{% endhint %}

### 消息設定

#### <mark style="color:blue;">**`消息分割線`**</mark>:

使用分割線將消息正文同操作欄隔開。

{% tabs %}
{% tab title="打開時" %}

<figure><img src="/files/e09e40bb2b6a0c23c995b7943860778ae43fc1c0" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="關閉時" %}

<figure><img src="/files/b6768adc9d95630562b8f7b3996b19e75d661b33" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### <mark style="color:blue;">**`使用襯線字體`**</mark>：

字體樣式切換，依家你亦可以透過 [自訂 css](/docs/zhong-wen-fan-ti/pre-basic/personalization-settings.md) 嚟更換字體。

#### <mark style="color:blue;">**`代碼顯示行號`**</mark>：

模型輸出代碼片段時顯示 code block 行號。

{% tabs %}
{% tab title="關閉時" %}

<figure><img src="/files/3a65892b541ba4ce356ee03716f51fe00aef6d20" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="打開時" %}

<figure><img src="/files/9ee10093766774cf846ba21c04662af99b996627" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### <mark style="color:blue;">**`代碼塊可摺疊`**</mark>：

打開後，當代碼片段入面嘅代碼較長時，會自動摺疊代碼塊。、

#### <mark style="color:blue;">**`代碼塊可換行`**</mark>：

打開後，當代碼片段入面單行代碼較長時（超出窗口），會自動換行。

#### <mark style="color:blue;">**`思考內容自動摺疊`**</mark>：

打開後，支援思考嘅模型喺思考完成之後會自動摺疊思考過程。

#### <mark style="color:blue;">**`消息樣式`**</mark>：

可切對話界面換做氣泡樣式或者列表樣式。

#### <mark style="color:blue;">**`代碼風格`**</mark>：

可切換代碼片段嘅顯示風格。

#### <mark style="color:blue;">**`數學公式引擎`**</mark>：

* KaTeX 渲染速度更快，因為佢係專門為性能優化設計嘅；
* MathJax 渲染較慢，但功能更全面，支援更多嘅數學符號同命令。

#### <mark style="color:blue;">**`消息字體大小`**</mark>：

調整對話界面字體嘅大小。

### 輸入設定

#### <mark style="color:blue;">**`顯示預估 Token 數`**</mark>：

喺輸入框顯示輸入文字預估消耗嘅 Token 數（非實際上下文消耗嘅 Token，只供參考）。

#### <mark style="color:blue;">**`長文本貼做文件`**</mark>：

當由其他地方複製長段文本貼到輸入框時，會自動顯示做文件樣式，減少之後輸入內容時嘅干擾。

#### <mark style="color:blue;">**`Markdown 渲染輸入消息`**</mark>：

關閉時只渲染模型回覆嘅消息，唔渲染發送嘅消息。

{% tabs %}
{% tab title="關閉時" %}

<figure><img src="/files/ffb6f9975fa02d252286036ddb299b81e5fe6eb3" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="打開時" %}

<figure><img src="/files/d0971a9906ae64111c3699619ac86620040223a8" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### <mark style="color:blue;">**`快速撳 3 次空格翻譯`**</mark>：

喺對話界面輸入框輸入消息之後，連撳三次空格可將輸入內容翻譯做英文。

{% hint style="warning" %}
注意：呢個操作會覆蓋原文。
{% endhint %}

#### <mark style="color:blue;">**`目標語言`**</mark>：

設定輸入框翻譯按鈕以及快速撳 3 次空格翻譯嘅目標語言。

## 助手設定

喺助手界面選擇需要設定嘅<mark style="background-color:yellow;">助手名稱</mark>→喺<mark style="background-color:yellow;">右鍵選單入面</mark>選對應設定

### 編輯助手

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

<figure><img src="/files/68e766a6dedcf31cbd4d1d0338619f89a205479e" alt=""><figcaption></figcaption></figure>

#### 提示詞設定

#### <mark style="color:blue;">**`名稱`**</mark>：

可自訂方便辨識嘅助手名稱。

#### <mark style="color:blue;">**`提示詞`**</mark>：

即係 prompt，可以參照智能體頁面嘅提示詞寫法嚟編輯內容。

#### 模型設定

#### <mark style="color:blue;">**`預設模型`**</mark>：

可以為該助手固定一個預設模型，由智能體頁面添加時或者複製助手時，初始模型會係呢個模型。如果唔設定呢項，初始模型就係全局初始模型（即 [預設助手模型](/docs/zhong-wen-fan-ti/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing) ）。

{% hint style="info" %}
助手嘅預設模型有兩種，一種係 [全局預設對話模型](/docs/zhong-wen-fan-ti/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing) ，另一種係助手預設模型；助手嘅預設模型優先級高過全局預設對話模型。當唔設定助手預設模型時，助手預設模型=全局預設對話模型。
{% endhint %}

#### <mark style="color:blue;">**`自動重置模型`**</mark>：

打開時 - 當喺該話題下使用過程中切換其他模型使用時，再次新建話題會將新話題重置為助手嘅預設模型。當呢項關閉時，新建話題嘅模型會跟隨上一話題所使用嘅模型。

> 如果助手嘅預設模型係 gpt-3.5-turbo，我喺該助手底下建立話題 1，喺話題 1 嘅對話過程中切換咗 gpt-4o 使用，咁此時：
>
> 如果開咗自動重置：新建話題 2 時，話題 2 預設選擇嘅模型係 gpt-3.5-turbo;
>
> 如果未開啟自動重置：新建話題 2 時，話題 2 預設選擇嘅模型係 gpt-4o。

#### <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;">**`上下文數量 (Context Window)`**</mark>

要保留喺上下文中嘅消息數量，數值越大，上下文越長，消耗嘅 token 越多：

* 5-10：適合普通對話
* \>10：需要更長記憶嘅複雜任務（例如：按照寫作提綱分步生成長文嘅任務，需要確保生成嘅上下文邏輯連貫）
* > 注意：消息數越多，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.