shihao
3afad1525c
- 删除已废弃的 skills 页面（ikuncode-aimcp, ikunimage） - 删除售后页面并清理所有引用 - 修复 nano-banana.md 中 /skills/oneimage 死链接 - 修复 opencode.md 中损坏的图片路径 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
282 lines
8.7 KiB
Markdown
282 lines
8.7 KiB
Markdown
# CherryStudio 配置指南
|
||
|
||
**全能的 AI 助手桌面客户端**
|
||
|
||
| 资源 | 地址 |
|
||
|------|------|
|
||
| 官方网站 | [cherry-ai.com](https://www.cherry-ai.com/) |
|
||
| 下载地址 | [cherry-ai.com/download](https://www.cherry-ai.com/download) |
|
||
| oneinAI 控制台 | [api.oneinai.com/console/token](https://api.oneinai.com/console/token) |
|
||
|
||
## 📋 简介
|
||
|
||
CherryStudio 是一款功能强大的 AI 助手桌面应用，支持 Claude、Gemini、GPT 等主流 AI 模型，为开发者和用户提供统一的 AI 交互界面。本教程将指导你如何配置 CherryStudio 接入 **oneinAI** 平台。
|
||
|
||
## ✨ 功能特点
|
||
|
||
- ✅ **多模型支持**：Claude、Gemini、GPT 等主流 AI 模型
|
||
- ✅ **统一界面**：一个应用管理所有 AI 服务
|
||
- ✅ **自定义 API**：支持接入自定义 API 提供商
|
||
- ✅ **跨平台**：支持 Windows、macOS、Linux
|
||
- ✅ **本地优先**：数据存储在本地，保护隐私
|
||
- ✅ **丰富功能**：对话管理、模型切换、参数调整等
|
||
|
||
## 📋 配置快速参考
|
||
|
||
| 模型 | 提供商类型 | API 地址 | 令牌组 |
|
||
|------|-----------|---------|--------|
|
||
| Claude | `Anthropic` | `https://api.oneinai.com` | Claude 分组 |
|
||
| Gemini | `Gemini` | `https://api.oneinai.com/v1beta/models` | Gemini 分组 |
|
||
|
||
---
|
||
|
||
## 🛠️ 安装步骤
|
||
|
||
### 第一步：下载安装 CherryStudio
|
||
|
||
1. 访问 [CherryStudio 下载页面](https://www.cherry-ai.com/download)
|
||
2. 根据你的操作系统选择对应的安装包：
|
||
- **Windows**：下载 `.exe` 安装程序
|
||
- **macOS**：下载 `.dmg` 镜像文件
|
||
- **Linux**：下载 `.AppImage` 或 `.deb` 包
|
||
3. 下载完成后，按照系统提示完成安装
|
||
|
||
> 💡 **macOS 用户注意**
|
||
> 如果提示"无法打开，因为它来自身份不明的开发者"，请在系统偏好设置 → 安全性与隐私中允许打开。
|
||
|
||
### 第二步：获取 oneinAI API Key
|
||
|
||
在配置 CherryStudio 之前，需要先从 oneinAI 平台获取 API Key：
|
||
|
||
1. 访问 [oneinAI 控制台](https://api.oneinai.com/console/token)
|
||
2. 登录你的账户
|
||
3. 根据需要创建对应的令牌组：
|
||
- **Claude 模型**：选择 Claude 分组
|
||
- **Gemini 模型**：选择 Gemini 分组
|
||
4. 保存生成的 API Key（请妥善保管，不要泄露）
|
||
|
||
|
||
|
||
> ⚠️ Claude 和 Gemini 的 API Key 必须使用**不同的令牌组**，两者不能通用。
|
||
|
||
---
|
||
|
||
## 🔧 配置 Claude 模型
|
||
|
||
### 第一步：进入设置页面
|
||
|
||
1. 打开 CherryStudio 应用
|
||
2. 点击左下角的「设置」或「偏好设置」
|
||
3. 选择「模型配置」或「API 配置」选项
|
||
|
||
### 第二步：选择 Claude 模型类型
|
||
|
||
|
||
|
||
在模型列表中选择你需要的 Claude 模型。
|
||
|
||
### 第三步：配置 Claude API
|
||
|
||
在 Claude 配置界面中填写以下信息：
|
||
|
||
|
||
|
||
**配置参数：**
|
||
|
||
| 字段 | 填写内容 |
|
||
|------|---------|
|
||
| 提供商类型 | `Anthropic` |
|
||
| API 地址 | `https://api.oneinai.com` |
|
||
| API Key | 从 [oneinAI 控制台](https://api.oneinai.com/console/token) 获取的 Claude API Key |
|
||
| 模型名称 | 例如 `claude-sonnet-4-6`、`claude-opus-4-5-20251101` |
|
||
|
||
---
|
||
|
||
## 🔧 配置 Gemini 模型
|
||
|
||
### 第一步：选择 Gemini 模型类型
|
||
|
||
|
||
|
||
在模型列表中选择你需要的 Gemini 模型：
|
||
|
||
- **Gemini 3 Flash Preview**：`gemini-3-flash-preview` — 最新版本，速度快，性能优秀（推荐）
|
||
- **Gemini 3 Pro Preview**：`gemini-3-pro-preview` — 高性能，适合复杂任务
|
||
- **Gemini 2.0 Flash**：快速响应，适合简单对话
|
||
|
||
### 第二步：配置 Gemini API
|
||
|
||
在 Gemini 配置界面中填写以下信息：
|
||
|
||
|
||
|
||
**配置参数：**
|
||
|
||
| 字段 | 填写内容 |
|
||
|------|---------|
|
||
| 提供商类型 | `Gemini` |
|
||
| API 地址 | `https://api.oneinai.com/v1beta/models` |
|
||
| API Key | 从 [oneinAI 控制台](https://api.oneinai.com/console/token) 获取的 Gemini API Key |
|
||
| 模型名称 | 例如 `gemini-3-flash-preview` |
|
||
|
||
> ⚠️ **注意**：Gemini 和 Claude 需要使用不同的 API Key（不同的令牌组），确保你在 oneinAI 平台已创建对应的令牌组。
|
||
|
||
---
|
||
|
||
## 💬 开始使用
|
||
|
||
### 创建新对话
|
||
|
||
1. 点击「新建对话」或「New Chat」按钮
|
||
2. 在模型选择器中选择已配置的模型
|
||
3. 开始与 AI 对话
|
||
|
||
### 切换模型
|
||
|
||
在对话过程中，你可以随时切换不同的模型：
|
||
|
||
1. 点击顶部的模型选择器
|
||
2. 选择其他已配置的模型
|
||
3. 继续对话（上下文可能会保留或重置，取决于应用设置）
|
||
|
||
### 调整参数
|
||
|
||
CherryStudio 通常支持调整以下参数：
|
||
|
||
- **Temperature**（温度）：控制回复的随机性（0-1）
|
||
- **Max Tokens**（最大令牌数）：控制回复长度
|
||
- **Top P**：控制采样范围
|
||
|
||
> 💡 **参数建议**
|
||
> - 编程任务：Temperature `0.2-0.5`（更准确）
|
||
> - 创意写作：Temperature `0.7-0.9`（更有创意）
|
||
> - 日常对话：Temperature `0.5-0.7`（平衡）
|
||
|
||
---
|
||
|
||
## 🎯 最佳实践
|
||
|
||
### 1. 合理选择模型
|
||
|
||
不同任务使用不同模型：
|
||
|
||
| 任务类型 | 推荐模型 | 模型标识 |
|
||
|---------|---------|---------|
|
||
| 代码编写 | Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929` |
|
||
| 快速对话 | Gemini 3 Flash Preview | `gemini-3-flash-preview` |
|
||
| 复杂推理 | Claude Opus 4.5 | `claude-opus-4-5-20251101` |
|
||
| 多模态（图片） | Gemini 3 Pro Preview | `gemini-3-pro-preview` |
|
||
|
||
### 2. 管理 API 使用
|
||
|
||
- 定期检查 [oneinAI 控制台](https://api.oneinai.com/console/token) 的余额
|
||
- 为不同用途创建不同的 API Key，便于管理和审计
|
||
- 避免在公共场合或代码仓库中泄露 API Key
|
||
|
||
### 3. 优化对话体验
|
||
|
||
- 使用清晰、具体的提示词
|
||
- 合理设置上下文长度，避免过长影响响应速度
|
||
- 善用对话历史管理功能，及时归档或清理
|
||
|
||
---
|
||
|
||
## 🔍 与其他客户端的对比
|
||
|
||
| 特性 | CherryStudio | Alma | Hapi |
|
||
|------|:------------:|:----:|:----:|
|
||
| 界面类型 | 桌面应用 | 桌面应用 | Web/PWA |
|
||
| 多模型支持 | ✅ | ✅ | ✅ |
|
||
| 代码编辑 | 部分支持 | ✅ | ✅ |
|
||
| 终端集成 | ❌ | ✅ | ✅ |
|
||
| 远程访问 | ❌ | ❌ | ✅ |
|
||
| 学习曲线 | 低 | 中 | 中 |
|
||
|
||
**选择建议：**
|
||
|
||
- **纯对话需求**：CherryStudio（界面简洁，易上手）
|
||
- **编程开发**：Alma 或 Hapi（功能更强大）
|
||
- **远程控制**：Hapi（独有功能）
|
||
|
||
---
|
||
|
||
## ❓ 常见问题
|
||
|
||
### 提示 API Key 无效？
|
||
|
||
**可能原因：**
|
||
|
||
- API Key 输入错误或前后有空格
|
||
- 令牌组选择错误（Claude 的 Key 不能用于 Gemini，反之亦然）
|
||
- 账户余额不足
|
||
|
||
**解决方法：**
|
||
|
||
1. 重新复制 API Key，确保完整且无多余空格
|
||
2. 在 [oneinAI 控制台](https://api.oneinai.com/console/token) 确认创建了正确的令牌组
|
||
3. 查看账户余额是否充足
|
||
|
||
### 模型列表为空？
|
||
|
||
**可能原因：**
|
||
|
||
- Base URL 配置错误
|
||
- 网络连接问题
|
||
- API Key 权限不足
|
||
|
||
**解决方法：**
|
||
|
||
1. 确认 Claude 的 API 地址为 `https://api.oneinai.com`
|
||
2. 确认 Gemini 的 API 地址为 `https://api.oneinai.com/v1beta/models`
|
||
3. 检查网络连接是否正常
|
||
4. 重新获取 API Key 并确认令牌组权限正确
|
||
|
||
### 对话响应速度慢？
|
||
|
||
**可能原因：**
|
||
|
||
- 网络延迟
|
||
- 选择的模型较大（如 Opus 系列）
|
||
- 上下文过长
|
||
|
||
**解决方法：**
|
||
|
||
1. 检查网络连接质量
|
||
2. 尝试使用更快的模型（如 Gemini Flash 或 Claude Haiku）
|
||
3. 清理或缩短对话历史
|
||
|
||
### 如何同时使用多个模型？
|
||
|
||
1. 在设置中分别配置不同的模型提供商
|
||
2. 在新建对话时选择对应的模型
|
||
3. 也可以创建多个对话窗口，每个使用不同模型
|
||
|
||
### 更多问题
|
||
|
||
- [oneinAI 控制台](https://api.oneinai.com/console/token)
|
||
- [oneinAI FAQ](/support/faq)
|
||
- [CherryStudio 官方文档](https://www.cherry-ai.com/)
|
||
|
||
---
|
||
|
||
## ✅ 完成
|
||
|
||
🎉 **配置完成！现在你可以使用 CherryStudio 愉快地与 AI 对话了！**
|
||
|
||
**核心要点回顾：**
|
||
|
||
- ✅ Claude 与 Gemini 必须使用**不同的 API Key**（不同令牌组）
|
||
- ✅ Claude API 地址：`https://api.oneinai.com`
|
||
- ✅ Gemini API 地址：`https://api.oneinai.com/v1beta/models`
|
||
- ✅ 根据任务特性选择合适的模型
|
||
- ✅ 定期检查 [oneinAI 控制台](https://api.oneinai.com/console/token) 的余额
|
||
- ✅ 妥善保管你的 API Key，避免泄露
|
||
|
||
---
|
||
|
||
**相关教程：**
|
||
|
||
- [Alma 客户端配置](/apps/alma)
|
||
- [Hapi 远程控制](/apps/hapi)
|
||
- [oneinAI 控制台](https://api.oneinai.com/console/token)
|