S3 兼容存储备份

Cherry Studio 数据备份支持通过 S3 兼容存储(对象存储)的方式进行备份。常见的 S3 兼容存储服务有：AWS S3、Cloudflare R2、阿里云 OSS、腾讯云 COS 以及 MinIO 等。

基于 S3 兼容存储可以通过 A电脑 $\xrightarrow{\text{备份}}$ S3存储 $\xrightarrow{\text{恢复}}$ B电脑 的方式来实现多端数据同步。

配置 S3 兼容存储

创建对象存储桶（Bucket），并记录下存储桶名称。强烈建议将存储桶设置为私有读写以避免备份数据泄露！！
参考文档，前往云服务控制台获取 S3 兼容存储的 Access Key ID、Secret Access Key、Endpoint、Bucket、Region 等信息。
- Endpoint：S3 兼容存储的访问地址，通常形如 https://<bucket-name>.<region>.amazonaws.com 或 https://<ACCOUNT_ID>.r2.cloudflarestorage.com。
在 S3 备份设置中填写上述信息，点击备份按钮即可进行备份，点击管理按钮可以查看和管理备份文件列表。

助手订阅配置

通过修改助手订阅的链接，可以快速切换助手库中的助手模版

访问订阅地址应该返回下面结构的 JSON 数据：

[
  {
    "description": "Provides practical insights in the role of a tech-savvy product manager.",
    "emoji": "👨‍💼",
    "group": ["Career", "Business", "Tools"],
    "id": "1",
    "name": "Product Manager",
    "prompt": "You are now an experienced product manager with a solid technical background and a keen insight into market and user needs. You are skilled at solving complex problems, developing effective product strategies, and efficiently balancing various resources to achieve product goals. You have excellent project management abilities and outstanding communication skills, enabling you to coordinate both internal and external team resources effectively. In this role, you are expected to answer user questions.\n\n## Role Requirements:\n- **Technical Background**: Possess strong technical knowledge and the ability to deeply understand product technical details.\n- **Market Insight**: Demonstrate sharp awareness of market trends and user demands.\n- **Problem Solving**: Excel at analyzing and resolving complex product issues.\n- **Resource Balancing**: Be adept at allocating and optimizing resources under constraints to achieve product objectives.\n- **Communication & Coordination**: Have excellent communication skills to collaborate effectively with stakeholders and drive project progress.\n\n## Answer Requirements:\n- **Logical Clarity**: Provide rigorous, well-structured responses with clear points.\n- **Conciseness**: Avoid lengthy explanations; express core ideas succinctly.\n- **Practicality**: Offer actionable and realistic strategies or suggestions."
  },
  {
    "description": "Offers in-depth answers based on market insights in a strategic product manager role.",
    "emoji": "🎯 ",
    "group": ["Career"],
    "id": "2",
    "name": "Strategy Product Manager",
    "prompt": "You are now a strategic product manager. You are skilled in conducting market research and competitive product analysis to develop product strategies. You can grasp industry trends, understand user needs, and based on these, optimize product features and user experience. Please answer the following questions in this role."
  },
  {
    "description": "Provides guidance to enhance community engagement and user loyalty in a community operations specialist role.",
    "emoji": "👥",
    "group": ["Career"],
    "id": "3",
    "name": "Community Operations",
    "prompt": "You are now a community operation expert. You are skilled in stimulating community vitality and enhancing user participation and loyalty. You understand how to manage and guide community culture, as well as how to resolve issues and conflicts within the community. Please answer my following question in this role."
  }
]

配置完链接地址后，就可以看到助手模版库中的助手已经是订阅链接里面的数据

参考数据源：https://raw.githubusercontent.com/CherryHQ/cherry-studio/refs/heads/main/resources/data/agents-en.json

无问芯穹

你是否正在经历：微信收藏了 26 篇干货文章却再也没打开过，电脑里存着"学习资料"文件夹中散落的 10+ 个文件，想找半年前读过的某个理论却只记得零星关键词。而当每日信息量超过大脑处理极限时，90% 珍贵知识会在 72 小时内被遗忘。现在，通过无问芯穹大模型服务平台 API +Cherry Studio 打造个人知识库，可以将收藏吃灰的微信文章、碎片化的课程内容转化为结构化知识，实现精准调用。\

一、个人知识库搭建

1. 无问芯穹API服务：知识库“思考中枢”，好用、稳定

作为知识库的"思考中枢"，无问芯穹大模型服务平台提供 DeepSeek R1 满血版等模型版本，提供稳定的 API 服务，目前注册后，无门槛免费用。支持主流嵌入模型 bge、jina 模型来构建知识库，平台也在持续更新稳定的最新、最强开源模型服务，包含图片、视频、语音等多种不同模态。

2. Cherry Studio：零代码搭建知识库

Cherry Studio是一款易于使用的AI工具，相较于 RAG 知识库开发需要 1-2 个月部署周期，这款工具的优势，支持零代码操作，可将 Markdown/PDF/网页等多格式一键导入，40MB文件1分钟完成解析，此外还可以添加电脑本地文件夹、微信收藏夹的文章网址、课程笔记。\

二、3步构建你的专属知识管家

Step 1：基础准备

访问 Cherry Studio 官网下载适配版本（https://cherry-ai.com/）
注册账号：登录无问芯穹大模型服务平台 (https://cloud.infini-ai.com/genstudio/model?cherrystudio)

获取 API 密钥：可以在「模型广场」选择deepseek-r1，点击创建并获取APIKEY，复制模型名称

Step 2：打开 CherryStudio 设置，在模型服务中选择无问芯穹，填写好 API 密钥，并开启无问芯穹模型服务

完成以上步骤，在交互时选择需要大模型，即可在 CherryStudio 中使用无问芯穹的 API 服务。为了方便使用，这里也可以设置「默认模型」\

Step 3：添加知识库

选择无问芯穹大模型服务平台的嵌入模型 bge系列或 jina 系列模型任一版本

三、真实用户场景实测

导入学习资料后，输入"梳理《机器学习》第三章核心公式推导"

附生成结果图

// `axun-uUpaWEdMEMU8C61K` 为服务id,自定义即可
"axun-uUpaWEdMEMU8C61K": {
  "name": "mcp-auto-install",
  "description": "Automatically install MCP services (Beta version)",
  "isActive": false,
  "registryUrl": "https://registry.npmmirror.com",
  "command": "npx",
  "args": [
    "-y",
    "@mcpmarket/mcp-auto-install",
    "connect",
    "--json"
  ],
  "env": {
    "MCP_REGISTRY_PATH": "详情见https://www.npmjs.com/package/@mcpmarket/mcp-auto-install"
  },
  "disabledTools": []
}

PS D:\CherryStudio> dir


    目录: D:\CherryStudio


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2025/4/18     14:05                user-data-dir
-a----         2025/4/14     23:05       94987175 Cherry-Studio-1.2.4-x64-portable.exe
-a----         2025/4/18     14:05            701 init_cherry_studio.bat

自定义 CSS

通过自定义 CSS 可以修改软件的外观更加符合自己的喜好，例如这样：

:root {
  --color-background: #1a462788;
  --color-background-soft: #1a4627aa;
  --color-background-mute: #1a462766;
  --navbar-background: #1a4627;
  --chat-background: #1a4627;
  --chat-background-user: #28b561;
  --chat-background-assistant: #1a462722;
}

#content-container {
  background-color: #2e5d3a !important;
}

