# Chatbox + DeepSeek/Qwen API Token 安装与使用教程

## 一、四种 AI 使用方式对比

在正式安装之前，先了解我们有哪些使用 AI 大模型的方式，以及各自的优劣。

### 1. 使用场景对比

| 对比维度 | Web Chat（免费版） | 本地 App（免费版） | 本地 App（会员版） | Chatbox + 自有 API Token |
|---|---|---|---|---|
| **代表产品** | DeepSeek 网页版、通义千问网页版 | DeepSeek App、通义千问 App | ChatGPT Plus、DeepSeek Pro（$9.9/月） | Chatbox + DeepSeek API / Qwen API |
| **费用** | 免费（有频率限制） | 免费（有频率限制） | 月付订阅制 | 按 Token 用量计费，用多少花多少 |
| **系统提示词（System Prompt）** | ❌ 不可自定义 | ❌ 不可自定义 | 部分支持 | ✅ 完全自定义，每个对话可独立设置 |
| **模型参数调节** | ❌ 不可调 | ❌ 不可调 | 有限调节 | ✅ 温度、Top P、最大输出 Token 等均可调 |
| **多模型切换** | ❌ 只能用单一模型 | ❌ 只能用单一模型 | ❌ 只能用单一模型 | ✅ 一个界面切换 DeepSeek、Qwen、GPT 等 |
| **聊天记录存储** | 云端（服务商服务器） | 云端（服务商服务器） | 云端（服务商服务器） | **本地存储**（默认保存在你的电脑上） |
| **数据隐私** | ⚠️ 数据上传至服务商 | ⚠️ 数据上传至服务商 | ⚠️ 数据上传至服务商 | ✅ 对话记录存本地；API 调用数据不用于模型训练（详见下文） |

### 2. 功能性与数据保密性重点说明

#### 功能性优势

Chatbox + 自有 API Token 的最大优势在于**完全可控**：

- **系统提示词（System Prompt）**：你可以为每个对话设置不同的角色指令。例如设定"你是一位资深英文翻译专家，请将以下中文翻译为学术风格的英文"，AI 就会始终按照这个身份和风格回答。这在 Web Chat 和免费 App 中是完全做不到的。
- **模型参数精细调节**：温度（Temperature）控制回答的随机性——低温度适合翻译、代码等需要精确性的任务，高温度适合创意写作；Top P 控制词汇多样性；最大输出 Token 控制回答长度。这些参数在 Web/App 端均不可调节。

#### 数据保密性优势

这是很多用户忽略但极其重要的一点：

- **本地存储**：Chatbox 默认将所有聊天记录、API Key、设置保存在你的本地设备上，不会上传到任何第三方服务器。
- **API 调用的数据隐私**：DeepSeek 开放平台服务协议中无训练许可授权条款，且用户可通过关闭"数据用于优化体验"选项选择退出，关闭后输入和输出不再用于模型训练。 阿里云百炼（Qwen API）同样遵循企业级数据安全标准，API 调用的数据默认不用于模型训练。
- **对比 Web/App 端**：在 DeepSeek 或通义千问的网页版/App 中，你的对话数据存储在服务商的云端服务器上。虽然 DeepSeek 提供了"数据用于优化体验"的关闭开关，但数据仍然经过并存储在服务商的服务器上。

> 💡 **总结**：如果你只是偶尔闲聊，Web Chat 免费版完全够用；如果你需要深度定制 AI 的行为、处理敏感内容（如工作文档、私人翻译、代码审查），Chatbox + 自有 API Token 是最佳选择。

---

## 二、Chatbox 介绍与安装

### 1. Chatbox 是什么

Chatbox（全称 Chatbox AI）是一款**开源、免费**的多平台 AI 客户端，支持 Windows、macOS、Linux、iOS、Android 及网页端。 它本身不提供 AI 模型，而是一个"万能遥控器"——你可以接入 DeepSeek、Qwen、ChatGPT、Claude、Gemini、本地 Ollama 等任意模型，在一个统一的界面中使用。

当前最新稳定版本为 **v1.23.2**（2026年9月10日发布）。

核心特性：

- 多模型统一接入，一键切换
- 聊天记录、API Key 本地存储，保障隐私
- 支持自定义系统提示词、温度、Top P 等模型参数
- 支持 Markdown 渲染、代码高亮、LaTeX 公式
- 支持文件上传解析（PDF、Word、Excel、图片等）
- 支持联网搜索、AI 图表生成、图像生成
- 开源（GPLv3 协议），社区活跃

### 2. 下载安装

#### Windows

