# 对话界面

对话界面是 Cherry Studio 最常用的页面，但其结构包含**两个层次**：助手 → 话题。理解这一结构有助于更高效地使用各类对话功能。

> 推荐先阅读 [概念入门](/advanced-basic/concepts-101.md) 了解助手 / 智能体 / 技能等相关概念。

## 助手与话题的关系

简单类比：

* **助手 = 一个角色**（如"产品文档助理"、"代码 reviewer"）
* **话题 = 与该角色的一段对话**（如周一讨论"重构方案"、周二讨论"bug 报告"）

也就是说：**一个助手下可创建多个话题**，所有话题共用该助手的人设与参数（提示词、模型、温度等），无需每次重新设定 AI 的角色与风格。

### 助手

助手为 AI 设定固定角色 —— 由系统提示词 + 模型参数预设组成。

* **系统默认助手**：通用助手，未设特殊提示词，可直接使用
* **更专项的助手**：在 [助手广场](/cherry-studio/preview/assistants.md) 浏览现成预设，或自行创建

### 话题

每个助手下可创建多个话题（即多段独立对话）。话题之间相互独立，但共享所属助手的设置。

适用场景示例：

* 同一个"代码助手"下分别开"项目 A 重构"、"项目 B bug"两个话题，独立管理
* 同一个"翻译助手"下开多个话题，分别处理不同文章

<figure><img src="/files/1QlYrhq1jkna6uMjWeI2" alt=""><figcaption></figcaption></figure>

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

## 对话框内按钮

<figure><img src="/files/bespX5lAiV5C4VXglJHH" alt=""><figcaption><p>Cherry Studio 对话框工具栏（v1.9.9 实拍）</p></figcaption></figure>

Cherry Studio 的对话框工具栏中的工具具体顺序可由你长按拖拽自行调整。

### 左侧工具

| 图标                               | 名称          | 作用                                                        |
| -------------------------------- | ----------- | --------------------------------------------------------- |
| ![](/files/qSYhrzb0YKpqja3dwVQF) | **新话题**     | 在当前助手内创建一个新话题                                             |
| ![](/files/OyH9fgqF06RSAfDHRTC6) | **上传附件**    | 上传图片或文档；图片需模型支持视觉能力；文档会被自动解析为上下文                          |
| ![](/files/WKQe4vWtWXDirTs8nuy7) | **网络搜索**    | 把网页搜索结果作为上下文返回给模型，需先在 [联网模式](/pre-basic/websearch.md) 中配置 |
| ![](/files/JiG1PIpW7GsUKVdah4Hm) | **知识库**     | 把一个已建好的 [知识库](/knowledge-base/knowledge-base.md) 作为上下文    |
| ![](/files/06TSsY9IcCM2TH4nS5uW) | **MCP 服务器** | 启用 [MCP](/advanced-basic/mcp.md) 工具供模型调用                  |
| ![](/files/UEVHz0bh8XiJj189NJUo) | **提及模型**    | 临时切换接下来的回复模型，保留上下文                                        |
| ![](/files/JpKxbgMLRYVau82gN5Q6) | **快捷短语**    | 调用预设模板，详见 [快捷短语](/advanced-basic/quick-phrase.md)         |
| ![](/files/MMRiWZlEcmKswBXXvt8F) | **清空消息**    | **删除**该话题下所有消息（不可恢复）                                      |
| ![](/files/jjEURPmlCgtytpGCbeUw) | **展开 / 收起** | 让输入框变得更大或恢复，便于输入长文                                        |
| ![](/files/FTbFKnZDcCIrJXnLA1Zv) | **清除上下文**   | **保留消息**但让模型"忘掉"之前的对话（截断 token 上下文）                       |

{% hint style="warning" %}
**"清空消息" vs "清除上下文"** 是两件不同的事：

* **清空消息**：物理删除全部消息内容，不可恢复
* **清除上下文**：消息仍在，只是让模型从此刻开始重新认识你，它不再会记得此前的对话
  {% endhint %}

### 右下角工具