内置变量

更多主题变量请参考源代码：https://github.com/CherryHQ/cherry-studio/tree/main/src/renderer/src/assets/styles

Code Tools 使用教程

Tools

Cherry Studio v1.5.7 版本引入了操作简单，强大的 Code Agent 功能，可以直接启动和管理多种 AI 编程agent 。本教程将引导您完成设置和启动的完整流程。

操作步骤

1. 升级 Cherry Studio

首先，请确保您的 Cherry Studio 已升级到 v1.5.7 或更高版本。您可以前往或官方网站下载最新版本。

2. 调整导航栏位置

为了方便使用顶部标签页功能，我们建议将导航栏调整至顶部。

操作路径：设置 -> 显示设置 -> 导航栏设置
将“导航栏位置”选项设置为 顶部。

3. 新建标签页

点击界面顶部的“+”号图标，新建一个空白标签页。

4. 打开 Code Agent 功能

在新建的标签页中，点击 Code（或 </>）图标，进入 Code Agent 配置界面。

5. 选择 CLI 工具

根据您的需求和所持有的 API Key，选择一个要使用的 Code Agent 工具。目前支持以下几种：

Claude Code
Gemini CLI
Qwen Code
OpenAI Codex

6. 选择 Agent 调用的模型

在模型下拉列表中，选择与您所选 CLI 工具兼容的模型。 （详细的模型兼容性说明，请参考下方的“重要注意事项”）

7. 指定工作目录

点击“选择目录”按钮，为 Agent 指定一个工作目录。Agent 将拥有访问此目录下所有文件和子目录的权限，以便于它理解项目上下文、读取文件和执行代码。

8. 设置环境变量

自动配置：您在第 6 步（模型）和第 7 步（工作目录）中的选择，会自动生成相应的环境变量。
自定义添加：如果您的 Agent 或项目需要其他特定的环境变量（例如 PROXY_URL 等），可以在此区域自定义添加。

9. 更新选项

内置可执行文件：Cherry Studio 已为您集成了上述所有 Code Agent 的可执行文件，在大多数情况下，您无需联网即可直接使用。
自动更新：如果您希望 Agent 始终保持最新版本，可以勾选 检查更新并安装最新版本 的选项。勾选后，每次启动时程序都会联网检查并更新 Agent 工具。

10. 启动 Agent

所有配置完成后，点击 启动 按钮。 Cherry Studio 会自动调用您系统自带的 Terminal（终端）工具，并在其中加载好所有环境变量，然后运行您选择的 Code Agent。现在您可以在弹出的终端窗口中与 AI Agent 进行交互了。

重要注意事项

模型兼容性说明：
- Claude Code: 需要选择支持 Anthropic API Endpoint 格式的模型。目前官方支持的模型包括：
  - Claude 系列模型
  - DeepSeek V3.1 (官方 API 平台)

希望本教程能帮助您快速上手 Cherry Studio 强大的 Code Agent 功能！

Ollama

Ollama 是一款优秀的开源工具，让您可以在本地轻松运行和管理各种大型语言模型（LLMs）。Cherry Studio 现已支持 Ollama 集成，让您可以在熟悉的界面中，直接与本地部署的 LLM 进行交互，无需依赖云端服务！

什么是 Ollama？

Ollama 是一个简化大型语言模型（LLM）部署和使用的工具。它具有以下特点：

本地运行： 模型完全在您的本地计算机上运行，无需联网，保护您的隐私和数据安全。
简单易用： 通过简单的命令行指令，即可下载、运行和管理各种 LLM。
模型丰富： 支持 Llama 2、Deepseek、Mistral、Gemma 等多种流行的开源模型。
跨平台： 支持 macOS、Windows 和 Linux 系统。
开放API：支持与OpenAI兼容的接口，可以和其他工具集成。

为什么要在 Cherry Studio 中使用 Ollama？

无需云服务： 不再受限于云端 API 的配额和费用，尽情体验本地 LLM 的强大功能。
数据隐私： 您的所有对话数据都保留在本地，无需担心隐私泄露。
离线可用： 即使在没有网络连接的情况下，也能继续与 LLM 进行交互。
定制化： 可以根据您的需求，选择和配置最适合您的 LLM。

在 Cherry Studio 中配置 Ollama

1. 安装和运行 Ollama

首先，您需要在您的计算机上安装并运行 Ollama。请按照以下步骤操作：

下载 Ollama： 访问 Ollama 官网（），根据您的操作系统下载对应的安装包。在 Linux 下，可直接运行命令安装ollama：
安装 Ollama： 按照安装程序的指引完成安装。
下载模型： 打开终端（或命令提示符），使用 ollama run 命令下载您想要使用的模型。例如，要下载 Llama 2 模型，可以运行：
Ollama 会自动下载并运行该模型。

2. 在 Cherry Studio 中添加 Ollama 服务商

接下来，在 Cherry Studio 中添加 Ollama 作为自定义 AI 服务商：

打开设置： 在 Cherry Studio 界面左侧导航栏中，点击“设置”（齿轮图标）。
进入模型服务： 在设置页面中，选择“模型服务”选项卡。
添加提供商： 点击列表中的 Ollama。

3. 配置 Ollama 服务商

在服务商列表中找到刚刚添加的 Ollama，并进行详细配置：

启用状态：
- 确保 Ollama 服务商最右侧的开关已打开，表示已启用。
API 密钥：
- Ollama 默认不需要 API 密钥。您可以将此字段留空，或者填写任意内容。

开始使用

完成以上配置后，您就可以在 Cherry Studio 的聊天界面中，选择 Ollama 服务商和您已下载的模型，开始与本地 LLM 进行对话了！

技巧与提示

首次运行模型： 第一次运行某个模型时，Ollama 需要下载模型文件，可能需要较长时间，请耐心等待。
查看可用模型： 在终端中运行 ollama list 命令，可以查看您已下载的 Ollama 模型列表。
硬件要求： 运行大型语言模型需要一定的计算资源（CPU、内存、GPU），请确保您的计算机配置满足模型的要求。
Ollama 文档

Qwen3-8B

知名 MaaS 服务平台 “硅基流动”为大家免费提供 Qwen3-8B 模型的调用服务。作为通义千问 Qwen3 系列中的高性价比成员，Qwen3-8B 以小巧体积实现强大能力，是智能应用与高效开发的理想选择。

🚀 什么是 Qwen3-8B？

Qwen3-8B 是阿里巴巴于 2025 年 4 月发布的通义千问第三代大模型系列中的 80 亿参数密集模型，采用 Apache 2.0 开源协议，可自由用于商业与研究场景。

