# 快捷键设置

### 1. 进入快捷键设置

* **路径：** `设置 (Settings)` > 左侧导航栏 `快捷键 (Shortcuts)`。
* **用途：** 在此界面，您可以查看默认快捷键、修改按键组合，或启用/禁用特定快捷键。

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

### 2. 界面操作逻辑说明

在每一个快捷键选项的右侧，有三个交互元素，从右至左依次为：

1. **开关 (Toggle Switch 🟢/⚪):**
   * **绿色：** 该快捷键已**启用**。
   * **灰色：** 该快捷键已**禁用**（如图中的“快捷助手”、“重命名话题”等）。如果您发现按键没反应，请先检查此处是否开启。
2. **键盘图标 (⌨️):**
   * 点击此图标后，屏幕会提示“请输入快捷键”。此时按下您想设置的新组合键（例如 `Ctrl + Alt + A`），即可**自定义**该功能的快捷键。
3. **重置图标 (↺):**
   * 点击此图标，将该特定功能的快捷键恢复为系统默认设置。

***

### 3. 核心快捷键详解

为了方便记忆，我们将截图中的快捷键分为四大类：**视图控制**、**对话管理**、**消息操作** 和 **全局功能**。

> **💡 说明：** 截图显示为 macOS 键位 (`⌘` = Command)。**Windows 用户**请通常将 `⌘` 替换为 `Ctrl`，将 `⇧` 替换为 `Shift`，`⌥` 替换为 `Alt`。

#### 3.1 视图与导航控制 (View & Navigation)

*这类快捷键用于调整软件界面的显示方式，适应不同的屏幕尺寸和阅读习惯。*

* **放大界面 (Zoom In):** `⌘ + =`
  * **场景：** 字体太小看不清时使用。
* **缩小界面 (Zoom Out):** `⌘ + -`
  * **场景：** 想要在一屏内显示更多内容时使用。
* **重置缩放 (Reset Zoom):** `⌘ + 0`
  * **场景：** 一键恢复到默认的 100% 大小。
* **打开设置 (Open Settings):** `⌘ + ,`
  * **场景：** 快速进入配置页面（这是 macOS 软件的通用标准）。
* **切换助手显示 (Toggle Assistant List):** `⌘ + [`
  * **场景：** 隐藏左侧的模型/助手列表，扩大对话区域。
* **切换话题显示 (Toggle Topic List):** `⌘ + ]`
  * **场景：** 隐藏左侧的历史对话列表，让对话框占据最大宽度，实现“沉浸式写作”。
* **退出全屏 (Exit Full Screen):** `Escape`

#### 3.2 对话与话题管理 (Chat Management)

*这类快捷键用于快速开启新对话或管理当前上下文。*

* **新建话题 (New Topic):** `⌘ + N`
  * **🔥 高频推荐：** 当您想结束当前话题，开始一个全新的任务时，按下此键立即清空上下文并新建窗口。
* **重命名话题 (Rename Topic):** `⌘ + T` *(默认关闭)*
  * **功能：** 快速修改左侧历史记录中当前对话的标题。
* **清除上下文 (Clear Context):** `⌘ + K`
  * **🔥 核心功能：** 这是一个非常重要的功能！它**不会删除**聊天记录，但会强制 AI **“忘记”** 之前的对话内容。
  * **场景：** 当 AI 陷入逻辑死循环，或者你想在同一个窗口聊一个完全不相关的新话题且不想被之前的对话干扰时使用。
* **清空消息 (Clear Messages):** `⌘ + L`
  * **功能：** 彻底删除当前窗口的所有视觉消息（慎用）。

#### 3.3 消息处理与搜索 (Message Handling)

*针对具体某一条消息或查找内容的操作。*

* **搜索消息 (Global Search):** `⌘ + ⇧ + F`
  * **功能：** 全局搜索。在所有历史对话中查找关键词。
* **在当前对话中搜索 (Search in Chat):** `⌘ + F`
  * **功能：** 局部搜索。仅在当前打开的对话窗口中查找关键词。
* **复制上一条消息 (Copy Last Message):** `⌘ + ⇧ + C` *(默认关闭)*
  * **场景：** 快速提取 AI 刚刚生成的代码或文本，无需鼠标选中。
* **编辑最后一条用户消息 (Edit Last User Message):** `⌘ + ⇧ + E` *(默认关闭)*
  * **场景：** 发送后发现有错别字，或者想微调刚才的 Prompt 重新提问时。

#### 3.4 全局与辅助工具 (Global Tools)

*即使 Cherry Studio 处于后台或最小化状态也能触发的功能（需设置全局快捷键）。*

* **显示 / 隐藏应用 (Show / Hide App):** *(默认未设置)*
  * **建议设置：** 推荐设置为 `Alt + Space` 或 `Option + Space`。
  * **场景：** “老板键”。无论你在做什么，一键呼出 Cherry Studio 进行提问，再按一次一键隐藏。
* **快捷助手 (Quick Assistant):** `⌘ + E` *(默认关闭)*
  * **功能：** 呼出一个迷你的悬浮输入框（类似 Spotlight 或 Alfred），快速提问，用完即走。
* **划词助手 (Word Assistant):** *(默认未设置)*
  * **功能：** 配合“划词助手”功能，在浏览器或其他软件中选中文字后，按下快捷键直接调用 AI 进行翻译或解释。

***

### 4. 底部功能区

* **重置默认快捷键 (Reset Default Shortcuts):**
  * 位于界面右下角的按钮。如果您修改乱了，或者快捷键冲突导致无法使用，点击此按钮可将所有键位恢复到安装时的初始状态。

***

### 📝 效率专家建议 (Pro Tips)

1. **设置“老板键”：** 为 **“显示/隐藏应用”** 设置一个顺手的全局快捷键（如 `Option + Q` 或 `Alt + S`），这样您无需从任务栏寻找图标即可随时唤起 AI。
2. **区分 `⌘+K` 和 `⌘+N`：**
   * 想彻底新开一局？用 `⌘ + N`。
   * 想保留聊天记录作为笔记，但让 AI 重新开始思考？用 `⌘ + K`。


---

# Agent Instructions: 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/pre-basic/settings/key-shortcut.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.
