> 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/en-us/pre-basic/settings/general.md).
# General Settings
#### Part 1: Basic Environment Configuration
This section determines the software's display language, network connection method, and rendering performance.
**1. Language (Language)**
* **Details:** Switch the display language of the software interface.
* **Supported list:** As shown in the dropdown menu on the right, it supports **Simplified Chinese, Traditional Chinese, English, German, Japanese, Russian, Greek, Spanish, French, Portuguese**.
* **đź’ˇ Use case:** If you are used to reading English technical documents, or if you want to take screenshots to report issues to overseas developers, you can switch here.
**2. Proxy Mode (Proxy Mode)**
* **Details:**
* **System Proxy (System Proxy):** The software will automatically follow your Windows/macOS system network settings. If you have a global accelerator enabled 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”**, first check whether the software on your computer is enabled, and confirm whether this is set to “System Proxy”.
**3. Spell Check (Spell Check)**
* **Details:** When enabled, while typing text in the chat box, the system will automatically detect spelling errors (mainly for English words) and show a red wavy underline under misspelled words.
* **đź’ˇ Recommendation:**
* If you often use**English**to chat with AI, it is recommended**Enable**.
* If you mainly use**Chinese**, it is recommended**turn it off**, to avoid false positives cluttering the view.
**4. Disable Hardware Acceleration (Disable Hardware Acceleration)**
* **Details:** Cherry Studio is developed based on the Electron framework and uses the graphics card (GPU) by default to render the interface for a smoother experience. Turning this switch on means**force CPU rendering**.
* **⚠️ For troubleshooting only:** Under normal circumstances, please**keep it off**(i.e., the slider is gray).
* **When do you need to turn it on?** If your software has the following display issues, enable this option and restart the software:
* Black screen, white screen, or flickering interface.
* Blurry or torn interface text.
* Noticeable lag on lower-spec computers.
***
#### Part 2: Messages and Alerts (Notification Settings)
Controls how the software bothers you while running in the background.
**1. Assistant Message (Assistant Message)**
* **Details:** When you switch to working in another app and the AI finally finishes generating a long response, the system will pop up a notification to remind you.
* **đź’ˇ Recommendation:** **Enable**. Especially when using reasoning models (such as o1) or generating long text, this helps avoid boring waits.
**2. Backup (Backup)**
* **Details:** Send a notification when the software completes an automatic or manual data backup.
* **đź’ˇ Recommendation:** **Enable**. Ensure you know whether the data has been safely archived.
**3. Knowledge Base (Knowledge Base)**
* **Details:** Building the knowledge base index usually takes time; when enabled, you will be notified when indexing is complete.
* **đź’ˇ Recommendation:** **Enable**.
***
#### Part 3: Software Behavior Habits (Startup and Tray)
These settings determine whether Cherry Studio stays in the background like WeChat, or exits when you're done like a normal app.
**1. Startup (Startup)**
* **Start automatically on boot:**
* **Usage scenario:** If Cherry Studio is your main productivity tool, it is recommended to enable this so it is ready as soon as you boot up.
* **Minimize to tray on startup:**
* **Use with:** Usually used together with “Start on boot.” When enabled, the software will start silently in the background at boot and will not directly pop up the main window to block the desktop, keeping the desktop tidy.
**2. Tray (System Tray)**
* **Show tray icon:**
* It is recommended to always**Enable**. This makes it easy to quickly bring up the software or check its status from the bottom-right corner.
* **Minimize to tray when closing (key setting):**
* **Enabled (🟢):** Click the top-right/top-left `X` close button, the software**will not quit**, but will shrink to the tray in the bottom-right corner. This way, the next time you open it, it will be “instant,” and ongoing conversations will not be interrupted.
* **Disabled (⚪):** Click `X` means completely killing the process and exiting the software.
* **đź’ˇ Strongly recommended:** **Enable**. Keeping the software resident in the background provides the best experience.
***
#### Part 4: Advanced Options
**1. Privacy Settings**
* **Send error reports and usage statistics anonymously:**
* Enabling this helps developers fix bugs. The data is completely anonymous (it does not include your chat history or API key), and it is recommended to enable it to support the development of the open-source project.
**2. Developer Mode**
* **Enable developer mode:**
* **Function:** After enabling, more debugging information may be shown in the interface (for example, raw prompt packets, token calculation details, etc.), or it may allow access to test features that have not yet been fully released.
* **đź’ˇ Recommendation:** For regular users, it is recommended**turn it off**, to avoid too many incomprehensible technical parameters appearing in the interface and affecting the immersive experience.
***
#### đź“ť Summary: Recommended settings
* **Geek/power users:**
* [x] Start automatically on boot
* [x] Minimize to tray when closing
* [x] Disable hardware acceleration (only when display is abnormal)
* [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)
***
### đź’ˇ Get help and submit feedback
If you encounter any questions, bugs, or have suggestions for feature improvements during configuration or use, please refer to [Feedback and Suggestions](/docs/en-us/question-contact/suggestions.md) the official channels provided there.
---
# 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/en-us/pre-basic/settings/general.md?ask=&goal=
```
`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.