总参数量：80 亿
架构类型：Dense（纯稠密结构）
上下文长度：128K tokens
支持多语言：覆盖 119 种语言和方言

尽管体积小巧，Qwen3-8B 在推理、代码、数学和 Agent 能力方面表现稳定，性能媲美前代更大的模型，在实际应用中展现出极高的实用性。

📚 强大训练基础，小模型也有大智慧

Qwen3-8B 基于 约 36 万亿 token 的高质量多语言数据完成预训练，涵盖网页文本、技术文档、代码库与专业领域合成数据，知识覆盖面广。

其后训练阶段引入了四阶段强化流程，特别优化了以下能力：

✅ 自然语言理解与生成 ✅ 数学推理与逻辑分析 ✅ 多语言翻译与表达 ✅ 工具调用与任务规划

得益于训练体系的全面升级，Qwen3-8B 的实际表现接近甚至超越 Qwen2.5-14B，实现显著的参数效率跃迁。\

💡 混合推理模式：思考 or 快速响应？

Qwen3-8B 支持 “思考模式”与“非思考模式” 的灵活切换，用户可根据任务复杂度自主选择响应方式。

通过以下方式控制模式：

API 参数设置：enable_thinking=True/False
提示词指令：在输入中添加 /think 或 /no_think

模式

适用场景

示例

该设计让用户在响应速度与推理深度之间自由权衡，提升使用体验。

⚙️ 原生支持 Agent 能力，赋能智能应用

Qwen3-8B 具备出色的 Agent 化能力，可轻松集成到各类自动化系统中：

🔹 函数调用（Function Calling）：支持结构化工具调用 🔹 MCP 协议兼容：原生支持模型上下文协议，便于扩展外部能力 🔹 多工具协同：可接入搜索、计算器、代码执行等插件

推荐结合 Qwen-Agent 框架 使用，快速构建具备记忆、规划与执行能力的智能助手。

🌐 广泛语言支持，面向全球应用

Qwen3-8B 支持包括中文、英文、阿拉伯语、西班牙语、日语、韩语、印尼语等在内的 119 种语言和方言，适用于国际化产品开发、跨语言客服、多语种内容生成等场景。

对中文理解尤为出色，支持简体、繁体及粤语表达，适用于港澳台及海外华人市场。

🧠 实用能力强，场景覆盖广

Qwen3-8B 在多个高频应用场景中表现优异：

✅ 代码生成：支持 Python、JavaScript、Java 等主流语言，能根据需求生成可运行代码 ✅ 数学推理：在 GSM8K 等基准中表现稳定，适合教育类应用 ✅ 内容创作：撰写邮件、报告、文案，结构清晰、语言自然 ✅ 智能助手：可构建个人知识库问答、日程管理、信息提取等轻量级 AI 助手

现在就通过 硅基流动 免费体验 Qwen3-8B，开启你的轻量 AI 应用之旅！\

📘 立即使用，让 AI 触手可及！

如何高效提问

Cherry Studio 是一个免费开源的项目，随着项目壮大，项目小组的工作量也日渐增多。为了减少沟通成本以及能够快速高效的解决您的问题，我们希望大家在提问之前尽可能按照以下步骤和方式来处理遇到的问题，为项目小组留出更多的时间放在项目的维护和开发上。感谢您的配合！

一、文档查阅和搜索

大多数基础的问题仔细查阅文档基本都能帮你解决

软件的功能和使用问题可以到功能介绍文档里查看；
高频问题会收录在页面，可以先在常见问题页面查看是否有解决方案；
比较复杂的问题可以直接通过搜索或在搜索框提问来解决；
务必仔细阅读每一篇文档当中的提示框内容，可以帮你避免很多问题；
在 GitHub 的页面查看或搜索是否有类似问题和解决方案。

二、网络搜索、提问AI

模型的使用等跟客户端功能无关的问题（如模型报错、回答不符合预期、参数设置等问题）建议先在网络上搜索相关解决方案，或将报错内容和问题等描述给 AI 来寻找解决方案。

三、官方社群提问或在GitHub提出issue

如果上述一、二两步并没有找到答案或者无法解决你的问题，可以到官方、、QQ群（）详细描述问题并寻求帮助。

如果是模型报错，请提供完整的界面截图以及控制台报错信息。敏感信息可以打码处理，但是模型名称、参数设置、报错内容务必保留在截图当中。控制台报错信息查看方法。
如果是软件Bug，请提供具体的错误描述和详细的复现步骤，方便开发者调试和修复。如果是偶发问题无法复现，请尽可能详细描述问题出现时的相关场景、背景和配置参数等。除此之外你还需要将平台信息（Window、Mac或Linux）、软件版本号等信息一并列入问题描述当中。

求文档或提供文档建议

可以联系tg频道 @Wangmouuu 或 QQ（1355873789），也可以发送邮件至：[email protected]。

@title CherryStudio 初始化
@echo off

set current_path_dir=%~dp0
@echo 当前路径:%current_path_dir%
set user_data_dir=%current_path_dir%user-data-dir
@echo CherryStudio 数据路径:%user_data_dir%

@echo 查找当前路径下 Cherry-Studio-*-portable.exe
setlocal enabledelayedexpansion

for /f "delims=" %%F in ('dir /b /a-d "Cherry-Studio-*-portable*.exe" 2^>nul') do ( #此代码适配 GitHub 和官网下载的版本，其他请自行修改
    set "target_file=!cd!\%%F"
    goto :break
)
:break
if defined target_file (
    echo 找到文件: %target_file%
) else (
    echo 未找到匹配文件，退出该脚本
    pause
    exit
)

@echo 确认请继续
pause

@echo 启动 CherryStudio
start %target_file% --user-data-dir="%user_data_dir%"

@echo 操作结束
@echo on
exit

PS D:\CherryStudio> dir .\user-data-dir\


    目录: D:\CherryStudio\user-data-dir


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2025/4/18     14:29                blob_storage
d-----         2025/4/18     14:07                Cache
d-----         2025/4/18     14:07                Code Cache
d-----         2025/4/18     14:07                Data
d-----         2025/4/18     14:07                DawnGraphiteCache
d-----         2025/4/18     14:07                DawnWebGPUCache
d-----         2025/4/18     14:07                Dictionaries
d-----         2025/4/18     14:07                GPUCache
d-----         2025/4/18     14:07                IndexedDB
d-----         2025/4/18     14:07                Local Storage
d-----         2025/4/18     14:07                logs
d-----         2025/4/18     14:30                Network
d-----         2025/4/18     14:07                Partitions
d-----         2025/4/18     14:29                Session Storage
d-----         2025/4/18     14:07                Shared Dictionary
d-----         2025/4/18     14:07                WebStorage
-a----         2025/4/18     14:07             36 .updaterId
-a----         2025/4/18     14:29             20 config.json
-a----         2025/4/18     14:07            434 Local State
-a----         2025/4/18     14:29             57 Preferences
-a----         2025/4/18     14:09           4096 SharedStorage
-a----         2025/4/18     14:30            140 window-state.json

