Skip to main content

什么是 Cherry Studio

Cherry Studio 是一款桌面端 AI 助手应用,支持多种 AI 模型。它具有:
  • 简洁美观的图形界面
  • 支持多个 AI 服务商
  • 多会话管理
  • 本地数据存储
  • 跨平台支持(Windows、macOS、Linux)
Cherry Studio 是桌面应用,比命令行工具更适合普通用户使用。

第一步:下载 Cherry Studio

1.1 访问官网

访问 Cherry Studio 官网GitHub 发布页

1.2 选择对应系统的安装包

根据你的操作系统选择下载:
不确定 Mac 芯片类型?点击左上角苹果图标 → “关于本机”,查看”芯片”或”处理器”信息。

第二步:安装 Cherry Studio

Windows 用户

  1. 双击下载的 .exe 文件
  2. 按照安装向导提示操作
  3. 安装完成后,桌面会出现 Cherry Studio 图标

macOS 用户

  1. 双击下载的 .dmg 文件
  2. 将 Cherry Studio 拖拽到”应用程序”文件夹
  3. 首次打开时,如果提示”无法打开”,按以下步骤操作:
    • 打开”系统设置” → “隐私与安全性”
    • 找到 Cherry Studio,点击”仍要打开”

Linux 用户

使用 AppImage:
使用 deb 包(Ubuntu/Debian):

第三步:在智牛API创建令牌

好消息: 智牛API服务部署在国内,访问和使用完全不需要魔法,网络连接稳定快速。

3.1 登录智牛API

  1. 访问 智牛API
  2. 注册或登录你的账号

3.2 创建新令牌

  1. 在左侧菜单或顶部导航找到”令牌”选项
  2. 点击”添加令牌”或”创建新令牌”按钮
  3. 填写令牌配置信息:

3.3 保存并复制令牌

  1. 点击”提交”或”创建”按钮
  2. 系统会生成一个令牌(格式类似 sk-xxxxxxxxxxxxx
  3. 立即复制这个令牌,它只会显示一次
令牌创建后只显示一次,请务必复制保存。如果丢失,需要删除旧令牌并重新创建。

第四步:配置 Cherry Studio

4.1 打开 Cherry Studio

双击桌面图标或从应用程序列表启动 Cherry Studio。

4.2 添加 AI 服务商

  1. 点击左下角的”设置”图标(齿轮图标)
  2. 在左侧菜单选择”模型服务商”或”Providers”
  3. 点击”添加服务商”或”Add Provider”按钮

4.3 配置智牛API

在添加服务商页面,填写以下信息:
Cherry Studio 支持 OpenAI 兼容接口,所以选择 OpenAI 类型即可。

4.4 测试连接

  1. 填写完成后,点击”测试连接”或”Test”按钮
  2. 如果显示”连接成功”,说明配置正确
  3. 点击”保存”或”Save”按钮

第五步:开始使用

5.1 创建新对话

  1. 点击左上角的”新建对话”或”+“按钮
  2. 选择你想使用的模型(如 Claude 3.5 Sonnet)
  3. 开始输入你的问题

5.2 基本功能

5.3 使用示例

示例 1:简单问答
示例 2:代码生成
示例 3:文本翻译

常见问题

1. 提示 “API Key 无效”

原因: API 密钥错误或已过期 解决方法:
  • 检查是否正确复制了令牌
  • 检查智牛API账户中令牌是否还有额度
  • 重新创建令牌并更新配置

2. 提示 “连接失败”

原因: 无法连接到 API 服务 解决方法:
  • 检查网络连接是否正常
  • 确认 API 地址是否为 https://niuapi.vip/v1
  • 检查智牛API服务是否正常运行

3. 找不到想要的模型

原因: 模型未启用或令牌无权限 解决方法:
  • 检查智牛API中是否启用了对应的模型
  • 检查令牌是否有该模型的使用权限
  • 在 Cherry Studio 设置中刷新模型列表

4. macOS 提示”无法打开应用”

原因: 系统安全设置限制 解决方法:
  • 打开”系统设置” → “隐私与安全性”
  • 找到 Cherry Studio,点击”仍要打开”
  • 或在终端执行:xattr -cr /Applications/Cherry\ Studio.app

5. 对话记录丢失

原因: 数据存储位置变更或损坏 解决方法:
  • Cherry Studio 数据存储在本地
  • 定期导出重要对话
  • 检查应用数据目录是否完整

进阶功能

自定义提示词

  1. 在设置中找到”提示词”或”Prompts”
  2. 可以创建常用的提示词模板
  3. 对话时快速调用

快捷键

主题切换

  1. 打开设置
  2. 选择”外观”或”Appearance”
  3. 切换浅色/深色主题

总结

完成以上步骤后,你就可以开始使用 Cherry Studio 了! 快速回顾:
  1. ✅ 下载并安装 Cherry Studio
  2. ✅ 在智牛API创建令牌
  3. ✅ 配置 Cherry Studio
  4. ✅ 开始使用
如果遇到问题,可以:
Cherry Studio 会定期更新,建议关注官方发布页获取最新版本。