Cherry Studio

Cherry Studio 是一款开源跨平台桌面 AI 对话客户端，支持同时接多个 LLM provider，内置知识库、Artifacts、Agent 等功能。

接入步骤

1. 打开 Cherry Studio → 左下角「设置」（齿轮图标）

2. 「模型服务」→ 找「OpenAI」（或「+ 添加」自定义）

3. 填以下字段：

   字段	值
   API 地址	https://s1.why01.top
   API Key	你的 sk-xxxxxxxx
   （部分版本）路径前缀	/v1/chat/completions（默认即可）

4. 点「检查」按钮 → 显示「连接成功」即通

5. 「模型」标签页 → 「+ 添加」→ 填模型名（如 gpt-5.6-luna / claude-sonnet-4-6 / gemini-3.1-pro-preview，以 控制台模型页 当前列表为准），按需添加多个

添加 Claude / Gemini 模型类型

如果想在 Cherry Studio 里直接调 Claude 或 Gemini 系列模型（不走 OpenAI 兼容路径），在「模型服务 → + 添加」新建 provider 时把**「提供商类型」**选成对应协议：

Claude（Anthropic 协议）

1. 提供商类型选 Anthropic，名称自取（如 why01-claude）
2. API 地址填 https://s1.why01.top（不带 /v1）
3. API 密钥填你的 sk-xxxxxxxx
4. 在「模型」里添加现役 Claude 模型名（以 控制台模型页 为准），点「检测」验证

Gemini（Google 协议）

1. 提供商类型选 Gemini，名称自取（如 why01-gemini）
2. API 地址填 https://s1.why01.top
3. API 密钥填你的 sk-xxxxxxxx
4. 添加现役 Gemini 模型名（以控制台为准）后「检测」验证

切模型

主对话窗口顶部模型下拉框 → 选刚才添加的模型。一个对话可以中途换模型（接续上下文）。

多 provider 共存

Cherry Studio 支持同时配置多个 provider。建议把 why01 命名清晰，比如把这个 provider 命名为 why01-中转，方便和你可能有的 Ollama / 其他 provider 区分。

常见问题

「连接失败」/ 显示 401

• 检查 Key 拼写（前后空格、漏字符）
• 确认 Key 在控制台「令牌管理」是「已启用」状态、未过期
• 重新创建一个 Key 替换试试

添加模型后调用 404

• 模型名拼写错（注意大小写、版本后缀），按 控制台模型页 实际可用名填
• 你所在用户组没有该模型权限，联系客服询问

如何用流式输出

Cherry Studio 默认开启流式。无需特殊配置。

推荐打开的功能

• 「多模态」开关（如果你的模型支持视觉）
• 「温度」按场景调（写代码 0.3，写文案 0.7-1.0）
• 「最大 token」按需求设上限，避免单次回答太长多烧 token