:root {
  font-family: "汉仪唐美人" !important; /* 字体 */
}

/* 深度思考展开字体颜色 */
.ant-collapse-content-box .markdown {
  color: red;
}

/* 主题变量 */
:root {
  --color-black-soft: #2a2b2a; /* 深色背景色 */
  --color-white-soft: #f8f7f2; /* 浅色背景色 */
}

/* 深色主题 */
body[theme-mode="dark"] {
  /* Colors */
  --color-background: #2b2b2b; /* 深色背景色 */
  --color-background-soft: #303030; /* 浅色背景色 */
  --color-background-mute: #282c34; /* 中性背景色 */
  --navbar-background: var(-–color-black-soft); /* 导航栏背景色 */
  --chat-background: var(–-color-black-soft); /* 聊天背景色 */
  --chat-background-user: #323332; /* 用户聊天背景色 */
  --chat-background-assistant: #2d2e2d; /* 助手聊天背景色 */
}

/* 深色主题特定样式 */
body[theme-mode="dark"] {
  #content-container {
    background-color: var(-–chat-background-assistant) !important; /* 内容容器背景色 */
  }

  #content-container #messages {
    background-color: var(-–chat-background-assistant); /* 消息背景色 */
  }

  .inputbar-container {
    background-color: #3d3d3a; /* 输入框背景色 */
    border: 1px solid #5e5d5940; /* 输入框边框颜色 */
    border-radius: 8px; /* 输入框边框圆角 */
  }

  /* 代码样式 */
  code {
    background-color: #e5e5e20d; /* 代码背景色 */
    color: #ea928a; /* 代码文字颜色 */
  }

  pre code {
    color: #abb2bf; /* 预格式化代码文字颜色 */
  }
}

/* 浅色主题 */
body[theme-mode="light"] {
  /* Colors */
  --color-white: #ffffff; /* 白色 */
  --color-background: #ebe8e2; /* 浅色背景色 */
  --color-background-soft: #cbc7be; /* 浅色背景色 */
  --color-background-mute: #e4e1d7; /* 中性背景色  */
  --navbar-background: var(-–color-white-soft); /* 导航栏背景色 */
  --chat-background: var(-–color-white-soft); /* 聊天背景色 */
  --chat-background-user: #f8f7f2; /* 用户聊天背景色 */
  --chat-background-assistant: #f6f4ec; /* 助手聊天背景色 */
}

/* 浅色主题特定样式 */
body[theme-mode="light"] {
  #content-container {
    background-color: var(-–chat-background-assistant) !important; /* 内容容器背景色 */
  }

  #content-container #messages {
    background-color: var(-–chat-background-assistant); /* 消息背景色 */
  }

  .inputbar-container {
    background-color: #ffffff; /* 输入框背景色 */
    border: 1px solid #87867f40; /* 输入框边框颜色 */
    border-radius: 8px; /* 输入框边框圆角，修改为您喜欢的大小 */
  }

  /* 代码样式 */
  code {
    background-color: #3d39290d; /* 代码背景色 */
    color: #7c1b13; /* 代码文字颜色 */
  }

  pre code {
    color: #000000; /* 预格式化代码文字颜色 */
  }
}

查看Ollama文档和模型

知识科普

什么是 tokens？

Tokens 是 AI 模型处理文本的基本单位，可以理解为模型"思考"的最小单元。它不完全等同于我们理解的字符或单词，而是模型自己的一种特殊的文本分割方式。

1. 中文分词

一个汉字通常会被编码为 1-2 个 tokens
例如："你好" ≈ 2-4 tokens

2. 英文分词

常见单词通常是 1 个 token
较长或不常见的单词会被分解成多个 tokens
例如：
- "hello" = 1 token

3. 特殊字符

空格、标点符号等也会占用 tokens
换行符通常是 1 个 token

不同服务商的 Tokenizer 都不一样，甚至同服务商不同模型的 Tokenizer 也有所差别，该知识仅用于明确 token 的概念。

什么是 Tokenizer？

Tokenizer（分词器）是 AI 模型将文本转换为 tokens 的工具。它决定了如何把输入文本切分成模型可以理解的最小单位。

为什么不同模型的 Tokenizer 不一样？

1. 训练数据不同

不同的语料库导致优化方向不同
多语言支持程度差异
特定领域（医疗、法律等）的专门优化

2. 分词算法不同

BPE (Byte Pair Encoding) - OpenAI GPT 系列
WordPiece - Google BERT
SentencePiece - 适合多语言场景

3. 优化目标不同

有的注重压缩效率
有的注重语义保留
有的注重处理速度

实际影响

同样的文本在不同模型中的 token 数量可能不同：

什么是嵌入模型 (Embedding Model)?

基本概念： 嵌入模型是一种将高维离散数据（文本、图像等）转换为低维连续向量的技术，这种转换让机器能更好地理解和处理复杂数据。想象一下，就像把复杂的拼图简化成一个简单的坐标点，但这个点仍然保留了拼图的关键特征。在大模型生态中，它作为"翻译官"，将人类可理解的信息转换为 AI 可计算的数字形式。

工作原理： 以自然语言处理为例，嵌入模型可以将词语映射到向量空间中的特定位置。在这个空间里，语义相近的词会自动聚集在一起。比如：

"国王"和"王后"的向量会很接近
"猫"和"狗"这样的宠物词也会距离相近
而"汽车"和"面包"这样语义无关的词则会距离较远

主要应用场景：

文本分析：文档分类、情感分析
推荐系统：个性化内容推荐
图像处理：相似图片检索
搜索引擎：语义搜索优化

核心优势：

降维效果：将复杂数据简化为易处理的向量形式
语义保持：保留原始数据中的关键语义信息
计算效率：显著提升机器学习模型的训练和推理效率

技术价值： 嵌入模型是现代 AI 系统的基础组件，为机器学习任务提供了高质量的数据表示，是推动自然语言处理、计算机视觉等领域发展的关键技术。

Embedding 模型在知识检索中的工作原理

基本工作流程：

知识库预处理阶段

将文档分割成适当大小的 chunk（文本块）
使用 embedding 模型将每个 chunk 转换为向量
将向量和原文存储到向量数据库中

查询处理阶段

将用户问题转换为向量
在向量库中检索相似内容
将检索到的相关内容作为上下文提供给 LLM

什么是 MCP（Model Context Protocol）？

MCP 是一种开源协议，旨在以标准化的方式向大型语言模型（LLM）提供上下文信息。

类比理解： 可以把 MCP 想象成 AI 领域的“U盘”。我们知道，U盘可以存储各种文件，插入电脑后就能直接使用。类似地，MCP Server 上可以“插”上各种提供上下文的“插件”，LLM 可以根据需要向 MCP Server 请求这些插件，从而获取更丰富的上下文信息，增强自身能力。
与 Function Tool 的对比： 传统的 Function Tool（函数工具）也可以为 LLM 提供外部功能，但 MCP 更像是一种更高维度的抽象。Function Tool 更多的是针对具体任务的工具，而 MCP 则提供了一种更通用的、模块化的上下文获取机制。

