> 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](/docs/en-us/pre-basic/providers.md)                       | Provider addition, keys, API endpoints, multi-key rotation |
| Default model  | [Default model settings](/docs/en-us/pre-basic/settings/default-models.md) | Global default model for chat / naming / translation, etc. |
| Local models   | [Local models](/docs/en-us/pre-basic/settings/local-models.md)             | Built-in, offline-running embedding models and OCR models  |
| API gateway    | [API gateway](/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](/docs/en-us/advanced-basic/extensions/mcp.md)           | Model Context Protocol tool integration                             |
| skills              | [Skills and capability library](/docs/en-us/advanced-basic/extensions/skills.md) | Add specialized capabilities to assistants or agents                |
| Web search          | [online mode](/docs/en-us/pre-basic/settings/websearch.md)                       | Free web access, Tavily, Volcano Engine, SearXNG, etc.              |
| Document processing | [Document processing](/docs/en-us/pre-basic/settings/doc-process.md)             | Structured parsing of PDF / complex-layout documents (MinerU, etc.) |
| OCR                 | [OCR](/docs/en-us/pre-basic/settings/ocr.md)                                     | Text recognition engine for images / scans                          |

### Preferences

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

### Productivity

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

### System

| Settings item            | Documentation                                                                  | Content                                                                        |
| ------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| System                   | [System](/docs/en-us/pre-basic/settings/general.md)                            | Startup, tray, proxy, hardware acceleration, developer mode                    |
| Environment dependencies | [Environment dependencies](/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](/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 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.md?ask=<question>&goal=<endgoal>
```

`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.