> ## Documentation Index
> Fetch the complete documentation index at: https://docs.niuapi.vip/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio 使用指南

> 从零开始，手把手教你安装和配置 Cherry Studio

## 什么是 Cherry Studio

Cherry Studio 是一款桌面端 AI 助手应用，支持多种 AI 模型。它具有：

* 简洁美观的图形界面
* 支持多个 AI 服务商
* 多会话管理
* 本地数据存储
* 跨平台支持（Windows、macOS、Linux）

<Note>
  Cherry Studio 是桌面应用，比命令行工具更适合普通用户使用。
</Note>

***

## 第一步：下载 Cherry Studio

### 1.1 访问官网

访问 [Cherry Studio 官网](https://cherry-ai.com/) 或 [GitHub 发布页](https://github.com/kangfenmao/cherry-studio/releases)

### 1.2 选择对应系统的安装包

根据你的操作系统选择下载：

| 操作系统                      | 文件格式                 | 说明                   |
| ------------------------- | -------------------- | -------------------- |
| **Windows**               | `.exe`               | 双击安装                 |
| **macOS (Intel)**         | `.dmg` (x64)         | 适用于 Intel 芯片的 Mac    |
| **macOS (Apple Silicon)** | `.dmg` (arm64)       | 适用于 M1/M2/M3 芯片的 Mac |
| **Linux**                 | `.AppImage` 或 `.deb` | 根据发行版选择              |

<Tip>
  不确定 Mac 芯片类型？点击左上角苹果图标 → "关于本机"，查看"芯片"或"处理器"信息。
</Tip>

***

## 第二步：安装 Cherry Studio

### Windows 用户

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

### macOS 用户

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

### Linux 用户

**使用 AppImage：**

```bash theme={null}
chmod +x Cherry-Studio-*.AppImage
./Cherry-Studio-*.AppImage
```

**使用 deb 包（Ubuntu/Debian）：**

```bash theme={null}
sudo dpkg -i cherry-studio_*.deb
```

***

## 第三步：在智牛API创建令牌

<Note>
  **好消息：** 智牛API服务部署在国内，访问和使用完全不需要魔法，网络连接稳定快速。
</Note>

### 3.1 登录智牛API

1. 访问 [智牛API](https://niuapi.vip)
2. 注册或登录你的账号

### 3.2 创建新令牌

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

| 配置项      | 说明             | 示例                    |
| -------- | -------------- | --------------------- |
| **令牌名称** | 给这个令牌起个名字，方便识别 | `cherry-studio-token` |
| **额度**   | 设置令牌的使用额度（可选）  | 留空表示无限制               |
| **过期时间** | 令牌的有效期（可选）     | 留空表示永不过期              |
| **模型权限** | 选择允许使用的模型      | 勾选 Claude 相关模型        |

### 3.3 保存并复制令牌

1. 点击"提交"或"创建"按钮
2. 系统会生成一个令牌（格式类似 `sk-xxxxxxxxxxxxx`）
3. **立即复制这个令牌**，它只会显示一次

<Warning>
  令牌创建后只显示一次，请务必复制保存。如果丢失，需要删除旧令牌并重新创建。
</Warning>

***

## 第四步：配置 Cherry Studio

### 4.1 打开 Cherry Studio

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

### 4.2 添加 AI 服务商

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

### 4.3 配置智牛API

在添加服务商页面，填写以下信息：

| 配置项         | 填写内容                       |
| ----------- | -------------------------- |
| **服务商类型**   | 选择"OpenAI"或"自定义 OpenAI 兼容" |
| **服务商名称**   | `智牛API`（可自定义）              |
| **API Key** | 粘贴你在智牛API创建的令牌             |
| **API 地址**  | `https://niuapi.vip/v1`    |

<Tip>
  Cherry Studio 支持 OpenAI 兼容接口，所以选择 OpenAI 类型即可。
</Tip>

### 4.4 测试连接

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

***

## 第五步：开始使用

### 5.1 创建新对话

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

### 5.2 基本功能

| 功能        | 说明               |
| --------- | ---------------- |
| **多会话管理** | 左侧栏显示所有对话，可随时切换  |
| **重命名对话** | 右键点击对话，选择"重命名"   |
| **删除对话**  | 右键点击对话，选择"删除"    |
| **导出对话**  | 右键点击对话，选择"导出"    |
| **切换模型**  | 对话顶部可切换不同的 AI 模型 |

### 5.3 使用示例

**示例 1：简单问答**

```
你：什么是人工智能？
AI：人工智能（AI）是计算机科学的一个分支...
```

**示例 2：代码生成**

```
你：用 Python 写一个计算斐波那契数列的函数
AI：好的，这是一个计算斐波那契数列的函数...
```

**示例 3：文本翻译**

```
你：把这段话翻译成英文：人工智能正在改变世界
AI：Artificial intelligence is changing the world.
```

***

## 常见问题

### 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. 对话时快速调用

### 快捷键

| 快捷键             | 功能   |
| --------------- | ---- |
| `Ctrl/Cmd + N`  | 新建对话 |
| `Ctrl/Cmd + K`  | 搜索对话 |
| `Ctrl/Cmd + ,`  | 打开设置 |
| `Enter`         | 发送消息 |
| `Shift + Enter` | 换行   |

### 主题切换

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

***

## 总结

完成以上步骤后，你就可以开始使用 Cherry Studio 了！

**快速回顾：**

1. ✅ 下载并安装 Cherry Studio
2. ✅ 在智牛API创建令牌
3. ✅ 配置 Cherry Studio
4. ✅ 开始使用

如果遇到问题，可以：

* 查看 [Cherry Studio 官方文档](https://docs.cherry-ai.com)
* 访问 [智牛API](https://niuapi.vip) 检查令牌和配置
* 在社区寻求帮助

<Tip>
  Cherry Studio 会定期更新，建议关注官方发布页获取最新版本。
</Tip>