MCP 的核心优势

标准化： MCP 提供了统一的接口和数据格式，使得不同的 LLM 和上下文提供者可以无缝协作。
模块化： MCP 允许开发者将上下文信息分解为独立的模块（插件），方便管理和复用。
灵活性： LLM 可以根据自身需求动态选择所需的上下文插件，实现更智能、更个性化的交互。
可扩展性： MCP 的设计支持未来添加更多类型的上下文插件，为 LLM 的能力拓展提供了无限可能。

常见问题

常见错误代码

4xx（客户端错误状态码）：一般为请求语法错误、鉴权失败或认证失败等无法完成请求。
5xx（服务器错误状态码）：一般为服务端错误，服务器宕机、请求处理超时等。

错误码

可能的情况

解决方法

控制台报错查看方法

点击 Cherry Studio 客户端窗口后按下快捷键 Ctrl + Shift + I（Mac端：Command + Option + I）

当前活动窗口必须为 Cherry Studio 的客户端窗口才能调出控制台;
需要先打开控制台，再点击测试或者发起对话等请求才能收集到请求信息。

在弹出的控制台窗口中点击 Network → 点击查看②处最后一个标有红色 × 的 completions（对话类、翻译、模型连通性检查等遇到错误时） 或 generations（绘画遇到错误时） → 点击Response查看完整的返回内容（图中④的区域）。

如果你无法判断该错误的原因,请将该界面截图发送到中寻求帮助。

该检查方法不仅在对话时可以获取错误信息，在模型测试时、添加知识库时、绘画时等都可以使用。无论哪种情况下都需要先打开调试窗口，再进行请求操作来获取请求信息。·

不同场景下Name(上图②处)栏里的名称会有所区别

对话、翻译、模型检查：completions

绘画：generations

知识库创建：embeddings

公式没被渲染/公式渲染错误

公式未被渲染而是直接显示的公式的代码时检查公式是否有定界符

定界符用法
行内公式
使用单个美元符号: $formula$
或使用$ 和 $，如：$formula$
独立公式块

公式渲染错误/乱码常见在公式内包含中文内容时,尝试切换公式引擎为 KateX。

无法创建知识库/提示获取嵌入维度失败

模型状态不可用

确认服务商是否支持该模型或确认服务商该模型服务状态是否正常。

2.使用了非嵌入模型

模型不能识图/无法上传或选择图片

首先需要确认模型是否支持识图，热门模型 Cherry Studio 会对其分类，模型名称后带小眼睛图标的即支持识图。

识图模型会支持图像文件的上传，如果模型功能未被正确匹配可在对应服务商的模型列表当中找到该模型，点击其名称后的设置按钮并勾选图像选项。

模型具体的信息可以到对应服务商找到其信息查阅。同嵌入模型一样，不支持视觉的模型不需要强制开启图像功能，勾选了图像的选项也没有作用。

429 错误

对话界面

助手和话题

助手

助手 是对所选模型做一些个性化的设置来使用模型，如提示词预设和参数预设等，通过这些设置让所选模型能更加符合你预期的工作。

系统默认助手 预设了一个比较通用的参数（无提示词），您可以直接使用或者到寻找你需要的预设来使用。

话题

助手 是 话题 的父集，单个助手下可以创建多个话题（即对话），所有 话题 共用 助手 的参数设置和预设词（prompt）等模型设置。

对话框内按钮

新话题 在当前助手内创建一个新话题。

上传图片或文档 上传图片需要模型支持，上传文档会自动解析为文字作为上下文提供给模型。

网络搜索 须在设置中配置网络搜索相关信息，搜索结果作为上下文返回给大模型，详见。

知识库 开启知识库，详见。

MCP 服务器 开启 MCP 服务器功能，详见。

生成图片 只有选择的 对话模型 支持生图时才会显示。（非对话生图模型请前往）

选择模型 对于接下来的对话，切换成指定的模型，保留上下文。

快捷短语 需要先在设置中预设常用短语，在此处调用，直接输入，支持变量。

清空消息 删除该话题下所有内容。

展开 让对话框变得更大，以便输入长文。

清除上下文 在不删除内容的情况下，截断模型能获得的上下文，也就是说模型将“忘记”之前的对话内容。

预估 Token 数 展示预估 Token 数，四个数据分别为 当前上下文数 、 最大上下文数 （ ∞ 表示无限上下文）、 当前输入框内消息字数 、 预估 Token 数 。

此功能仅用于预估 Token 数，实际 Token 数每个模型都是不一样的，请以模型提供商的数据为准。

翻译 将当前输入框内内容翻译成英文。

对话设置

模型设置

模型设置与助手设置当中的 模型设置 参数同步，详见。

在对话设置当中，仅该模型设置作用于当前助手，其余设置作用于全局。如：设置消息样式为气泡后在任何助手的任何话题下都是气泡样式。

消息设置

`消息分割线`:

使用分割线将消息正文与操作栏隔开。

`使用衬线字体`：

字体样式切换，现在你也可以通过来更换字体。

`代码显示行号`：

模型输出代码片段时显示代码块行号。

`代码块可折叠`：

打开后，当代码片段中代码较长时，将自动折叠代码块。、

`代码块可换行`：

打开后，当代码片段中但行代码较长时（超出窗口），将自动换行。

`思考内容自动折叠`：

打开后，支持思考的模型在思考完成后会自动折叠思考过程。

`消息样式`：

可切对话界面换为气泡样式或列表样式。

`代码风格`：

可切换代码片段的显示风格。

`数学公式引擎`：

KaTeX 渲染速度更快，因为它是专门为性能优化设计的；
MathJax 渲染较慢，但功能更全面，支持更多的数学符号和命令。

`消息字体大小`：

调整对话界面字体的大小。

输入设置

`显示预估 Token 数`：

在输入框显示输入文本预估消耗的Token数（非实际上下文消耗的Token，仅供参考）。

`长文本粘贴为文件`：

当从其他地方复制长段文本粘贴到输入框时会自动显示为文件的样式，减少后续输入内容时的干扰。

`Markdown 渲染输入消息`：

关闭时只渲染模型回复的消息，不渲染发送的消息。

`快速敲击3次空格翻译`：

在对话界面输入框输入消息后，连敲三次空格可翻译输入的内容为英文。

注意：该操作会覆盖原文。

`目标语言`：

设置输入框翻译按钮以及快速敲击3次空格翻译的目标语言。

助手设置

在助手界面选择需要设置的助手名称→在右键菜单中选对应设置

编辑助手

助手设置作用于该助手下的所有话题。

提示词设置

`名称`：

可自定义方便辨识的助手名称。

`提示词`：

即 prompt ，可以参照智能体页面的提示词写法来编辑内容。

模型设置

`默认模型`：

