# General Settings

<figure><img src="/files/61aabe885db02319806a7ef74cfeac9e117f956b" alt=""><figcaption></figcaption></figure>

#### Part 1: Basic Environment Configuration <a href="#headingc1f7c3c4e1e6438d82ae1f2c59b65b95-di-yi-bu-fen-ji-chu-huan-jing-pei-zhi-chang-gui-she-zhi-0" id="headingc1f7c3c4e1e6438d82ae1f2c59b65b95-di-yi-bu-fen-ji-chu-huan-jing-pei-zhi-chang-gui-she-zhi-0"></a>

This section determines the software's display language, network connection method, and rendering performance.

**1. Language (Language)**

* **Detailed Explanation:** Switch the display language of the software interface.

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

* **Supported list:** Click the drop-down menu on the right to see support for **Simplified Chinese, Traditional Chinese, English, German, Japanese, Russian, Greek, Spanish, French, Portuguese**.
* **💡 Use cases:** If you are used to reading English technical documents or want to take screenshots to report issues to overseas developers, you can switch here.

**2. Proxy Mode (Proxy Mode)**

* **Detailed Explanation:**
  * **System Proxy (System Proxy):** The software will automatically follow the network settings of your Windows/macOS system. If you have enabled a global accelerator on your computer, the software will automatically use that network.
* **💡 Key Tip:** Cherry Studio mainly calls overseas model APIs such as OpenAI and Claude.**If you encounter red error messages such as “connection timed out” or “API request failed”**, please first check whether the software on your computer is enabled, and confirm whether this is set to “System Proxy”.

**3. Spell Check (Spell Check)**

* **Detailed Explanation:** When enabled, as you type text in the chat box, the system will automatically detect spelling errors (mainly for English words) and display a red wavy line under the misspelled word.
* **💡 Recommendation:**
  * If you often converse with**English**AI, it is recommended to**enable it**.
  * If you mainly use**Chinese**, it is recommended to**turn it off**, to avoid false positives distracting your view.

**4. Disable Hardware Acceleration**

* **Detailed Explanation:** Cherry Studio is developed based on the Electron framework. By default, it uses the graphics card (GPU) to render the interface for a smoother experience. Turning on this switch means**forcing CPU rendering**.
* **⚠️ For troubleshooting only:** Under normal circumstances, please**keep it turned off**(that is, the slider is gray).
* **When do you need to enable it?** If your software has the following display problems, enable this option and restart the software:
  * The software interface is black, white, or flickering.
  * The interface text is blurry or tearing.
  * Operation is noticeably laggy on lower-spec computers.

***

#### Part 2: Messages and Alerts (Notification Settings) <a href="#headingc1f7c3c4e1e6438d82ae1f2c59b65b95-di-er-bu-fen-xiao-xi-yu-ti-xing-tong-zhi-she-zhi-0" id="headingc1f7c3c4e1e6438d82ae1f2c59b65b95-di-er-bu-fen-xiao-xi-yu-ti-xing-tong-zhi-she-zhi-0"></a>

Controls how the software disturbs you while running in the background.

**1. Assistant Message**

* **Detailed Explanation:** When you switch to other software to work and the AI finally finishes generating a long reply, the system will pop up a notification to remind you.
* **💡 Recommendation:** **enable it**. Especially when using reasoning models (such as o1) or generating long text, this avoids boring waiting.

**2. Backup**

* **Detailed Explanation:** Send a notification when the software completes automatic data backup or manual backup.
* **💡 Recommendation:** **enable it**. Make sure you know whether the data has been safely archived.

**3. Knowledge Base**

* **Detailed Explanation:** Building the knowledge base index usually takes a long time; when enabled, you will be notified when indexing is complete.
* **💡 Recommendation:** **enable it**.

***

#### Part 3: Software Behavior Habits (Startup and Tray) <a href="#headingc1f7c3c4e1e6438d82ae1f2c59b65b95-di-san-bu-fen-ruan-jian-xing-wei-xi-guan-qi-dong-yu-tuo-pan" id="headingc1f7c3c4e1e6438d82ae1f2c59b65b95-di-san-bu-fen-ruan-jian-xing-wei-xi-guan-qi-dong-yu-tuo-pan"></a>

These settings determine whether Cherry Studio stays in the background like WeChat, or leaves when you're done like a normal app.

**1. Startup**

* **Start automatically on boot:**
  * **Enable scenario:** If Cherry Studio is your main productivity tool, it is recommended to enable this so it is ready when you start your computer.
* **Minimize to tray on startup:**
  * **Use with:** Usually used together with “start on boot.” When enabled, the software will start silently in the background when the computer boots, without popping up the main window and blocking the desktop, keeping the desktop tidy.

**2. System Tray**

* **Show tray icon:**
  * It is recommended to always**enable it**. It is convenient to quickly bring up the software or check its status from the lower-right corner.
* **Minimize to tray when closing (key setting):**
  * **Enable (🟢):** When clicking the `X` close button in the upper-right/upper-left corner of the window, the software**will not exit**, but will shrink to the tray in the lower-right corner. This way, the next time you open it, it will appear instantly, and ongoing conversations will not be interrupted.
  * **Disable (⚪):** Click `X` This will completely kill the process and exit the software.
  * **💡 Strongly recommended:** **enable it**. Keeping the software running in the background provides the best experience.

***

#### Part 4: Advanced Options <a href="#headingc1f7c3c4e1e6438d82ae1f2c59b65b95-di-si-bu-fen-gao-ji-xuan-xiang-0" id="headingc1f7c3c4e1e6438d82ae1f2c59b65b95-di-si-bu-fen-gao-ji-xuan-xiang-0"></a>

**1. Privacy Settings**

* **Send anonymous error reports and data statistics:**
  * Enabling this helps developers fix bugs. The data is completely anonymous (it does not include your chat records or API key). It is recommended to enable it to support the development of open-source projects.

**2. Developer Mode**

* **Enable developer mode:**
  * **Function:** When enabled, more debug information may be shown on the interface (for example, raw Prompt packets, token calculation details, etc.), or access to test features that have not yet been fully released may be allowed.
  * **💡 Recommendation:** Recommended for ordinary users**turn it off**, to avoid too many technical parameters on the interface that you can't understand, which can affect the immersive experience.

***

#### 📝 Summary: Recommended settings <a href="#headingc1f7c3c4e1e6438d82ae1f2c59b65b95-zong-jie-tui-jian-she-zhi-fang-an-0" id="headingc1f7c3c4e1e6438d82ae1f2c59b65b95-zong-jie-tui-jian-she-zhi-fang-an-0"></a>

* **Geeks / heavy users:**
  * [x] Start automatically on boot
  * [x] Minimize to tray when closing
  * [x] Disable hardware acceleration (only when display issues occur)
  * [x] Enable developer mode
* **Regular / office users:**
  * [ ] Start automatically on boot (as needed)
  * [x] Minimize to tray when closing (strongly recommended)
  * [x] Assistant message notifications
  * [ ] Spell check (turn off if you mainly use Chinese)


---

# 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/docs/en-us/pre-basic/settings/general.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.
