Cherry Studio 配置教程

Cherry Studio 是一款支持多模型的桌面 AI 客户端，界面简洁、功能丰富。本教程介绍如何在 Cherry Studio 中接入源力AI。

前置条件

• 已下载并安装 Cherry Studio（官网下载）
• 已在源力AI 注册账号并获得 API Key（快速开始）

配置步骤

第一步：打开设置

1. 启动 Cherry Studio
2. 点击左侧底部的 设置图标（齿轮形状）
3. 在设置页面左侧菜单中选择 模型服务

第二步：添加服务商

1. 在模型服务页面，点击 + 添加 或 添加服务商
2. 选择服务类型为 OpenAI 兼容（或 OpenAI Compatible）
3. 填写以下配置信息：

配置项	填写内容
服务商名称	源力AI
API Key	sk-xxxxxxxxxxxxxxxxxxxxxxxx（你的密钥）
API 地址 / Base URL	https://bww.letcareme.com/v1

4. 点击 保存

第三步：添加模型

配置好服务商后，需要添加具体模型：

1. 在 源力AI 服务商下，点击 添加模型
2. 输入模型 ID，从以下常用模型中选择：

gpt-4o
gpt-4o-mini
o1
claude-3-5-sonnet-20241022
claude-3-5-haiku-20241022
gemini-1.5-pro
deepseek-chat
deepseek-reasoner

3. 为每个模型填写显示名称（如 GPT-4o、Claude 3.5 Sonnet）
4. 点击保存

自动获取模型列表

部分版本的 Cherry Studio 支持点击 获取模型列表 按钮自动拉取可用模型，无需手动逐个添加。

第四步：验证连接

1. 在模型服务设置中，找到源力AI 的 API Key 配置行
2. 点击右侧 测试 或 验证 按钮
3. 如显示绿色对勾或"连接成功"，说明配置正确

第五步：开始对话

1. 点击左侧 新建对话
2. 在对话界面右上角或底部，选择模型为你刚刚添加的源力AI 模型
3. 输入消息开始对话

配置截图参考

以下是各配置字段的参考值：

服务商类型:  OpenAI 兼容 (OpenAI Compatible)
服务商名称:  源力AI (YuanForce)
API 端点:   https://bww.letcareme.com/v1
API Key:    sk-xxxxxxxxxxxxxxxxxxxxxxxx

进阶配置

设置系统提示词

在对话设置中可以为不同场景预设系统提示词：

1. 进入 助手 或 角色 设置
2. 点击新建助手
3. 填写助手名称和系统提示词
4. 选择默认使用的源力AI 模型

自定义模型参数

在模型配置或对话设置中可调整：

• Temperature：0.0（精确）~ 1.0（创意），建议日常使用 0.7
• Max Tokens：控制每次回复的最大长度
• Top P：与 Temperature 配合使用

常见问题

Q: 添加模型后无法对话，报错 "model not found"

A: 检查模型 ID 是否完全正确（区分大小写），参考 模型列表 确认 ID 格式。

Q: 连接测试失败，报 401 错误

A: 检查 API Key 是否正确粘贴（无多余空格），API 地址是否为 https://bww.letcareme.com/v1（注意末尾不要加斜杠 /）。

Q: 使用 Claude 模型时返回乱码或格式异常

A: 确认 Cherry Studio 版本支持 OpenAI 兼容模式，尝试升级到最新版本。

Q: 如何切换不同对话使用不同模型

A: 在每个对话窗口的顶部或右侧可以独立选择模型，互不影响。