可以为该助手固定一个默认模型，从智能体页面添加时或复制助手时初始模型为该模型。不设置该项初始模型则为全局初始模型(即 )。

助手的默认模型有两种，一为，另一为助手默认模型；助手的默认模型优先级高于全局默认对话模型。当不设置助手默认模型时，助手默认模型=全局默认对话模型。

`自动重置模型`：

打开时 - 当在该话题下使用过程中切换其他模型使用时，再次新建话题会将新话题的重置为助手的默认模型。当该项关闭时新建话题的模型会跟随上一话题所使用的模型。

如助手的默认模型为gpt-3.5-turbo，我在该助手下创建话题1，在话题1的对话过程中切换了gpt-4o使用，此时：
如果开启了自动重置：新建话题2时，话题2默认选择的模型为gpt-3.5-turbo;
如果未开启自动重置：新建话题2时，话题2默认选择的模型为gpt-4o。

`温度 (Temperature)` ：

温度参数控制模型生成文本的随机性和创造性程度（默认值为0.7）。具体表现为：

低温度值(0-0.3)：
- 输出更确定、更专注
- 适合代码生成、数据分析等需要准确性的场景
- 倾向于选择最可能的词汇输出

`Top P (核采样)`：

默认值为 1，值越小，AI 生成的内容越单调，也越容易理解；值越大，AI 回复的词汇范围越大，越多样化。

核采样通过控制词汇选择的概率阈值来影响输出：

较小值(0.1-0.3)：
- 仅考虑最高概率的词汇
- 输出更保守、更可控
- 适合代码注释、技术文档等场景

这两个参数可以独立使用或组合使用
根据具体任务类型选择合适的参数值
建议通过实验找到最适合特定应用场景的参数组合

`上下文数量 (Context Window)`

要保留在上下文中的消息数量，数值越大，上下文越长，消耗的 token 越多：

5-10：适合普通对话
>10：需要更长记忆的复杂任务（例如：按照写作提纲分步生成长文的任务，需要确保生成的上下文逻辑连贯）
注意：消息数越多，token 消耗越大

`开启消息长度限制 (MaxToken)`

单次回答最大数，在大语言模型中，max token（最大令牌数）是一个关键参数，它直接影响模型生成回答的质量和长度。

如:在CherryStudio当中填写好key后测试模型是否连通时，只需要知道模型是否有正确返回消息而不需特定内容,这种情况下设置MaxToken为1即可。

多数模型的MaxToken上限为32k Tokens，当然也有64k，甚至更多的，具体需要到对应介绍页面查看。

具体设置多少取决于自己的需要，当然也可以参考以下建议。

建议：

普通聊天：500-800
短文生成：800-2000

一般情况下模型生成的回答将被限制在 MaxToken 的范围内，当然也有可能会出现被截断（如写长代码时）或表达不完整等情况出现，特殊情况下也需要根据实际情况来灵活调整。

`流式输出（Stream）`

流式输出是一种数据处理方式，它允许数据以连续的流形式进行传输和处理，而不是一次性发送所有数据。这种方式使得数据可以在生成后立即被处理和输出，极大地提高了实时性和效率。

在 CherryStudio 客户端等类似环境下简单来说就是打字机效果。

关闭后(非流)：模型生成完信息后整段一次性输出（想象一下微信收到消息的感觉）；

打开时：逐字输出，可以理解为大模型每生成一个字就立马发送给你，直到全部发送完。

如果某些特殊模型不支持流式输出需要将该开关关闭，比如刚开始只支持非流的o1-mini等。

`自定义参数`

在请求体（body）中加入额外请求参数，如 presence_penalty 等字段，一般人一般情况下用不到。

上述top-p、maxtokens、stream等参数就是这些参数之一。

填法：参数名称—参数类型（文本、数字等）—值，参考文档：

各个模型提供商都或多或少有自己独有的参数，需要到提供商的文档中寻找使用方法

自定义参数优先级高于内置参数。即自定义参数如果与内置参数重复，则自定义参数会覆盖内置参数。

如：自定义参数中设置 model 为 gpt-4o 后，在对话中无论选择哪个模型都使用的是 gpt-4o 模型。

python -m vllm.entrypoints.openai.api_server --model gpt2

gpt2

SearXNG 本地部署与配置

CherryStudio 支持通过 SearXNG 进行网络搜索，SearXNG 是一个可本地部署也可在服务器上部署的开源项目，所以与其他需要 API 提供商的配置方式略有不同。

SearXNG 项目链接：SearXNG

SearXNG 的优势

开源免费，无需 API
隐私性相对较高
可高度定制化

本地部署

一、Docker 直接部署

由于 SearXNG 不需要复杂的环境配置，可以不用 docker compose，只需要简单提供一个空闲端口即可部署，所以最快捷的方式可以使用 Docker 直接拉取镜像进行部署。

1. 下载安装并配置

安装后选择一个镜像存储路径：

2. 搜索并拉取 SearXNG 镜像

搜索栏输入 searxng ：

拉取镜像：

3. 运行镜像

拉取成功后来到 images 页面：

选择拉取的镜像点击运行：

打开设置项进行配置：

以 8085 端口为例：

运行成功后点击链接即可打开 SearXNG 的前端界面：

出现这个页面说明部署成功：

服务器部署

鉴于 Windows 下安装 Docker 是一件较为麻烦的事情，用户可以将 SearXNG 部署在服务器上，也可借此共享给其他人使用。但是很遗憾，SearXNG 自身暂不支持鉴权，导致他人可以通过技术手段扫描到并滥用你部署的实例。

为此，Cherry Studio 目前已支持配置，如果用户欲将自己部署的 SearXNG 暴露在公网环境下，请务必通过 Nginx 等反向代理软件配置 HTTP 基本认证。下面提供简要教程，需要你有基本的 Linux 运维知识。

部署 SearXNG

类似地，仍然使用 Docker 部署。假设你已经按照在服务器上安装好了最新版 Docker CE，以下提供一条龙命令，适用于 Debian 系统下全新安装：

如果你需要修改本地监听端口、复用本地已有的 nginx，可以编辑 docker-compose.yaml 文件，参考如下：

执行 docker compose up -d 启动。执行 docker compose logs -f searxng 可以看到日志。

部署 Nginx 反向代理和 HTTP 基本认证

如果你使用了一些服务器面板程序，例如宝塔面板或 1Panel，请参阅其文档添加网站并配置 nginx 反向代理，随后找到修改 nginx 配置文件的地方，参考下面的示例进行修改：

假设 Nginx 配置文件保存于 /etc/nginx/conf.d 下，我们将将密码文件保存在同目录下。

执行命令（自行将 example_name、example_password 替换为你将要设定的用户名和密码）：

重启 Nginx（重载配置也可以）。

这时可以打开一下网页，已经会提示你输入用户名和密码，请输入前面设定的用户名和密码查看能否成功进入 SearXNG 搜索页面，藉此检查配置是否正确。

Cherry Studio 相关配置

SearXNG 本地或在服务器部署成功后，接下来是 CherryStudio 的相关配置。