| 图标                               | 名称     | 作用                                                              |
| -------------------------------- | ------ | --------------------------------------------------------------- |
| ![](/files/t1sXMsqdCrTt8GHSpAD5) | **翻译** | 将输入框内容直接翻译为目标语言（在 `设置 → 默认模型` 中配置默认翻译模型）                        |
| ![](/files/aY9SBkliSloCB2clMbYc) | **发送** | 发送消息（默认 Enter；可在 [快捷键](/pre-basic/settings/key-shortcut.md) 中改） |

### 仅在符合条件时显示的工具

下列工具不在默认工具栏中，**仅当所选模型 / 助手支持时才出现**：

| 图标                               | 名称        | 作用                                                              |
| -------------------------------- | --------- | --------------------------------------------------------------- |
| ![](/files/RE0UZfm5O0mHV5vVCpTn) | **生成图片**  | 所选对话模型支持生图时出现。专门的生图模型请去 [绘画](/cherry-studio/preview/drawing.md) |
| ![](/files/UBQxZ8NPsle4AQcfqk8a) | **思考模式**  | 所选模型支持深度推理时出现（如 GPT-5 系列、Claude Opus4.8、Qwen-3.7-plus等）         |
| ![](/files/RcmksdfT6fGA4jmorHGz) | **网页上下文** | 所选模型支持原生 URL 输入时出现                                              |
| ![](/files/ypVMUPzSQ4DYPeslIma5) | **斜杠命令**  | 在 Cherry Agent 会话中出现，提供 `/clear`、`/exit` 等内置命令                  |

### 通过键盘触发的能力

除了点击按钮，还可以直接在输入框中按特定键唤起对应面板：

* **`@`**：唤起模型选择器（与上面"提及模型"按钮等价）
* **`/`**：唤起斜杠命令面板，可快速插入快捷短语、翻译、工具调用等

### 对话框右下角：Token 计数

![](/files/fcsBM9MQFMyTUM8p0msx)

输入框右下角还显示 **预估 Token 数**，包含四个数值：`当前上下文数` / `最大上下文数`（∞ 表示无限）/ `当前上下文 Token 数` / `预估 Token 数`。

{% hint style="info" %}
此处仅为预估值，不同模型的 Tokenizer 不同，实际计费以模型提供商为准。
{% endhint %}

## 对话设置

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

### 模型设置

模型设置与助手设置当中的 `模型设置` 参数同步，详见 [助手设置](#bian-ji-zhu-shou)。

{% hint style="info" %}
在对话设置当中，仅该模型设置作用于当前助手，其余设置作用于全局。如：设置消息样式为气泡后在任何助手的任何话题下都是气泡样式。
{% endhint %}

### 消息设置

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

使用分割线将消息正文与操作栏隔开。

{% tabs %}
{% tab title="打开时" %}

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

{% tab title="关闭时" %}

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

#### <mark style="color:blue;">**`使用衬线字体`**</mark>：

字体样式切换，现在你也可以通过 [自定义css](/pre-basic/personalization-settings.md) 来更换字体。

#### <mark style="color:blue;">**`代码显示行号`**</mark>：

模型输出代码片段时显示代码块行号。

{% tabs %}
{% tab title="关闭时" %}

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

{% tab title="打开时" %}

<figure><img src="/files/yJJgX00dsV9YuiJbjYK1" 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/vEe09qc5WovvLV6JKK8u" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="打开时" %}

<figure><img src="/files/ghrLkBwzVYBuZH7JxB20" 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/aXZJTySWb5PsE9r4kA0q" alt=""><figcaption></figcaption></figure>

#### 提示词设置

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

可自定义方便辨识的助手名称。

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

即 prompt ，可以参照智能体页面的提示词写法来编辑内容。

#### 模型设置

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

可以为该助手固定一个默认模型，从智能体页面添加时或复制助手时初始模型为该模型。不设置该项初始模型则为全局初始模型(即 [默认助手模型](/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing) )。

{% hint style="info" %}
助手的默认模型有两种，一为 [全局默认对话模型](/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 或有功能改进建议，请参考 [反馈与建议](/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/cherry-studio/preview/chat.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.