1. 访问 Chatbox 官网下载页面：[https://chatboxai.app](https://chatboxai.app)
2. 点击 **Windows** 下载按钮，获取 `.exe` 安装包
3. 双击安装包，按照向导提示完成安装（建议安装到非系统盘）

<!-- 📸 截图位置：Chatbox 官网下载页面，标注 Windows 下载按钮 -->

#### macOS

1. 访问官网下载页面
2. 根据你的 Mac 芯片类型选择对应版本：
   - **Apple Silicon**（M1/M2/M3/M4 芯片）→ 下载 ARM64 版
   - **Intel 芯片**→ 下载 Intel 版
3. 打开下载的 `.dmg` 文件，将 Chatbox 图标拖入「应用程序」文件夹
4. 首次启动若提示"无法验证开发者"，前往「系统设置 → 隐私与安全性」中点击「仍要打开」

<!-- 📸 截图位置：macOS 拖拽安装界面 -->

#### Linux

- 提供 AppImage、deb、rpm 三种格式
- AppImage 方式：下载后执行 `chmod +x chatbox.AppImage && ./chatbox.AppImage`
- 也可通过 Snap 安装：`sudo snap install chatbox`

#### 移动端

- **iOS**：在 App Store 搜索「Chatbox AI」下载（注意辨认官方图标）
- **Android**：推荐直接下载 APK 安装包，或通过 Google Play 安装

<!-- 📸 截图位置：Chatbox 首次启动的欢迎界面 -->

### 3. 首次启动

安装完成后启动 Chatbox，你会看到欢迎界面。此时**不需要注册 Chatbox 账号**——我们将使用自己的 API Token，完全跳过 Chatbox 官方的付费套餐体系。

<!-- 📸 截图位置：Chatbox 欢迎界面，标注"跳过登录"或直接进入设置的路径 -->

---

## 三、DeepSeek 和 Qwen API 介绍与开通

### 1. DeepSeek API

#### 简介

DeepSeek 是国内领先的大模型服务商，提供 DeepSeek-V4-Pro（旗舰推理模型）和 DeepSeek-V4.1-Flash（高性价比快速模型）等。其 API 兼容 OpenAI 接口格式，可以被 Chatbox 等第三方客户端直接调用。

#### 开通步骤

1. 访问 DeepSeek 开放平台：[https://platform.deepseek.com](https://platform.deepseek.com)
2. 注册账号并完成实名认证（个人需身份证 + 人脸识别）
3. 进入控制台，点击左侧菜单「API Keys」
4. 点击「创建 API Key」，系统会生成一串以 `sk-` 开头的密钥

> ⚠️ **重要提醒**：API Key 只在创建时完整显示一次，关闭弹窗后就再也看不到了！请立刻复制保存到安全的地方（如密码管理器），弄丢了只能删除重新创建。

<!-- 📸 截图位置：DeepSeek 开放平台 API Key 管理页面，标注"创建 API Key"按钮 -->
<!-- 📸 截图位置：API Key 生成成功弹窗，提醒用户立即复制保存 -->

5. 进入「充值」页面，根据使用量充值。DeepSeek API 是**按量计费**（用多少扣多少），最低充值 **10 元**，支持支付宝和微信支付。普通个人用户无需一次充值太多。

#### 价格参考（2026年9月最新）

DeepSeek 采用**峰谷定价**，高峰时段（工作日 9:00-12:00、14:00-18:00）价格为空闲时段（晚间、凌晨、周末全天）的 2 倍。

| 模型 | 时段 | 输入（缓存命中） | 输入（缓存未命中） | 输出 |
|---|---|---|---|---|
| DeepSeek-V4.1-Flash | 空闲 | ¥0.02/百万Token | ¥1/百万Token | ¥4/百万Token |
| DeepSeek-V4.1-Flash | 高峰 | ¥0.04/百万Token | ¥2/百万Token | ¥8/百万Token |
| DeepSeek-V4-Pro | 空闲 | ¥0.15/百万Token | ¥4.5/百万Token | ¥13.5/百万Token |
| DeepSeek-V4-Pro | 高峰 | ¥0.30/百万Token | ¥9/百万Token | ¥27/百万Token |



> 💡 **实际花费参考**：日常翻译、问答使用 Flash 模型，每百万 Token 仅需 1~4 元。一次普通的翻译对话大约消耗 2000~5000 Token，折合费用不到 1 分钱。充值 10 元可以使用相当长的时间。
>
> 新注册 API 账户赠送 **500 万 Tokens 免费额度**（有效期 30 天），足够体验一段时间。

#### 数据隐私说明

DeepSeek 开放平台服务协议中无训练许可授权条款。同时，用户可通过在产品内关闭「数据用于优化体验」选项选择退出，关闭后输入和输出不再用于模型训练。

---

### 2. Qwen（通义千问）API

#### 简介

通义千问（Qwen）是阿里巴巴推出的大模型系列，通过**阿里云百炼平台**提供 API 服务。提供 Qwen3.7-Max（旗舰）、Qwen3.7-Plus（均衡）、Qwen3.7-Flash（极速低价）等多个版本，同样兼容 OpenAI 接口格式。

#### 开通步骤

1. 访问阿里云百炼平台：[https://bailian.console.aliyun.com](https://bailian.console.aliyun.com)
2. 使用阿里云账号登录（没有则需注册并完成实名认证）
3. 开通「大模型服务平台百炼」服务
4. 进入控制台，在左侧菜单找到「API-KEY 管理」
5. 点击「创建 API Key」，生成以 `sk-` 开头的密钥

<!-- 📸 截图位置：阿里云百炼控制台 API-KEY 管理页面 -->

6. Qwen API 采用**按量后付费**模式，无需预充值，按实际使用的 Token 量自动从阿里云账户扣费

#### 价格参考（2026年）

| 模型 | 输入（每百万 Token） | 输出（每百万 Token） |
|---|---|---|
| Qwen3.7-Max | ¥2.5（限时5折，原价¥6） | ¥7.5（限时5折，原价¥18） |
| Qwen3.7-Plus | ¥0.4 | ¥1.6 |
| Qwen3.7-Flash | ¥0.03 | ¥0.06 |



> 💡 **实际花费参考**：Qwen3.7-Flash 的价格极低，输入仅 ¥0.03/百万 Token，非常适合高频轻量级任务。新用户开通百炼可领取超 **7000 万 Tokens 免费额度**（90 天有效期），非常充裕。

#### 数据隐私说明

阿里云百炼平台遵循企业级数据安全标准，API 调用的数据默认不用于模型训练。

---

## 四、Chatbox 配置 API

安装好 Chatbox 并获取 API Key 后，就可以将两者连接起来了。

### 配置 DeepSeek API

1. 打开 Chatbox，点击左下角的 ⚙️ **设置**（齿轮图标）
2. 在设置页面中，找到并点击「**模型提供方**」（Model Provider）
3. 点击「**添加**」（Add）按钮
4. 在弹出的配置窗口中填写以下信息：

| 配置项 | 填写内容 |
|---|---|
| **名称** | `DeepSeek`（自定义，方便识别即可） |
| **API 模式** | 选择 `OpenAI 兼容`（OpenAI Compatible） |
| **API Host / Base URL** | `https://api.deepseek.com` |
| **API Key** | 粘贴你在 DeepSeek 开放平台创建的 API Key（`sk-...`） |
| **模型名称** | `deepseek-flash`（推荐，性价比高）或 `deepseek-v4-pro`（旗舰推理） |

<!-- 📸 截图位置：Chatbox 设置 → 模型提供方 → 添加 DeepSeek 的配置界面，标注各字段填写位置 -->

5. 点击「**保存**」完成配置

### 配置 Qwen（通义千问）API

1. 同样在「模型提供方」页面，点击「**添加**」
2. 填写以下信息：

| 配置项 | 填写内容 |
|---|---|
| **名称** | `Qwen`（自定义） |
| **API 模式** | 选择 `OpenAI 兼容`（OpenAI Compatible） |
| **API Host / Base URL** | `https://dashscope.aliyuncs.com/compatible-mode/v1` |
| **API Key** | 粘贴你在阿里云百炼创建的 API Key（`sk-...`） |
| **模型名称** | `qwen3.7-flash`（极速低价）或 `qwen3.7-plus`（均衡）或 `qwen3.7-max`（旗舰） |

<!-- 📸 截图位置：Chatbox 设置 → 模型提供方 → 添加 Qwen 的配置界面 -->

3. 点击「**保存**」完成配置

### 验证配置

配置完成后，回到 Chatbox 主界面：

1. 点击左下角「**新对话**」按钮
2. 在聊天框右下角的模型选择器中，你应该能看到刚才添加的 DeepSeek 和 Qwen 模型
3. 选择一个模型，输入"你好"进行测试
4. 如果收到正常的 AI 回复，说明配置成功！

<!-- 📸 截图位置：Chatbox 主界面右下角模型选择器，展示已添加的 DeepSeek 和 Qwen 模型列表 -->
<!-- 📸 截图位置：测试对话成功的截图，显示 AI 正常回复"你好" -->

> 💡 **小贴士**：你可以同时配置多个模型提供方，在对话中随时切换对比不同模型的回答质量。

---

## 五、使用教程：用 AI 翻译文档

下面以一个实际场景——**翻译英文文档为中文**——来演示 Chatbox 的强大之处。

### 步骤 1：设置系统提示词（System Prompt）

系统提示词是 Chatbox + API 方案的杀手级功能。它让你在对话开始前就"教会" AI 它的角色和任务规范。

1. 在 Chatbox 中新建一个对话
2. 点击对话区顶部的「**对话设置**」（或齿轮图标）
3. 在「**系统提示词**」（System Prompt）输入框中，输入以下提示词：

```
你是一位专业的中英翻译专家，擅长将英文学术/技术文档翻译为流畅、准确的中文。

翻译要求：
1. 保持原文的段落结构和格式
2. 专业术语首次出现时，在括号中保留英文原文
3. 译文应符合中文表达习惯，避免翻译腔
4. 对于代码、公式、专有名词等不需要翻译的内容，保持原样
5. 如果原文有歧义，在译文中用【注：...】标注
```

<!-- 📸 截图位置：Chatbox 对话设置界面，标注系统提示词输入框及已填入的内容 -->

### 步骤 2：调节模型参数

在同一个「对话设置」面板中，你可以调节以下参数：

- **温度（Temperature）**：翻译任务建议设为 **0.3**（低温度 = 更精确、更稳定的输出）
- **Top P**：保持默认 **0.7~1.0** 即可
- **最大输出 Token**：如果翻译长文档，建议调高到 **4096** 或更高

<!-- 📸 截图位置：对话设置中的温度和 Top P 参数调节界面 -->

### 步骤 3：发送翻译请求

在输入框中粘贴你要翻译的英文内容，例如：

```
请翻译以下段落：

Large language models (LLMs) have demonstrated remarkable capabilities in natural language understanding and generation. These models, typically based on the Transformer architecture, are pre-trained on massive corpora and can be fine-tuned for various downstream tasks.
```

按 **Enter** 发送。

<!-- 📸 截图位置：Chatbox 对话界面，展示用户发送的翻译请求和 AI 返回的翻译结果 -->

### 步骤 4：查看与导出结果

AI 会按照你设定的系统提示词要求，返回格式规范、术语准确的中文翻译。你可以：

- **复制内容**：将鼠标悬停在 AI 回复上，点击出现的复制按钮
- **导出对话**：通过对话菜单导出为 Markdown、HTML 或 TXT 格式
- **继续追问**：如果对某句翻译不满意，可以直接说"第三句请换一种译法"，AI 会在上下文中理解你的意思

### 进阶技巧

- **上传文件直接翻译**：Chatbox 支持直接上传 PDF、Word 等文件。点击输入框旁的附件按钮，上传英文文档，AI 会自动解析内容并进行翻译。
- **保存为"我的搭档"**：如果你经常做翻译工作，可以将上述系统提示词保存为 Chatbox 的「我的搭档」（预置助手），以后一键调用，无需每次重新输入。
- **批量翻译**：将整篇文档分段粘贴，AI 会保持上下文一致性。配合较高的最大输出 Token 设置，可以一次翻译更长的内容。

---

## 附录：常见问题

**Q：API Token 用完了怎么办？**
A：DeepSeek 在开放平台充值页面随时可以追加充值（最低 10 元）；Qwen API 为后付费模式，自动从阿里云账户扣费，无需手动充值。

**Q：Chatbox 是免费的吗？**
A：Chatbox 客户端本身完全免费且开源。你只需要为自己使用的 AI 模型 API 付费（按 Token 用量计费，费用极低）。

**Q：我的数据安全吗？**
A：Chatbox 将所有聊天记录和 API Key 存储在你的本地设备上。通过 API 调用模型时，DeepSeek 开放平台服务协议中无训练许可授权条款，且用户可通过关闭"数据用于优化体验"选项选择退出，关闭后数据不再用于模型训练；阿里云百炼同样遵循企业级安全标准，API 数据默认不用于训练。

**Q：DeepSeek Flash 和 Pro 怎么选？**
A：日常翻译、问答、摘要等任务用 **Flash** 即可，速度快、价格低；需要复杂推理、数学证明、深度分析时使用 **Pro**。

**Q：可以同时用 DeepSeek 和 Qwen 吗？**
A：当然可以！这正是 Chatbox 的优势所在。你可以在模型选择器中随时切换，甚至在同一对话中对比不同模型的回答。

---

> 📌 **本教程涉及的链接汇总**
> - Chatbox 官网：[https://chatboxai.app](https://chatboxai.app)
> - DeepSeek 开放平台：[https://platform.deepseek.com](https://platform.deepseek.com)
> - 阿里云百炼平台：[https://bailian.console.aliyun.com](https://bailian.console.aliyun.com)

---
需要我帮你写一份可以直接复制使用的中文翻译系统提示词模板吗？