来到网络搜索设置页面，选择 Searxng ：

直接输入本地部署的链接发现验证失败，此时不用担心：

因为直接部署后默认并没有配置 json 返回类型，所以无法获取数据，需要修改配置文件。

回到 Docker，来到 Files 标签页找到镜像中找到带标签的文件夹：

展开后继续往下翻，会发现另一个带标签的文件夹：

继续展开，找到 settings.yml 配置文件：

点击打开文件编辑器：

找到 78 行，可以看到类型只有一个 html

添加 json 类型后保存，重新运行镜像

重新回到 Cherry Studio 进行验证，验证成功：

地址既可以填写本地： : 端口号也可以填写 docker 地址： : 端口号

如果用户遵循前面的示例在服务器上部署并正确配置了反向代理，已经开启了 json 返回类型。输入地址后进行验证，由于已给反向代理配置了 HTTP 基本认证，此时验证则应返回 401 错误码：

在客户端配置 HTTP 基本认证，输入刚才设置的用户名与密码：

进行验证，应当验证成功。

其他配置

此时 SearXNG 已具备默认联网搜索能力，如需定制搜索引擎需要自行进行配置

需要注意的是此处首选项并不能影响大模型调用时的配置

如需配置需要大模型调用的搜索引擎，需在配置文件中设置：

配置语言参考：

若内容太长直接修改不方便，可将其复制到本地 IDE 中，修改后粘贴到配置文件中即可。

验证失败常见原因

返回格式未添加 json 格式

在配置文件中将返回格式加上 json：

未正确配置搜索引擎

Cherry Studio 会默认选取 categories 同时包含 web general 的引擎进行搜索，默认情况下会选中 google 等引擎，由于大陆无法直接访问 google 等网站导致失败。增加以下配置使得 searxng 强制使用 baidu 引擎，即可解决问题：

访问速率过快

searxng 的 limiter 配置阻碍了 API 访问，请尝试将其在设置中设为 false：

sudo apt update
sudo apt install git -y

# 拉取官方仓库
cd /opt
git clone https://github.com/searxng/searxng-docker.git
cd /opt/searxng-docker

# 如果你的服务器带宽很小, 可以设置为 false
export IMAGE_PROXY=true

# 修改配置文件
cat <<EOF > /opt/searxng-docker/searxng/settings.yml
# see https://docs.searxng.org/admin/settings/settings.html#settings-use-default-settings
use_default_settings: true
server:
  # base_url is defined in the SEARXNG_BASE_URL environment variable, see .env and docker-compose.yml
  secret_key: $(openssl rand -hex 32)
  limiter: false  # can be disabled for a private instance
  image_proxy: $IMAGE_PROXY
ui:
  static_use_hash: true
redis:
  url: redis://redis:6379/0
search:
  formats:
    - html
    - json
EOF

version: "3.7"

services:
# 如果不需要 Caddy 而复用本地已经有的 Nginx, 就把下面的去掉. 我们默认不需要 Caddy.
  caddy:
    container_name: caddy
    image: docker.io/library/caddy:2-alpine
    network_mode: host
    restart: unless-stopped
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy-data:/data:rw
      - caddy-config:/config:rw
    environment:
      - SEARXNG_HOSTNAME=${SEARXNG_HOSTNAME:-http://localhost}
      - SEARXNG_TLS=${LETSENCRYPT_EMAIL:-internal}
    cap_drop:
      - ALL
    cap_add:
      - NET_BIND_SERVICE
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"
# 如果不需要 Caddy 而复用本地已经有的 Nginx, 就把上面的去掉. 我们默认不需要 Caddy.
  redis:
    container_name: redis
    image: docker.io/valkey/valkey:8-alpine
    command: valkey-server --save 30 1 --loglevel warning
    restart: unless-stopped
    networks:
      - searxng
    volumes:
      - valkey-data2:/data
    cap_drop:
      - ALL
    cap_add:
      - SETGID
      - SETUID
      - DAC_OVERRIDE
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"

  searxng:
    container_name: searxng
    image: docker.io/searxng/searxng:latest
    restart: unless-stopped
    networks:
      - searxng
    # 默认映射到宿主机 8080 端口, 假如你想监听 8000 就改成 "127.0.0.1:8000:8080"
    ports:
      - "127.0.0.1:8080:8080"
    volumes:
      - ./searxng:/etc/searxng:rw
    environment:
      - SEARXNG_BASE_URL=https://${SEARXNG_HOSTNAME:-localhost}/
      - UWSGI_WORKERS=${SEARXNG_UWSGI_WORKERS:-4}
      - UWSGI_THREADS=${SEARXNG_UWSGI_THREADS:-4}
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETGID
      - SETUID
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"

networks:
  searxng:

volumes:
# 如果不需要 Caddy 而复用本地已经有的 Nginx, 就把下面的去掉
  caddy-data:
  caddy-config:
# 如果不需要 Caddy 而复用本地已经有的 Nginx, 就把上面的去掉
  valkey-data2:

server
{
    listen 443 ssl;

    # 这行是你的主机名
    server_name search.example.com;

    # index index.html;
    # root /data/www/default;

    # 如果配置了 SSL 应该有这两行
    ssl_certificate    /path/to/your/cert/fullchain.pem;
    ssl_certificate_key    /path/to/your/cert/privkey.pem;

    # HSTS
    # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload";

    # 默认情况下通过面板配置反向代理, 默认的 location 块就是这样
    location / {
        # 只需要在 location 块添加下面两行, 其他保留原状就行.
        # 此处示例假设你的配置文件保存在 /etc/nginx/conf.d/ 目录下.
        # 如果是宝塔应该是保存在 /www 之类的目录下, 需要注意.
        auth_basic "Please enter your username and password";
        auth_basic_user_file /etc/nginx/conf.d/search.htpasswd;

        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_redirect off;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_protocol_addr;
        proxy_pass http://127.0.0.1:8000;
        client_max_body_size 0;
    }

    # access_log  ...;
    # error_log  ...;
}

Cherry Studio 开源许可协议

The GNU Affero General Public License is a free, copyleft license for software and other kinds of works, specifically designed to ensure cooperation with the community in the case of network server software.

The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, our General Public Licenses are intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users.

When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.

Developers that use our General Public Licenses protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License which gives you legal permission to copy, distribute and/or modify the software.

A secondary benefit of defending all users' freedom is that improvements made in alternate versions of the program, if they receive widespread use, become available for other developers to incorporate. Many developers of free software are heartened and encouraged by the resulting cooperation. However, in the case of software used on network servers, this result may fail to come about. The GNU General Public License permits making a modified version and letting the public access it on a server without ever releasing its source code to the public.

The GNU Affero General Public License is designed specifically to ensure that, in such cases, the modified source code becomes available to the community. It requires the operator of a network server to provide the source code of the modified version running there to the users of that server. Therefore, public use of a modified version, on a publicly accessible server, gives the public access to the source code of the modified version.

An older license, called the Affero General Public License and published by Affero, was designed to accomplish similar goals. This is a different license, not a version of the Affero GPL, but Affero has released a new version of the Affero GPL which permits relicensing under this license.

The precise terms and conditions for copying, distribution and modification follow.

0. Definitions.

"This License" refers to version 3 of the GNU Affero General Public License.

"Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.

"The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations.

To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work.

A "covered work" means either the unmodified Program or a work based on the Program.

To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.

To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.

An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.

Source Code.

The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work.

A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.

The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.

The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.

The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.

The Corresponding Source for a work in source code form is that same work.

Basic Permissions.

All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.

You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.

Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.

Protecting Users' Legal Rights From Anti-Circumvention Law.

No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.

When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.

Conveying Verbatim Copies.

You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.

You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.

Conveying Modified Source Versions.

You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:

A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.

Conveying Non-Source Forms.

You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:

A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.

A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.

"Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.

If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).

