> 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.md).

# Software Settings

Cherry Studio's settings panel covers **model configuration, tool capabilities, interface preferences, productivity tools, and system behavior** and all other options. The left side of Settings is divided by **Model / Tools / Preferences / Productivity / System** into five major groups, and this section provides a map using the same grouping to make it easy to jump where needed.

### Model

| Settings item  | Documentation                                                                                          | Content                                                    |
| -------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| Model services | [Model services](https://docs.cherryai.com.cn/docs/en-us/pre-basic/providers.md)                       | Provider addition, keys, API endpoints, multi-key rotation |
| Default model  | [Default model settings](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/default-models.md) | Global default model for chat / naming / translation, etc. |
| Local models   | [Local models](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/local-models.md)             | Built-in, offline-running embedding models and OCR models  |
| API gateway    | [API gateway](https://docs.cherryai.com.cn/docs/en-us/advanced-basic/developer-tools/api-gateway.md)   | Expose a local OpenAI-compatible API externally            |

### Tools

| Settings item       | Documentation                                                                                                | Content                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |
| MCP                 | [MCP and external tools](https://docs.cherryai.com.cn/docs/en-us/advanced-basic/extensions/mcp.md)           | Model Context Protocol tool integration                             |
| skills              | [Skills and capability library](https://docs.cherryai.com.cn/docs/en-us/advanced-basic/extensions/skills.md) | Add specialized capabilities to assistants or agents                |
| Web search          | [online mode](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/websearch.md)                       | Free web access, Tavily, Volcano Engine, SearXNG, etc.              |
| Document processing | [Document processing](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/doc-process.md)             | Structured parsing of PDF / complex-layout documents (MinerU, etc.) |
| OCR                 | [OCR](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/ocr.md)                                     | Text recognition engine for images / scans                          |

### Preferences

| Settings item    | Documentation                                                                                | Content                                                                  |
| ---------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| Appearance       | [Appearance](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/display.md)          | Theme, theme color, scaling, language, and chat layout                   |
| Notifications    | [Notifications](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/notification.md)  | Assistant messages, backups, and knowledge base completion notifications |
| Data             | [Data Settings](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/data-settings.md) | WebDAV / S3 backups and third-party integrations                         |
| Usage statistics | [Usage statistics](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/usage.md)      | Cost, tokens, requests, and daily activity statistics                    |

### Productivity

| Settings item            | Documentation                                                                                                    | Content                                             |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Channels                 | [Channels](https://docs.cherryai.com.cn/docs/en-us/advanced-basic/automation/channels.md)                        | Integrate agents with Feishu / Telegram, etc.       |
| Scheduled tasks          | [Scheduled tasks](https://docs.cherryai.com.cn/docs/en-us/advanced-basic/automation/scheduled-heartbeat.md)      | Run agents on a Cron schedule                       |
| Shortcuts                | [Shortcut settings](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/key-shortcut.md)                  | Edit, enable, and disable all shortcuts             |
| Quick Assistant          | [Quick Assistant](https://docs.cherryai.com.cn/docs/en-us/cherry-studio/preview/quick-assistant.md)              | A globally floating mini chat window                |
| Text selection assistant | [Text selection assistant](https://docs.cherryai.com.cn/docs/en-us/cherry-studio/preview/selection-assistant.md) | Instant translate / explain / rewrite selected text |

### System

| Settings item            | Documentation                                                                                              | Content                                                                        |
| ------------------------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| System                   | [System](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/general.md)                            | Startup, tray, proxy, hardware acceleration, developer mode                    |
| Environment dependencies | [Environment dependencies](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/env-dependencies.md) | Installation and management of runtimes and binary tools such as uv / bun      |
| About us                 | —                                                                                                          | Version information, check for updates, license agreement, and community links |

{% hint style="info" %}
Settings changes will **take effect immediately**, without restarting. When it comes to core items such as Provider / models / default model, it is recommended to first in `Settings → Data` make a backup.
{% endhint %}

***

### 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](https://docs.cherryai.com.cn/docs/en-us/question-contact/suggestions.md) for the official channels provided.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
