====== Cherry Studio 安装配置指南 ======

本教程教你如何在 Cherry Studio 中配置本站的 API，实现模型调用。

----

===== 第一部分：安装 Cherry Studio =====

==== 下载地址 ====

  * [[https://cherry-ai.com/|Cherry Studio 官网]]
  * [[https://github.com/CherryHQ/cherry-studio/releases|GitHub Releases 下载]]

支持 Windows、macOS、Linux 三平台。下载对应系统的安装包，安装即可。

----

===== 第二部分：配置 API =====

==== 准备工作 ====

你需要一个本站的 API Key。在 [[https://huanyuf.top/|本站控制台]] 的令牌页面创建 API Key（以 ''sk-'' 开头）。

==== 配置步骤 ====

=== 第一步：进入模型服务商设置 ===

打开 Cherry Studio，点击左侧边栏的 **设置图标（齿轮）**，找到 **模型服务** 或点击顶部的 **服务商管理**。

点击 **+** 添加一个新的服务商，名称可以填 ''huanyu'' 或任意你喜欢的名字。

=== 第二步：填写 API 密钥 ===

在 **API 密钥** 输入框中，填入你的 API Key：

<code>
sk-xxxxxxxxxxxxxxxxxxxxxxxx
</code>

多个密钥使用逗号分隔。填完后可以点击 **检测** 按钮验证密钥是否有效。

=== 第三步：填写 API 地址 ===

在 **API 地址** 输入框中，填入：

<code>
https://api.huanyuf.top
</code>

预览地址会自动显示为：''https://api.huanyuf.top/v1/chat/completions''

=== 第四步：获取模型列表 ===

点击 **获取模型列表** 按钮，Cherry Studio 会自动从 API 拉取所有可用模型。

获取成功后，你会看到模型按分类显示，例如：

^ 分类 ^ 模型 ^
| claude-opus | ''claude-opus-4-6-thinking'' |
| claude-sonnet | ''claude-sonnet-4-6-thinking'' |
| gemini | ''gemini-3.1-pro''、''gemini-3-flash'' |

=== 第五步：开启服务商 ===

确保服务商右上角的 **开关** 处于 **ON** 状态（绿色），这样该服务商的模型才会在对话中可用。

----

===== 第三部分：开始使用 =====

配置完成后，回到聊天界面：

  - 点击模型选择下拉框
  - 选择你刚配置的服务商下的模型
  - 开始对话

----

===== 常见问题 =====

**Q: 点击"检测"提示失败？**

A: 请检查：
  * API 密钥是否正确（以 ''sk-'' 开头）
  * API 地址是否填写正确：''https://api.huanyuf.top''
  * 网络是否能访问该地址

----

**Q: 获取模型列表为空？**

A: 请确认：
  * API 地址末尾不要加 ''/v1'' 或 ''/v1/chat/completions''，Cherry Studio 会自动补全
  * API 密钥有效且有权限

----

**Q: 对话时提示 timeout？**

A: 思考模型响应较慢，可以在设置中调大超时时间，建议设为 300 秒以上。

----

**Q: 如何切换不同模型？**

A: 在聊天界面顶部的模型选择框中直接切换即可，无需重新配置。

----

===== 官方资源 =====

  * [[https://cherry-ai.com/|Cherry Studio 官网]]
  * [[https://docs.cherry-ai.com/|Cherry Studio 官方文档]]
  * [[https://github.com/CherryHQ/cherry-studio|Cherry Studio GitHub]]
  * [[https://huanyuf.top/|本站 API 控制台（令牌页面）]]