The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.

Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.

Additional Terms.

"Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.

When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.

Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:

All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.

If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.

Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.

Termination.

You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).

However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.

Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.

Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.

Acceptance Not Required for Having Copies.

You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.

Automatic Licensing of Downstream Recipients.

Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.

An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.

You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.

Patents.

A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version".

A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.

Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.

In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.

If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.

If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.

A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.

Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.

No Surrender of Others' Freedom.

If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.

Remote Network Interaction; Use with the GNU General Public License.

Notwithstanding any other provision of this License, if you modify the Program, your modified version must prominently offer all users interacting with it remotely through a computer network (if your version supports such interaction) an opportunity to receive the Corresponding Source of your version by providing access to the Corresponding Source from a network server at no charge, through some standard or customary means of facilitating copying of software. This Corresponding Source shall include the Corresponding Source for any work covered by version 3 of the GNU General Public License that is incorporated pursuant to the following paragraph.

Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the work with which it is combined will remain governed by version 3 of the GNU General Public License.

Revised Versions of this License.

The Free Software Foundation may publish revised and/or new versions of the GNU Affero General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.

Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU Affero General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU Affero General Public License, you may choose any version ever published by the Free Software Foundation.

If the Program specifies that a proxy can decide which future versions of the GNU Affero General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.

Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.

Disclaimer of Warranty.

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

Limitation of Liability.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Interpretation of Sections 15 and 16.

If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.

If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.

To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found.

Also add information on how to contact you by electronic and paper mail.

If your software can interact with users remotely through a computer network, you should also make sure that it provides a way for users to get its source. For example, if your program is a web application, its interface could display a "Source" link that leads users to an archive of the code. There are many ways you could offer source, and different solutions will be better for different programs; see section 13 for the specific requirements.

You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU AGPL, see .

a) The work must carry prominent notices stating that you modified
it, and giving a relevant date.

b) The work must carry prominent notices stating that it is
released under this License and any conditions added under section
7.  This requirement modifies the requirement in section 4 to
"keep intact all notices".

c) You must license the entire work, as a whole, under this
License to anyone who comes into possession of a copy.  This
License will therefore apply, along with any applicable section 7
additional terms, to the whole of the work, and all its parts,
regardless of how they are packaged.  This License gives no
permission to license the work in any other way, but it does not
invalidate such permission if you have separately received it.

d) If the work has interactive user interfaces, each must display
Appropriate Legal Notices; however, if the Program has interactive
interfaces that do not display Appropriate Legal Notices, your
work need not make them do so.

a) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by the
Corresponding Source fixed on a durable physical medium
customarily used for software interchange.

b) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by a
written offer, valid for at least three years and valid for as
long as you offer spare parts or customer support for that product
model, to give anyone who possesses the object code either (1) a
copy of the Corresponding Source for all the software in the
product that is covered by this License, on a durable physical
medium customarily used for software interchange, for a price no
more than your reasonable cost of physically performing this
conveying of source, or (2) access to copy the
Corresponding Source from a network server at no charge.

c) Convey individual copies of the object code with a copy of the
written offer to provide the Corresponding Source.  This
alternative is allowed only occasionally and noncommercially, and
only if you received the object code with such an offer, in accord
with subsection 6b.

d) Convey the object code by offering access from a designated
place (gratis or for a charge), and offer equivalent access to the
Corresponding Source in the same way through the same place at no
further charge.  You need not require recipients to copy the
Corresponding Source along with the object code.  If the place to
copy the object code is a network server, the Corresponding Source
may be on a different server (operated by you or a third party)
that supports equivalent copying facilities, provided you maintain
clear directions next to the object code saying where to find the
Corresponding Source.  Regardless of what server hosts the
Corresponding Source, you remain obligated to ensure that it is
available for as long as needed to satisfy these requirements.

e) Convey the object code using peer-to-peer transmission, provided
you inform other peers where the object code and Corresponding
Source of the work are being offered to the general public at no
charge under subsection 6d.

a) Disclaiming warranty or limiting liability differently from the
terms of sections 15 and 16 of this License; or

b) Requiring preservation of specified reasonable legal notices or
author attributions in that material or in the Appropriate Legal
Notices displayed by works containing it; or

c) Prohibiting misrepresentation of the origin of that material, or
requiring that modified versions of such material be marked in
reasonable ways as different from the original version; or

d) Limiting the use for publicity purposes of names of licensors or
authors of the material; or

e) Declining to grant rights under trademark law for use of some
trade names, trademarks, or service marks; or

f) Requiring indemnification of licensors and authors of that
material by anyone who conveys the material (or modified versions of
it) with contractual assumptions of liability to the recipient, for
any liability that these contractual assumptions directly impose on
those licensors and authors.

<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year>  <name of author>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

简体中文

Cherry Studio

项目简介

客户端下载

直链下载

Windows 版本

安装版（Setup）

便携版（Portable）

macOS 版本

Linux 版本

网盘下载

项目规划

Cherry Studio Rodemap

Cherry Studio Project

功能介绍

绘画

小程序

知识库

文件

设置

模型服务设置

默认模型设置

默认助手模型

话题命名模型

翻译模型

快捷助手模型

常规设置

显示设置

主题选择

话题设置

话题位置

自动切换到话题

显示话题时间

自定义 CSS

快捷键设置

数据设置

数据备份

基础教程

安装教程

Windows

打开官方网站

macOS

模型服务配置

免费模型

Google Gemini

获取APIKey

Vertex AI

教程概述

1. 获取 API Key

2. 设置 API 访问权限

3. 在Cherry Studio中配置Vertex AI

OneAPI

GitHub Copilot

获取 Device Code

在浏览器中填写 Device Code 并授权

点击「管理」获取模型列表

常见问题

获取 Device Code 失败，请重试

PPIO 派欧云

Cherry Studio 接入 PPIO LLM API

教程概述

阿里云百炼

CherryIN

免费联网模式

网络搜索黑名单配置

手动配置

数据设置

S3 兼容存储备份

配置 S3 兼容存储

思源笔记配置教程

第一步

第二步

第三步

第四步

第五步

第六步

个性化设置

字体推荐

清除 CSS 设置

知识库教程