# Cherry Studio

## Cherry Studio Docs

- [项目简介](https://docs.cherryai.com.cn/cherry-studio/readme.md)
- [下载与安装教程](https://docs.cherryai.com.cn/cherry-studio/installation.md)
- [Windows 安装](https://docs.cherryai.com.cn/cherry-studio/installation/windows.md): Windows 版本安装教程
- [macOS 安装](https://docs.cherryai.com.cn/cherry-studio/installation/macos.md): macOS 版本安装教程
- [Linux](https://docs.cherryai.com.cn/cherry-studio/installation/linux.md): Linux 版本安装教程
- [升级与降级](https://docs.cherryai.com.cn/cherry-studio/installation/upgrade-downgrade.md): 选择版本切换路径，并在操作前保护好 V1 与 V2 数据。
- [破坏性更新提醒](https://docs.cherryai.com.cn/cherry-studio/installation/v2-breaking-update-notice.md): 升级 V2 前必须了解的数据迁移、版本路径和回退限制。
- [功能差异](https://docs.cherryai.com.cn/cherry-studio/installation/v1-v2-feature-differences.md): 对照 V1 与 V2 的主要功能、数据处理方式和升级后复核项。
- [V1 升级到 V2](https://docs.cherryai.com.cn/cherry-studio/installation/v1-to-v2-migration.md): 备份 V1 数据，直接使用 V2.0.2 完成迁移，并检查需要重新配置的项目。
- [V2 降级到 V1](https://docs.cherryai.com.cn/cherry-studio/installation/v2-to-v1-downgrade.md): 返回原 V1 数据，并安全处理 V2 备份、数据库和 Agent 数据。
- [功能介绍](https://docs.cherryai.com.cn/cherry-studio/preview.md)
- [启动台](https://docs.cherryai.com.cn/cherry-studio/preview/launchpad.md)
- [对话-助手](https://docs.cherryai.com.cn/cherry-studio/preview/chat.md)
- [工作-智能体](https://docs.cherryai.com.cn/cherry-studio/preview/agent.md): 让 AI 自主执行任务的智能体
- [绘画](https://docs.cherryai.com.cn/cherry-studio/preview/drawing.md)
- [翻译](https://docs.cherryai.com.cn/cherry-studio/preview/translation.md)
- [小程序](https://docs.cherryai.com.cn/cherry-studio/preview/app.md)
- [知识库](https://docs.cherryai.com.cn/cherry-studio/preview/knowledge-base.md)
- [文件](https://docs.cherryai.com.cn/cherry-studio/preview/files.md)
- [编码搭档](https://docs.cherryai.com.cn/cherry-studio/preview/code-cli.md)
- [笔记](https://docs.cherryai.com.cn/cherry-studio/preview/notes.md)
- [快捷助手](https://docs.cherryai.com.cn/cherry-studio/preview/quick-assistant.md)
- [划词助手](https://docs.cherryai.com.cn/cherry-studio/preview/selection-assistant.md)
- [模型服务](https://docs.cherryai.com.cn/pre-basic/providers.md)
- [全部 Provider 快速参考](https://docs.cherryai.com.cn/pre-basic/providers/quick-reference.md)
- [模型服务设置](https://docs.cherryai.com.cn/pre-basic/providers/providers.md)
- [CherryAI (免费)](https://docs.cherryai.com.cn/pre-basic/providers/cherryai.md)
- [DeepSeek V3.2](https://docs.cherryai.com.cn/pre-basic/providers/cherryai/free-deepseek.md)
- [智谱 GLM-4.6V](https://docs.cherryai.com.cn/pre-basic/providers/cherryai/free-glm46v.md)
- [智谱 GLM-4.5-Air](https://docs.cherryai.com.cn/pre-basic/providers/cherryai/free-glm45air.md)
- [Qwen3-8B](https://docs.cherryai.com.cn/pre-basic/providers/cherryai/free-qwen.md)
- [CherryIN](https://docs.cherryai.com.cn/pre-basic/providers/cherryin-1.md)
- [OpenAI](https://docs.cherryai.com.cn/pre-basic/providers/openai.md)
- [Anthropic](https://docs.cherryai.com.cn/pre-basic/providers/anthropic.md)
- [Azure OpenAI](https://docs.cherryai.com.cn/pre-basic/providers/azure-openai.md)
- [Google Gemini](https://docs.cherryai.com.cn/pre-basic/providers/google-gemini.md)
- [Vertex AI](https://docs.cherryai.com.cn/pre-basic/providers/vertex-ai.md): 暂时不支持Claude模型
- [DeepSeek](https://docs.cherryai.com.cn/pre-basic/providers/deepseek.md)
- [智谱 ZhiPu](https://docs.cherryai.com.cn/pre-basic/providers/zhipu.md)
- [Grok](https://docs.cherryai.com.cn/pre-basic/providers/grok.md)
- [Mistral](https://docs.cherryai.com.cn/pre-basic/providers/mistral.md)
- [Perplexity](https://docs.cherryai.com.cn/pre-basic/providers/perplexity.md)
- [Groq](https://docs.cherryai.com.cn/pre-basic/providers/groq.md)
- [OpenRouter](https://docs.cherryai.com.cn/pre-basic/providers/openrouter.md)
- [Moonshot AI (Kimi)](https://docs.cherryai.com.cn/pre-basic/providers/moonshot.md)
- [MiniMax](https://docs.cherryai.com.cn/pre-basic/providers/minimax.md)
- [NewAPI](https://docs.cherryai.com.cn/pre-basic/providers/newapi.md)
- [OneAPI](https://docs.cherryai.com.cn/pre-basic/providers/oneapi.md)
- [Ollama](https://docs.cherryai.com.cn/pre-basic/providers/ollama.md)
- [LM Studio](https://docs.cherryai.com.cn/pre-basic/providers/lm-studio.md)
- [GitHub Copilot](https://docs.cherryai.com.cn/pre-basic/providers/github-copilot.md)
- [MiniMax Coding Plan](https://docs.cherryai.com.cn/pre-basic/providers/minimax-coding-plan.md)
- [ModelScope（魔搭）](https://docs.cherryai.com.cn/pre-basic/providers/modelscope.md)
- [PPIO 派欧云](https://docs.cherryai.com.cn/pre-basic/providers/ppio.md)
- [阿里云百炼](https://docs.cherryai.com.cn/pre-basic/providers/a-li-yun-bai-lian.md)
- [硅基流动](https://docs.cherryai.com.cn/pre-basic/providers/siliconcloud.md)
- [火山引擎](https://docs.cherryai.com.cn/pre-basic/providers/doubao.md)
- [自定义服务商](https://docs.cherryai.com.cn/pre-basic/providers/zi-ding-yi-fu-wu-shang.md)
- [软件设置](https://docs.cherryai.com.cn/pre-basic/settings.md)
- [默认模型设置](https://docs.cherryai.com.cn/pre-basic/settings/default-models.md)
- [本地模型](https://docs.cherryai.com.cn/pre-basic/settings/local-models.md)
- [联网模式](https://docs.cherryai.com.cn/pre-basic/settings/websearch.md): 如何在 Cherry Studio 使用联网模式
- [免费联网模式](https://docs.cherryai.com.cn/pre-basic/settings/websearch/free-search.md)
- [网络搜索黑名单配置](https://docs.cherryai.com.cn/pre-basic/settings/websearch/blacklist.md)
- [火山引擎接入联网](https://docs.cherryai.com.cn/pre-basic/settings/websearch/volcengine.md): cherry studio使用「火山引擎」接入deepseekR1联网功能，喂饭教程。
- [Tavily 联网登录注册教程](https://docs.cherryai.com.cn/pre-basic/settings/websearch/tavily.md): 如何注册tavily？
- [SearXNG 本地部署与配置](https://docs.cherryai.com.cn/pre-basic/settings/websearch/searxng.md)
- [文档处理](https://docs.cherryai.com.cn/pre-basic/settings/doc-process.md)
- [OCR](https://docs.cherryai.com.cn/pre-basic/settings/ocr.md)
- [外观](https://docs.cherryai.com.cn/pre-basic/settings/display.md)
- [自定义 CSS](https://docs.cherryai.com.cn/pre-basic/settings/display/custom-css.md)
- [字体推荐](https://docs.cherryai.com.cn/pre-basic/settings/display/font.md)
- [清除 CSS 设置](https://docs.cherryai.com.cn/pre-basic/settings/display/clear-css.md)
- [通知](https://docs.cherryai.com.cn/pre-basic/settings/notification.md)
- [数据设置](https://docs.cherryai.com.cn/pre-basic/settings/data-settings.md)
- [WebDAV 备份](https://docs.cherryai.com.cn/pre-basic/settings/data-settings/webdav.md)
- [S3 兼容存储备份](https://docs.cherryai.com.cn/pre-basic/settings/data-settings/s3-compatible.md)
- [Notion 配置教程](https://docs.cherryai.com.cn/pre-basic/settings/data-settings/notion.md)
- [Obsidian 配置教程](https://docs.cherryai.com.cn/pre-basic/settings/data-settings/obsidian.md): 数据设置→Obsidian配置
- [思源笔记配置教程](https://docs.cherryai.com.cn/pre-basic/settings/data-settings/siyuan.md)
- [修改存储位置](https://docs.cherryai.com.cn/pre-basic/settings/data-settings/storage.md)
- [用量统计](https://docs.cherryai.com.cn/pre-basic/settings/usage.md)
- [快捷键设置](https://docs.cherryai.com.cn/pre-basic/settings/key-shortcut.md): 快捷键是提升 AI 交互效率的核心。通过掌握这些组合键，您可以实现“双手不离键盘”的高效操作。
- [系统](https://docs.cherryai.com.cn/pre-basic/settings/general.md)
- [环境依赖](https://docs.cherryai.com.cn/pre-basic/settings/env-dependencies.md)
- [知识库入门](https://docs.cherryai.com.cn/knowledge-base/knowledge-base.md)
- [数据、隐私与维护](https://docs.cherryai.com.cn/knowledge-base/data.md)
- [模型与检索设置](https://docs.cherryai.com.cn/knowledge-base/emb-models-info.md)
- [文档解析与 OCR](https://docs.cherryai.com.cn/knowledge-base/document-preprocessing.md)
- [创建知识库](https://docs.cherryai.com.cn/knowledge-base/create.md)
- [添加与整理资料](https://docs.cherryai.com.cn/knowledge-base/sources.md)
- [检查资料与召回](https://docs.cherryai.com.cn/knowledge-base/recall-test.md)
- [在对话中使用](https://docs.cherryai.com.cn/knowledge-base/chat.md)
- [与 Agent 一起使用](https://docs.cherryai.com.cn/knowledge-base/agent.md)
- [知识库应用案例](https://docs.cherryai.com.cn/knowledge-base/cases.md)
- [常见问题](https://docs.cherryai.com.cn/knowledge-base/troubleshooting.md)
- [进阶能力地图](https://docs.cherryai.com.cn/advanced-basic/capability-map.md): 从目标出发选择当前能力
- [对话进阶](https://docs.cherryai.com.cn/advanced-basic/chat.md): 多模型、分支、长对话与产物
- [多模型对比与消息分支](https://docs.cherryai.com.cn/advanced-basic/chat/model-compare-branches.md)
- [长对话、上下文与排队消息](https://docs.cherryai.com.cn/advanced-basic/chat/context-queue.md)
- [产物、引用与导出](https://docs.cherryai.com.cn/advanced-basic/chat/artifacts-export.md)
- [Agent 工作区](https://docs.cherryai.com.cn/advanced-basic/agent-workspace.md): 从创建到交付的完整工作方式
- [创建 Agent 与模型分工](https://docs.cherryai.com.cn/advanced-basic/agent-workspace/create-agent.md)
- [工作目录、任务与文件](https://docs.cherryai.com.cn/advanced-basic/agent-workspace/workspaces-tasks-files.md)
- [模型分工与 Agent 绘画](https://docs.cherryai.com.cn/advanced-basic/agent-workspace/models-image.md)
- [内置工具、知识库、技能与 MCP](https://docs.cherryai.com.cn/advanced-basic/agent-workspace/tools-knowledge-skills-mcp.md)
- [权限、记忆与后台任务](https://docs.cherryai.com.cn/advanced-basic/agent-workspace/permissions-memory-background.md)
- [知识与内容工作流](https://docs.cherryai.com.cn/advanced-basic/knowledge-content.md): 知识库、笔记、绘画与翻译
- [构建知识库与召回测试](https://docs.cherryai.com.cn/advanced-basic/knowledge-content/knowledge-base.md)
- [笔记、知识库与 Agent](https://docs.cherryai.com.cn/advanced-basic/knowledge-content/notes-knowledge-agent.md)
- [图片生成、编辑与增强](https://docs.cherryai.com.cn/advanced-basic/knowledge-content/painting-workflow.md)
- [文件、图片与长文翻译](https://docs.cherryai.com.cn/advanced-basic/knowledge-content/translation-workflow.md)
- [扩展 Agent 的能力](https://docs.cherryai.com.cn/advanced-basic/extensions.md): 技能、MCP 与能力边界
- [技能与能力库](https://docs.cherryai.com.cn/advanced-basic/extensions/skills.md)
- [MCP 与外部工具](https://docs.cherryai.com.cn/advanced-basic/extensions/mcp.md)
- [MCP 排错](https://docs.cherryai.com.cn/advanced-basic/extensions/mcp/troubleshooting.md)
- [自动化与外部触达](https://docs.cherryai.com.cn/advanced-basic/automation.md): 频道、定时任务、心跳与运行记录
- [频道](https://docs.cherryai.com.cn/advanced-basic/automation/channels.md)
- [定时任务、心跳与运行记录](https://docs.cherryai.com.cn/advanced-basic/automation/scheduled-heartbeat.md)
- [高效工作台](https://docs.cherryai.com.cn/advanced-basic/workbench.md): 多窗口、输入工具与全局搜索
- [多窗口与标签页](https://docs.cherryai.com.cn/advanced-basic/workbench/multi-window-tabs.md)
- [输入工具栏与效率工具](https://docs.cherryai.com.cn/advanced-basic/workbench/composer-efficiency.md)
- [全局搜索](https://docs.cherryai.com.cn/advanced-basic/workbench/global-search.md)
- [开发与诊断](https://docs.cherryai.com.cn/advanced-basic/developer-tools.md): API 网关与调用链诊断
- [API 网关](https://docs.cherryai.com.cn/advanced-basic/developer-tools/api-gateway.md)
- [调用链与开发者模式](https://docs.cherryai.com.cn/advanced-basic/developer-tools/trace.md)
- [应用案例](https://docs.cherryai.com.cn/advanced-basic/cases.md): 把多个能力组合成完整工作流
- [多模型研究复盘](https://docs.cherryai.com.cn/advanced-basic/cases/research-review.md)
- [长文档审阅](https://docs.cherryai.com.cn/advanced-basic/cases/long-document-review.md)
- [Agent 项目文件交付](https://docs.cherryai.com.cn/advanced-basic/cases/project-delivery.md)
- [品牌配图套件](https://docs.cherryai.com.cn/advanced-basic/cases/brand-image-kit.md)
- [私有知识库问答](https://docs.cherryai.com.cn/advanced-basic/cases/private-knowledge-qa.md)
- [笔记生成周报](https://docs.cherryai.com.cn/advanced-basic/cases/notes-weekly-report.md)
- [多语言资料整理](https://docs.cherryai.com.cn/advanced-basic/cases/multilingual-materials.md)
- [频道与定时日报](https://docs.cherryai.com.cn/advanced-basic/cases/automated-daily-report.md)
- [多窗口研究工作台](https://docs.cherryai.com.cn/advanced-basic/cases/multi-window-research.md)
- [贡献代码](https://docs.cherryai.com.cn/contribution/code.md)
- [贡献文档](https://docs.cherryai.com.cn/contribution/docs.md)
- [常见问题](https://docs.cherryai.com.cn/question-contact/questions.md)
- [版本升级与降级](https://docs.cherryai.com.cn/question-contact/version-switching.md): 根据当前版本选择正确的升级、迁移或降级路径。
- [如何高效提问](https://docs.cherryai.com.cn/question-contact/ask.md)
- [AI 基础知识](https://docs.cherryai.com.cn/question-contact/knowledge.md)
- [问题反馈与功能建议](https://docs.cherryai.com.cn/question-contact/suggestions.md)
- [商务合作](https://docs.cherryai.com.cn/about/questions.md)
- [隐私协议](https://docs.cherryai.com.cn/about/privacypolicy.md)
- [Cherry Studio 开源许可协议](https://docs.cherryai.com.cn/about/license.md)
- [模型数据](https://docs.cherryai.com.cn/other/models-info.md)
- [模型榜单](https://docs.cherryai.com.cn/other/model_rank.md)
- [Agent 智能体榜单](https://docs.cherryai.com.cn/other/model_rank/agent.md)
- [文本榜单](https://docs.cherryai.com.cn/other/model_rank/text.md)
- [搜索榜单](https://docs.cherryai.com.cn/other/model_rank/search.md)
- [视觉榜单](https://docs.cherryai.com.cn/other/model_rank/vision.md)
- [代码 / Web 开发榜单](https://docs.cherryai.com.cn/other/model_rank/code-webdev.md)
- [文生图榜单](https://docs.cherryai.com.cn/other/model_rank/text-to-image.md)


---

# 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, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on a page URL with the `ask` query parameter:
```
GET https://docs.cherryai.com.cn/cherry-studio/readme.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.