# 项目介绍

媒体账号：

* [小红书](https://www.xiaohongshu.com/user/profile/67b581b6000000000e01d11f)
* [Twitter](https://x.com/ChatboxAI_HQ)

***

Chatbox AI是一款集多模型对话、文件解析、AI绘图、代码生成等功能于一体的全能AI助手，支持Windows、Mac、Linux、iOS、Android 及网页全平台。凭借简洁直观的界面设计、强大的本地化处理能力和开箱即用的云端服务，Chatbox AI 已成为提升工作效率的首选工具。

## 核心功能与特色

### **1. 智能对话系统**

* **多模型对比**：支持同时连接 ChatGPT 4o/Claude 3.5/DeepSeek 等先进模型，自由切换体验不同 AI 风格
* **上下文记忆**：自动保存完整对话历史，支持 Markdown/HTML/TXT 多种格式导出
* **个性化设置**：可自定义温度、最大 token 等参数，精准控制 AI 输出

### **2. 生产力增强套件**

* **文件理解**：直接解析PDF/Word/Excel/图片中的内容
* **代码专家**：提供类 Claude Artifacts 的实时代码预览能力
* **实时联网**：一键获取最新资讯、股票行情等网络数据，回答始终与时俱进

### **3. 创意可视化工具**

* **AI绘图**：通过自然语言描述生成高质量图像（每月免费额度）
* **图表生成**：支持将数据转化为可视化图表，支持 LaTeX 公式渲染
* **多格式渲染**：完美呈现 Markdown、HTML、数学公式等专业内容

### **4. 企业级数据管理**

* **本地优先**：所有对话记录和文件默认存储在用户设备，保障数据主权

## 技术优势

* **零门槛体验**：无需技术背景，安装即可享受 AI 生产力
* **持续进化**：同步更新模型库和功能模块，保持技术前沿性

## 适用场景

* **学术研究**：快速解析论文/教材，生成文献综述
* **内容创作**：辅助写作、翻译、社交媒体文案生成
* **开发编程**：代码生成/调试/文档编写全流程支持
* **商业分析**：自动处理报表数据，生成可视化洞察


# 项目规划

你可以在下方链接查看 Chatbox AI 正在开发中的功能。你可以查看到其他用户反馈的功能建议，并给你认为重要的功能投票，这会成为 Chatbox AI 开发功能的参考。

{% embed url="<https://chatboxai.canny.io/>" %}


# 模型配置

快速配置自定义 AI 提供方

1. 打开Chatbox，点击侧边栏设置按钮，进入设置页面
2. 点击模型提供方选项

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2FDjlvCq1NgtOaSizvkT5g%2Fimage.png?alt=media&amp;token=1fe54f1c-d5a2-4d26-92d5-a53dc5487522" alt="" width="375"><figcaption></figcaption></figure>

3. 如果没有需要的 AI 提供商，可以点击底部的“添加”按钮来添加提供商。
4. 填写API提供方名称，根据提供方的API类型选择合适的选项，如GPT模型选择OpenAI API兼容，Gemini模型选择Google Gemini兼容

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2FlqSZ2iKwhzqKEn5oNgYe%2Fimage.png?alt=media&amp;token=0a5f81d7-2b22-4c03-b4bb-997af8aaf914" alt="" width="375"><figcaption></figcaption></figure>

5. 按照提供方的信息，填写好API密钥和API主机，API路径一般可以不用填写，默认为`/v1/chat/completions`，具体参考提供方的信息

   <figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2FDQqqAqIrlVKqbRLSDuAK%2Fimage.png?alt=media&amp;token=02a16e73-a1fe-406d-87ea-1eb90643b0ea" alt="" width="375"><figcaption></figcaption></figure>
6. 添加至少一个模型，勾选模型对应的能力配置（可选，不配置视为纯文本模型）

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2F0r1mKyhoCowH5YQjdbe1%2Fimage.png?alt=media&amp;token=e459e73b-45e5-46d2-be3e-14eda984df10" alt="" width="375"><figcaption></figcaption></figure>

7. 保存后，点击“检查”按钮，提示连接成功

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2FhgAFyaUAPnGZT01yTAdQ%2Fimage.png?alt=media&amp;token=4439e1a2-05f6-4944-8e70-b1c05ea7c87e" alt="" width="375"><figcaption></figcaption></figure>

8. 回到首页，创建新对话，可以发起聊天

   <figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2FVdkOTMvHYr11Y6IX44Tb%2Fimage.png?alt=media&amp;token=8604e3e0-4dd6-42ce-bfe5-dd7ab8e1c627" alt="" width="375"><figcaption></figcaption></figure>


# 如何在 Chatbox 中配置 OpenRouter

OpenRouter 是一个统一的 AI 模型网关，提供对多种主流大语言模型的访问，包括 GPT-4、Claude、Gemini、Llama、Mistral 等。通过 OpenRouter，你可以使用单一的 API 密钥访问来自不同提供商的数百个模型，无需分别注册多个服务。

使用 OpenRouter 的优势：

* 单一 API 访问多家模型提供商
* 灵活的按量付费模式
* 支持多种开源和闭源模型
* 提供部分免费模型可供测试

本教程将指导你如何在 Chatbox 中配置 OpenRouter。

### 获取 OpenRouter API 密钥

1. 访问 [OpenRouter 官网](https://openrouter.ai/)
2. 注册并登录账户
3. 进入 [API Keys](https://openrouter.ai/keys) 页面
4. 点击 "Create Key" 创建新的 API 密钥
5. 复制生成的密钥（格式类似：`sk-or-v1-...`）

### 在 Chatbox 中配置 OpenRouter

1. 打开 Chatbox，首次启动会显示欢迎界面，点击"设置提供方"进入设置页面。如果不是首次启动，点击侧边栏底部的"设置"按钮。

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2Fgit-blob-f47a6bdc1e736dac6a2e70ccf434e91def597b82%2Fopenrouter-zh-1-homepage.png?alt=media" alt="" width="375"><figcaption><p>Chatbox 首页</p></figcaption></figure>

2. 在设置页面的模型提供方列表中，找到并点击 "OpenRouter"。

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2Fgit-blob-e36675cc61f5fba191e2e1c5a311c86dc50af06e%2Fopenrouter-zh-2-provider-list.png?alt=media" alt="" width="375"><figcaption><p>模型提供方列表</p></figcaption></figure>

3. 在 OpenRouter 配置页面，将你获取的 API 密钥填入"API 密钥"输入框中。

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2Fgit-blob-560348b9c310ff427ee26ee1401c0b61b3710260%2Fopenrouter-zh-3-config.png?alt=media" alt="" width="375"><figcaption><p>OpenRouter 配置页面</p></figcaption></figure>

4. 点击"检查"按钮验证 API 密钥是否有效。如果验证成功，你将看到成功提示。
5. 在模型列表中，你可以看到 OpenRouter 提供的各种模型。点击"获取"按钮可以刷新获取最新的模型列表。
6. 关闭设置窗口，回到主界面。点击底部的"选择模型"，你现在可以选择 OpenRouter 提供的模型开始对话了。

### 可用模型

OpenRouter 提供了丰富的模型选择，包括但不限于：

* **GPT 系列**：GPT-4o、GPT-4o mini、GPT-5 等
* **Claude 系列**：Claude 3.5 Sonnet、Claude 3 Opus 等
* **Gemini 系列**：Gemini 2.5 Pro、Gemini 2.5 Flash 等
* **开源模型**：DeepSeek、Llama、Mistral、Qwen 等
* **免费模型**：部分模型提供免费使用额度

### 常见问题

#### API 密钥格式

OpenRouter 的 API 密钥格式通常为 `sk-or-v1-` 开头的字符串。请确保复制完整的密钥。

#### 计费说明

OpenRouter 采用按量付费模式，不同模型的价格不同。你可以在 OpenRouter 官网查看各模型的具体定价。部分模型（如标注为 "free" 的模型）提供免费使用额度。

#### 连接问题

如果遇到连接问题，请检查：

* API 密钥是否正确输入
* 网络连接是否正常
* 如果在中国大陆使用，可能需要配置网络代理

### 参考链接

* [OpenRouter 官网](https://openrouter.ai/)
* [OpenRouter 文档](https://openrouter.ai/docs)
* [OpenRouter 模型列表](https://openrouter.ai/models)
* [OpenRouter 定价](https://openrouter.ai/models)


# 如何将 Chatbox 连接到远程 Ollama 服务：逐步指南

现在有越来越多的开源模型，可以让你在自己的电脑或服务器上运行。使用本地模型有许多优势：

* 完全离线运行，保护隐私数据安全
* 无需支付在线 API 费用
* 完全离线，服务稳定，无网络延迟
* 可以自由调整和定制模型参数

Chatbox 可以很好地连接到 Ollama 服务，让你在使用本地模型时可以获取 Chatbox 提供的更多强大功能，比如 Artifact Preview、文件解析、会话话题管理、Prompt 管理等。

（注意：运行本地模型对你的电脑配置有一定要求，包括内存、GPU 等。如果出现卡顿，请尝试降低模型参数。）

### 安装 Ollama

Ollama 是一个开源的本地模型运行工具，可以方便地下载和运行各种开源模型，比如 Llama、Qwen、DeepSeek 等。这个工具支持 Windows、MacOS、Linux 等操作系统。

[Ollama 下载地址](https://ollama.com/)

![Ollama Chatbox 教程](https://download.chatboxai.app/static/ollama_guide_1.png)

### 下载并运行本地模型

下载并安装 Ollama 后，请打开命令行终端，输入命令下载并运行本地模型。你可以在这里查看到所有 ollama 支持的模型列表：[Ollama 模型列表](https://ollama.com/models)。

举例1：下载并运行 llama3.2 模型

```bash
ollama run llama3.2
```

举例2：下载并运行 deepseek-r1:8b 模型（注意：Ollama 上的 DeepSeek R1 模型实际上是蒸馏模型）

```bash
ollama run deepseek-r1:8b
```

![Ollama Chatbox 教程](https://download.chatboxai.app/static/ollama_guide_2.png)

### 在 Chatbox 中连接本地 Ollama 服务

在 Chatbox 中打开设置，在模型提供方中选择 Ollama，即可在模型下拉框中看见你运行的本地模型。

![Ollama Chatbox 教程](https://download.chatboxai.app/static/ollama_guide_3.png)

点击保存，即可正常聊天使用。

![Ollama Chatbox 教程](https://download.chatboxai.app/static/ollama_guide_4.png)

### 在 Chatbox 中连接远程 Ollama 服务

除了可以轻松连接本地 Ollama 服务，Chatbox 也支持连接到运行在其他机器上的远程 Ollama 服务。

例如，你可以在家中的电脑上运行 Ollama 服务，并在手机或其他电脑上使用 Chatbox 客户端连接到这个服务。

你需要确保远程 Ollama 服务正确配置并暴露在当前网络中，以便 Chatbox 可以访问。**默认情况下，需要对远程 Ollama 服务进行简单的配置**。

#### 如何配置远程 Ollama 服务？

默认情况下，Ollama 服务仅在本地运行，不对外提供服务。要使 Ollama 服务能够对外提供服务，你需要设置以下两个环境变量：

```bash
OLLAMA_HOST=0.0.0.0
OLLAMA_ORIGINS=*
```

#### 在 MacOS 上配置

1. 打开命令行终端，输入以下命令：

   ```bash
   launchctl setenv OLLAMA_HOST "0.0.0.0"
   launchctl setenv OLLAMA_ORIGINS "*"
   ```
2. 重启 Ollama 应用，使配置生效。

#### 在 Windows 上配置

在 Windows 上，Ollama 会继承你的用户和系统环境变量。

1. 通过任务栏退出 Ollama。
2. 打开设置（Windows 11）或控制面板（Windows 10），并搜索“环境变量”。
3. 点击编辑你账户的环境变量。

   为你的用户账户编辑或创建新的变量 **OLLAMA\_HOST**，值为 **0.0.0.0**； 为你的用户账户编辑或创建新的变量 **OLLAMA\_ORIGINS**，值为 **\***。
4. 点击确定/应用以保存设置。
5. 从 Windows 开始菜单启动 Ollama 应用程序。

#### 在 Linux 上配置

如果 Ollama 作为 systemd 服务运行，应使用 systemctl 设置环境变量：

1. 调用 `systemctl edit ollama.service` 编辑 systemd 服务配置。这将打开一个编辑器。
2. 在 \[Service] 部分下为每个环境变量添加一行 Environment：

   ```
   [Service]
   Environment="OLLAMA_HOST=0.0.0.0"
   Environment="OLLAMA_ORIGINS=*"
   ```
3. 保存并退出。
4. 重新加载 systemd 并重启 Ollama：

   ```
   systemctl daemon-reload
   systemctl restart ollama
   ```

#### 服务 IP 地址

配置后，Ollama 服务将能在当前网络（如家庭 Wifi）中提供服务。你可以使用其他设备上的 Chatbox 客户端连接到此服务。

Ollama 服务的 IP 地址是你电脑在当前网络中的地址，通常形式如下：

```
192.168.XX.XX
```

在 Chatbox 中，将 API Host 设置为：

```
http://192.168.XX.XX:11434
```

#### 注意事项

* 可能需要在防火墙中允许 Ollama 服务的端口（默认为 11434），具体取决于你的操作系统和网络环境。
* 为避免安全风险，请不要将 Ollama 服务暴露在公共网络中。家庭 Wifi 网络是一个相对安全的环境。

#### 参考

* [Ollama 服务配置](https://github.com/ollama/ollama/blob/main/docs/faq.md#how-can-i-expose-ollama-on-my-network)


# 如何将 Chatbox 连接到 LM Studio：分步指南

Chatbox 可以很好地连接到 LM Studio 服务，让你在使用本地模型时可以获取 Chatbox 提供的更多强大功能，比如 Artifact Preview、会话话题管理、Prompt 管理等。

你只需要简单几步就能连接到 LM Studio 服务：

### 1. 开启 LM Studio 服务

请先打开 LM Studio，按顺序开启以下选项：

1. 进入 Developer 模式
2. 进入 Developer 面板
3. 点击开关开启 Server（Status 显示为 running 即可）

![Chatbox connect LM Studio Guide 1](https://download.chatboxai.app/static/lm_studio_guide_1.png)

如果你希望使用 Chatbox 连接当前网络下另外一台机器上运行的 LM Studio 服务，或者你希望在 Chatbox 手机应用连接到你电脑上运行的 LM Studio 服务，那么你还需要完成下面两步设置：

4. 点击 Settings
5. 开启 Enable CORS
6. 开启 Serve on Local Network

![Chatbox connect LM Studio Guide 2](https://download.chatboxai.app/static/lm_studio_guide_2.png)

最后请复制 LM Studio 中显示的 API Host 地址。

### 2. 在 Chatbox 中连接 LM Studio 服务

打开 Chatbox 设置，在 Model Provider 中选择 LM Studio，然后输入对应的 API Host 即可。

![Chatbox connect LM Studio Guide 3](https://download.chatboxai.app/static/lm_studio_guide_3.png)

正常情况下你将在模型选项中看到 LM Studio 已经下载的模型列表，然后就能正常使用了。


# 导入第三方提供方配置

从版本**1.15.1**开始，Chatbox支持导入JSON格式的模型提供方配置，部分提供方官网上会提供配置，可以手动复制后在Chatbox软件中一键导入，也支持通过deep link一键导入到客户端。

参考支持的提供方：

* [302.AI](https://help.302.ai/docs/jie-ru-dao-ChatBox)
* [AiHubMix](https://docs.aihubmix.com/cn/clients/ChatBox)
* [ChatAnywhere](https://chatanywhere.apifox.cn/#chatbox-%E9%85%8D%E7%BD%AE%E7%AE%80%E5%8D%95)
* [O3](https://vip1.o3.fan/info/chatbox/) (一键配置)
* [BurnCloud](<https://www.burncloud.com/zh-cn/posts/chatbox-burncloud-api.html&#xA;>)

#### 配置格式

```typescript
type ProviderConfig = {
  id: string // 提供方id，需要在 Chatbox 内唯一，建议用域名
  name: string // 提供方在 Chatbox 内展示名称
  type: 'openai' // 目前仅支持openai规范的API，未来会支持更多API类型
  iconUrl: string // icon 规格要求见下方图标规范
  urls: {
      website: string // 提供方官网链接，如 https://chatboxai.app
      getApiKey?: string // 可选：提供方获取API key的地址
      docs?: string // 可选：提供方文档地址
      models?: string // 可选：提供方查看模型列表的页面地址
  }
  settings: {
    apiHost: string // 提供方的 API host，如 https://api.openai.com
    apiPath?: string // 提供方的 API Path，默认为 /v1/chat/completions
    apiKey?: string // 用户专属的 API key, 也可以导入后用户在界面自行填写
    models: ModelInfo[] // 导入后默认展示的模型列表，建议放一些最常用的
  } 
}

type ModelInfo = {
  modelId: string // 模型的id，如gpt-4o
  nickname?: string // 模型的显示名称，默认为模型的id
  type?: 'chat' | 'embedding' | 'rerank' // 模型的类型，默认为chat
  capabilities?: ('vision' | 'reasoning' | 'tool_use')[] // 模型的能力，决定了 Chatbox 如何调用这些模型
  contextWindow?: number // 模型的最大上下文限制，Chatbox 会以此来计算用户输入限制
  maxOutput?: number // 模型的最大输出限制，Chatbox 会限制请求参数不超过这个值，留空则不会限制
}

```

#### 示例配置

```json
{
  "id": "openai",
  "name": "OpenAI",
  "type": "openai",
  "iconUrl": "https://openai.com/favicon.ico",
  "urls": { "website": "https://openai.com" },
  "settings": {
    "apiHost": "https://api.openai.com/",
    "models": [
      {
        "modelId": "gpt-4o",
        "nickname": "GPT 4o",
        "type": "chat",
        "capabilities": ["vision", "tool_use"],
        "contextWindow": 128000,
        "maxOutput": 16384
      },
      {
        "modelId": "text-embedding-3-small",
        "type": "embedding"
      }
    ]
  }
}

```

#### deep link格式

```
chatbox://provider/import?config=$BASE64_ENCODED_CONFIG
```

其中`BASE64_ENCODED_CONFIG`是上面的json配置经过base64编码后的字符串

#### 提供方图标规范

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2Fqc59dN0fNncAW4OjUhaR%2Fimage.png?alt=media&amp;token=dff8d089-6b6c-44f4-8030-cef6e3b84c91" alt=""><figcaption></figcaption></figure>


# 联网模式

你可以在「拓展」中配置联网搜索使用的服务商。

* Chatbox：提供给Chatbox AI 订阅用户使用的方案，当使用其他模型服务提供商时，请不要选择该选项；
* Bing：使用 Bing 作为联网问答的信息来源；
* Tavily：需要前往 Tavily 进行配置，填入 Key 进行使用。

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2F2NWBJy7l1eK2kMljQ5p4%2F%E6%88%AA%E5%B1%8F2025-04-08%2019.04.59.png?alt=media&amp;token=cfb23346-e837-4214-9d8c-09bb4f1d8365" alt=""><figcaption></figcaption></figure>


# 键盘快捷键

### 应用窗口

| 操作        | MacOS          | Windows / Linux  |
| --------- | -------------- | ---------------- |
| 显示/隐藏应用窗口 | <kbd>⌥\`</kbd> | <kbd>Alt\`</kbd> |

### 对话导航

| 操作          | MacOS                | Windows / Linux         |
| ----------- | -------------------- | ----------------------- |
| 导航至下一条对话    | <kbd>⌘⇥</kbd>        | <kbd>CtrlTab</kbd>      |
| 导航至上一条对话    | <kbd>⌘Shift⇥</kbd>   | <kbd>CtrlShiftTab</kbd> |
| 导航至指定对话     | <kbd>⌘1/2/3/..</kbd> | <kbd>Ctrl1/2/3/..</kbd> |
| 创建新对话       | <kbd>⌘N</kbd>        | <kbd>CtrlN</kbd>        |
| 创建新的图像创造者对话 | <kbd>⌘ShiftN</kbd>   | <kbd>CtrlShiftN</kbd>   |

### 聊天

| 操作               | MacOS             | Windows / Linux   |
| ---------------- | ----------------- | ----------------- |
| 聚焦输入框            | <kbd>⌘I</kbd>     | <kbd>CtrlI</kbd>  |
| 发送               | <kbd>⏎</kbd>      | <kbd>⏎</kbd>      |
| 在输入框中插入新行        | <kbd>Shift⏎</kbd> | <kbd>Shift⏎</kbd> |
| 发送但不生成回复         | <kbd>⌘⏎</kbd>     | <kbd>Ctrl⏎</kbd>  |
| 刷新上下文，开始新线程      | <kbd>⌥R</kbd>     | <kbd>AltR</kbd>   |
| 快速插入输入框中的上一个历史输入 | <kbd>↑</kbd>      | <kbd>↑</kbd>      |
| 快速插入输入框中的下一个历史输入 | <kbd>↓</kbd>      | <kbd>↓</kbd>      |

### 搜索

| 操作              | MacOS         | Windows / Linux  |
| --------------- | ------------- | ---------------- |
| 显示/隐藏搜索对话框      | <kbd>⌘K</kbd> | <kbd>CtrlK</kbd> |
| 在搜索对话框中导航至上一个选项 | <kbd>↑</kbd>  | <kbd>↑</kbd>     |
| 在搜索对话框中导航至下一个选项 | <kbd>↓</kbd>  | <kbd>↓</kbd>     |
| 选择搜索对话框中的当前选项   | <kbd>⏎</kbd>  | <kbd>⏎</kbd>     |


# MCP

Chatbox 1.14版本推出MCP支持，用户可以在设置里配置MCP服务，然后就可以在对话中智能调用MCP工具了。

## 配置MCP服务

进入**设置 - MCP** 页面，点击“添加服务器”，即可手动配置MCP服务器，或从列表中选择内置的MCP服务。

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2Fgit-blob-cf86fcf8b22ba80cddf738e78a0b14330f8b19eb%2Fmcp-modal.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2Fgit-blob-fb874ecf9c04167a52d8a56a67c6e4b077e7c8f9%2Fmcp-config.png?alt=media" alt=""><figcaption></figcaption></figure>

## MCP一键安装链接

Chatbox支持通过deep link一键安装MCP服务，用户可以在您的网站上点击链接，启动Chatbox并自动配置MCP服务。

链接格式如下：

```
chatbox://mcp/install?server=$BASE64_ENCODED_CONFIG
```

其中，`$BASE64_ENCODED_CONFIG`是base64编码的MCP服务的配置信息，格式如下：

```
{
  "name": "fetch",
  "command": "npx",
  "args": ["fetch-mcp"],
  "env": {}
}
```

或

```
{
  "name": "deepwiki",
  "url": "https://mcp.deepwiki.com/mcp"
}
```

### 生成一键安装链接

* 编写MCP服务的JSON配置
* `JSON.stringify`配置后，使用base64编码
* 将编码后的字符串拼接到`chatbox://mcp/install?server=`后面


# 本地知识库教程

Chatbox 1.15 版本推出本地知识库功能，用户可以在设置里创建知识库并导入文档，待文档录入成功后，可以在对话界面选择知识库进行问答，下面介绍具体使用方法流程。

### 创建知识库

进入**设置 - 知识库** 页面，点击创建知识库，输入知识库名称，并选择知识库所需要的模型

对于 Chatbox AI 付费用户，可以选择 Chatbox AI 作为知识库的模型提供方，免费用户也可以选择自己的API。

**嵌入模型：**&#x7528;来将文档转换为向量

**重排模型：**&#x53EF;选，配置后可以获得更准确的搜索结果，对回答质量有一定帮助

**视觉模型：**&#x53EF;选，配置之后，可以往知识库里添加图片，图片中的文字会被提出来入库

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2FAm6jFABVyZgNWjHoptf6%2F1-create.png?alt=media&amp;token=aeca2ab1-5532-4637-926b-85038fbef61e" alt=""><figcaption><p>创建知识库</p></figcaption></figure>

### 往知识库添加文档

拖入或点击浏览文件，等待文件处理完成。

{% hint style="info" %}
由于本地解析的限制，部分文件可能解析失败，比如内容排版复杂的pdf。遇到这种情况可以用其他专业软件来提取pdf为文本文件，也可以先忽略，继续导入其他文件。
{% endhint %}

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2FE9Q7u2HEXHMM070toVpR%2F2-add-doc.png?alt=media&amp;token=e25d00e2-7786-4b69-8360-9058081cb055" alt=""><figcaption><p>添加文件</p></figcaption></figure>

### 对知识库进行问答

创建新对话，在输入框里的工具栏选择刚刚创建的知识库

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2F8rLnz34TKeQF4xp0heob%2F3-select-kb.png?alt=media&amp;token=b57f62a1-a156-431f-8ab0-d81b736bfb49" alt=""><figcaption><p>选择知识库</p></figcaption></figure>

然后就可以随意问答了

<figure><img src="https://527298948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi6ZJa1RW8EZ55DU9bOD%2Fuploads%2FWYyFq4WR8AZe8n3dhSl7%2F4-query-kb.png?alt=media&amp;token=b635a359-aed9-4d8a-9f4d-abe433e3a153" alt=""><figcaption></figcaption></figure>


# 付费方案

## 付费方案

**Chatbox AI Plan 与自备 API KEY 的不同？**

相比自备 API KEY，Chatbox AI 服务更加方便、稳定、高速、易用。你也可以在 Chatbox 中使用自己的 API KEY 来访问 AI 模型。当你使用自己的 API KEY，你需要亲自处理 API 账户的网络线路、账户维护以及其他各种常见的技术难题，并且 Chatbox 客户端无法保证 API 在线服务的质量，包括服务稳定性、回答速度与效果等。

Chatbox AI 服务可以让您无需担心上述问题。Chatbox AI 提供开箱即用、易于访问、高速稳定的在线服务。您只需按成本价支付后台费用，即可享受 AI 技术带来的效率提升。

#### 付费功能

**Chatbox AI Lite**

> 满足日常学习与办公场景

* 每月 **2,000,000** 计算点数
* 与**标准模型**聊天

  <mark style="color:blue;">DeepSeek V3, DeepSeek R1, GPT 5-mini, Claude 3.5 Haiku, Gemini 2.5 Flash</mark>
* 实时**联网搜索与查询**

  通过 AI 联网搜索获取即时的信息。保持最新事实、新闻和来自互联网的数据
* 可生成 **25** 张 AI 绘图
* 与任何图片聊天

  发送图片给 AI，提取和讨论内容，识别元素，收集见解，并以比以往更多的方式进行互动
* 最多支持 5 台设备同时使用

**Chatbox AI Pro**

> 满足更加专业的学习与办公场景

* 每月 **12,000,000** 计算点数
* 与**高级模型**聊天

  <mark style="color:blue;">GPT 5, Claude 4.5 Sonnet, Gemini 3 Pro</mark>
* 与**标准模型**聊天

  <mark style="color:blue;">DeepSeek V3, DeepSeek R1, GPT 5-mini, Claude 3.5 Haiku, Gemini 2.5 Flash</mark>
* 实时**联网搜索与查询**

  通过 AI 联网搜索获取即时的信息。保持最新事实、新闻和来自互联网的数据。
* 与任何**文档**聊天

  发送 PDF、DOC、XLS、TXT 或代码文件给 AI。您可以根据文档向 AI 提问。
* 可生成 **100** 张 AI 绘图
* 与任何图片聊天

  发送图片给 AI。提取和讨论内容，识别元素，收集见解，并以比以往更多的方式进行互动。
* 最多支持 5 台设备同时使用

**Chatbox AI Pro+**

> 适用于高强度专业学习与办公场景

* 每月 **30,000,000** 计算点数
* 与**高级模型**聊天

  <mark style="color:blue;">GPT 5, Claude 4.5 Sonnet, Gemini 3 Pro</mark>
* 与**标准模型**聊天

  <mark style="color:blue;">DeepSeek V3, DeepSeek R1, GPT 5-mini, Claude 3.5 Haiku, Gemini 2.5 Flash</mark>
* 实时**联网搜索与查询**

  通过 AI 联网搜索获取即时的信息。保持最新事实、新闻和来自互联网的数据。
* 与任何**文档**聊天

  发送 PDF、DOC、XLS、TXT 或代码文件给 AI。您可以根据文档向 AI 提问。
* 可生成 **200** 张 AI 绘图
* 与任何图片聊天

  发送图片给 AI。提取和讨论内容，识别元素，收集见解，并以比以往更多的方式进行互动。
* 最多支持 5 台设备同时使用


# 订阅管理

轻松管理您的订阅设置，查看您的账单详情，续费，或随时取消您的订阅。点击下方按钮登录您的Chatbox AI账户，您可以在其中管理您的订阅。

[访问账单门户查看收据 / 更新支付方式 / 续费 / 取消订阅](https://chatboxai.app/zh/user)

如果您之前购买的是一次性有效的 License Key（固定有效期），因为到期后不会自动扣费续期，您可以在这里付款续费原来的 License Key 延长有效期。您也可以在应用设置中查看 License Key 的类型、到期时间和剩余额度等信息。

[找回 License Key忘记 License Key？通过电子邮件找回您的 License Key](https://chatboxai.app/zh/help-center/retrieve-license-key)

#### 对于早期用户

如果您在 2024年6月1日之前订阅了服务，您可能需要点击下方按钮在 LemonSqueezy 上查看和管理您的订阅详情。

[访问 LemonSqueezy 门户查看收据 / 更新支付方式 / 取消订阅](https://app.lemonsqueezy.com/my-orders)


# 在第三方应用中接入 Chatbox AI

Chatbox AI 提供 OpenAI 兼容的 API 接口，您可以在支持 OpenAI API 的第三方应用中使用 Chatbox AI 服务。

## API 配置信息

| 配置项      | 值                          |
| -------- | -------------------------- |
| API Host | `https://ai.chatboxai.app` |
| API Key  | 您的 Chatbox AI License Key  |

## 获取 API Key

1. 登录 [Chatbox AI](https://chatboxai.app) 账户
2. 进入Dashboard页面
3. 复制你的 License Key

## 在常见应用中配置

### Cursor

1. 打开 Cursor 设置
2. 找到 **Models** > **OpenAI API Key** 配置项
3. 填入您的 API Key
4. 在 **Override OpenAI Base URL** 中填入：`https://ai.chatboxai.app/v1`

### Continue (VS Code 插件)

在 `~/.continue/config.json` 中添加配置：

```json
{
  "models": [
    {
      "title": "Chatbox AI",
      "provider": "openai",
      "model": "gemini-3-pro",
      "apiKey": "your-chatbox-license-key",
      "apiBase": "https://ai.chatboxai.app/v1"
    }
  ]
}
```

### Cherry Studio

1. 打开设置 > 模型服务商
2. 添加新的服务商，选择 **OpenAI API** 类型
3. API 地址填入：`https://ai.chatboxai.app/v1`
4. 填入您的 API Key

### Open WebUI

1. 进入管理员设置
2. 在 **Connections** > **OpenAI API** 中配置
3. API Base URL：`https://ai.chatboxai.app/v1`
4. API Key：填入您的密钥

### 其他支持 OpenAI API 的应用

大多数支持 OpenAI API 的应用都可以通过以下方式接入：

1. 找到 OpenAI API 或自定义 API 配置选项
2. 将 API Base URL 设置为：`https://ai.chatboxai.app/v1`
3. 填入您的 Chatbox AI API Key（License Key）
4. 选择需要使用的模型

## 可用模型

根据您的订阅方案，可以使用以下模型：

**高级模型（Pro/Pro+ 方案）**

* `gpt-5` - GPT 5
* `claude-4.5-sonnet` - Claude 4.5 Sonnet
* `gemini-3-pro` - Gemini 3 Pro

**标准模型（所有付费方案）**

* `deepseek-chat` - DeepSeek V3
* `deepseek-reasoner` - DeepSeek R1
* `deepseek-v3.2` - DeepSeek V3.2
* `kimi-k2` - Kimi K2
* `gpt-5-mini` - GPT 5-mini
* `gemini-2.5-flash` - Gemini 2.5 Flash

> 注意：模型名称可能更新，请以 Chatbox AI 官网为准。

## 常见问题

### API 请求失败

* 检查 API Key 是否正确
* 确认 API Host 地址是否正确（注意 https 和末尾是否有斜杠）
* 确认您的订阅方案是否有效

### 模型不可用

* 检查您的订阅方案是否支持该模型
* 确认模型名称是否正确

### 点数消耗

使用 API 接入与在 Chatbox 客户端中使用相同，都会消耗您账户中的计算点数。请注意监控您的点数使用情况。

## 相关链接

* [付费方案说明](/chatbox-ai-premium/plans)
* [订阅管理](/chatbox-ai-premium/subscription-management)


# 常见问题


# 付费后，如何重新找回 license？

通过下面的链接，输入购买 license 时填写的邮箱，如果该邮箱的确购买过，就会重新发送一遍 license。

> [找回 License Key忘记 License Key？通过电子邮件找回您的 License Key](https://chatboxai.app/zh/help-center/retrieve-license-key)


# 模型输出乱码怎么办？

尝试在设置中调整 Tempurature 值，例如调整到 0.7 以下。

> Temperature 是一个控制 LLM 生成结果随机性的参数。
>
> * 当 Temperature 较低时(如 0.1)，生成结果更加确定和保守,更接近训练数据分布。
> * 当 Temperature 较高时(如 1.0)，生成结果更加随机和多样,可能会出现一些意外和创新的内容。
>
> 通过调整 Temperature 值,可以控制 LLM 输出的创造性和风险性。较低的 Temperature 更适合需要可靠和一致性的任务,而较高的 Temperature 可以用于鼓励创造性和探索性的应用场景。


# 我的数据存储在哪里？

Chatbox 高度重视您的数据隐私与安全。在使用 Chatbox 应用程序时，您的所有聊天消息和设置数据都存储在您的设备上。未经您的许可，Chatbox 不会将您的任何数据上传到任何服务器。

当您在 Chatbox 应用程序中使用 Chatbox AI 模型服务（这是推荐的方法）时，您发送给 AI 的消息以及一些上下文和您上传的任何图片或文件将被传输到 Chatbox AI 服务以生成 AI 回复。Chatbox AI 服务仅使用您发送的数据来生成 AI 回复，您的数据可能会暂时存储在 Chatbox AI 的服务器上，以加快后续查询的响应速度。Chatbox AI 不会永久存储您的数据，也不会将其用于其他目的，包括但不限于广告、模型训练或任何其他商业用途。

除了使用 Chatbox AI 模型服务外，当您使用第三方 API 服务在 Chatbox 应用程序中运行其他模型时，我们无法保证您的数据的隐私和安全。您需要查看这些第三方模型服务的隐私政策和服务条款，以了解您的数据可能如何使用。如果您优先考虑隐私和安全，请考虑选择 Chatbox AI 服务。


# 常见错误代码

* 4xx（客户端错误状态码）：一般为请求语法错误、鉴权失败或认证失败等无法完成请求。
* 5xx（服务器错误状态码）：一般为服务端错误，服务器宕机、请求处理超时等。

| 错误码 | 可能情况                                        | 解决方案              |
| --- | ------------------------------------------- | ----------------- |
| 400 | 请求语法错误,无法被服务器理解。可能是参数传递错误、格式不正确等            | 检查请求参数并修正         |
| 401 | 未经授权访问,一般是鉴权失败或认证失败                         | 检查登录凭证是否正确        |
| 403 | 服务器理解请求但拒绝执行,可能是权限不足                        | 解决方案是检查用户权限是否配置正确 |
| 404 | 请求的资源不存在                                    | 检查请求路径是否正确        |
| 429 | 未实名用户：每天仅能访问 100次。如果当天访问次数超过 100次，将收到429错误。 | 尝试去模型服务提供商进行实名认证； |
| 500 | 服务器内部错误,通常是代码bug或服务宕机                       | 检查服务器日志,修复代码问题    |
| 502 | 作为网关或代理的服务器,从上游服务器接收到无效响应                   | 检查上游服务是否正         |
| 503 | 服务器暂时无法处理请求,可能是服务器超载或正在维护                   | 扩容服务器资源或等待服务恢复    |


# 为什么模型说自己是别的模型？

有时候，当您直接询问模型"你是什么模型？"时，模型可能会给出一个错误的答案——比如声称自己是 GPT-4、GPT-3.5，或者其他模型。这可能会让您产生疑虑：我付费使用的模型是不是被偷换成了便宜的模型？

请放心，这**不是以次充好**，而是大语言模型（LLM）的一个普遍技术特性。

## 为什么会这样？

大语言模型在训练时，会从互联网上的海量文本中学习，包括新闻、文章、书籍、论坛帖子等。然而，**模型的名称和身份是在训练完成后才确定的**，并不在训练数据中。

可以这样理解：就像一个孩子在成长过程中学习了大量知识，但如果从来没人告诉过他自己叫什么名字，当被问到"你叫什么？"时，他只能根据学过的内容去猜测。

由于训练数据中充满了关于各种模型的讨论（比如"GPT-4 很强"、"我在使用 Claude"等），模型在被问到自己是什么时，可能会凭借这些训练数据中的模式，给出一个错误的回答。

## 提供商如何解决这个问题？

模型提供商通常通过\*\*系统提示词（System Prompt）\*\*来告诉模型它的身份。例如，Anthropic 的官方系统提示词以"The assistant is Claude, made by Anthropic"开头。

但这种方法有局限性：如果第三方应用修改或省略了系统提示词，模型就可能"忘记"自己的身份，给出错误的答案。

## 为什么这不是欺诈的证据？

直接询问模型"你是什么模型"来验证其身份**不是一个可靠的方法**，原因如下：

1. **模型的回答来自统计推测**，而不是真正的"自我认知"
2. **系统提示词可能被修改或省略**，导致模型无法正确识别自己
3. **不同的模型都可能说自己是 GPT-4**，这不能作为判断真伪的依据

## 如何真正验证使用的是什么模型？

如果您想确认 Chatbox AI 使用的是正确的模型，可以通过以下方式：

1. **使用专业的模型评测工具**，如 [16x Eval](https://eval.16x.engineer/) 等第三方评测工具，通过标准化的 benchmark 测试对比模型能力
2. **对比模型的实际能力表现**，如推理能力、代码能力、知识范围等，高端模型在复杂任务上的表现会明显优于低端模型
3. **观察模型的特征性行为**，不同模型在输出风格、格式偏好、处理特定问题的方式上有明显差异

Chatbox AI 承诺为用户提供准确标注的模型服务，我们不会用低端模型替代高端模型。

## 延伸阅读

* [The Identity Crisis: Why LLMs Don't Know Who They Are](https://eval.16x.engineer/blog/llm-identity-crisis-models-dont-know-who-they-are) - 一篇详细解释这一现象的英文博客


# 商务合作

你可以通过邮箱 <hi@chatboxai.com> 和我们联系沟通。


# 隐私政策

### Privacy Policy

Effective date: 2023-08-29

Chatbox ("we", "us", "our") operates the Chatbox application ("Service"). We are committed to protecting the privacy of our users ("you"). This Privacy Policy outlines our policies regarding the collection, use, and disclosure of personal information we receive from users of the Service.

By using the Service, you agree to the collection and use of information in accordance with this Privacy Policy. This policy is incorporated into our Terms of Service, which also apply when you use our Service.

#### Collection and Use of Personal Information

We do not collect any personal data that could be used to identify you unless it is specifically and knowingly provided by you. Chatbox is primarily a client application that stores all personal chat data directly on your device, ensuring your privacy and control over your conversations.

The Service is designed to avoid the collection or retention of sensitive personal data. Chatbox will not collect or store any chat logs on our servers. The only time the Service may handle personal data is when:

* 1\. A user opts to use the Chatbox AI online service, in which case the current conversation's messages are transmitted to our servers solely for the purpose of generating AI responses. These messages are processed in real-time and are not stored on our servers after the AI response is generated.
* 2\. A user subscribes to the Chatbox AI subscription service. We only collect necessary information such as email addresses, billing addresses, or payment details through our associated sales platform, Lemonsqueezy. These details are used exclusively for processing subscriptions and providing customer support.

We may also collect non-personally identifiable information that your device provides in the normal course of interacting with our Service, such as device type, operating system, and application configurations, known as Log Data. This Log Data may include details like your IP address to help diagnose issues with our service, administer the Service, and analyze trends.

#### Use of Third-Party Services

Our Service may use third-party tools and services to assist in analytics, service optimization, or for technical support. These may include:

* [Google Analytics](https://www.google.com/analytics/terms/)
* [Sentry](https://sentry.io/privacy/)
* [Lemonsqueezy](https://www.lemonsqueezy.com/privacy)

These third-party services have their own Privacy Policies, which we recommend you review.

#### Cookies and Tracking Technologies

Chatbox does not directly use cookies. However, some third-party services we utilize may use cookies or similar tracking technologies to monitor interactions with our Service. You have the option to either accept or decline these cookies and should refer to your browser settings for managing your preferences.

#### Security

The security of your Personal Information is important to us. We strive to use commercially acceptable means to protect your information, but no method of transmission over the Internet or electronic storage is completely secure. While we cannot guarantee absolute security, we are dedicated to protecting your information.

#### Links to Other Websites

The Service may contain links to other websites not operated by us. If you click on a third-party link, you'll be directed to that website. We strongly advise you to review the Privacy Policy of every site you visit as we have no control over, and assume no responsibility for, the content or privacy practices of any third-party sites.

#### Children's Privacy

Our Service does not target and is not intended for children under the age of 13. We do not knowingly collect personally identifiable information from children under 13. If we become aware that we have collected Personal Information from a child without verification of parental consent, we take steps to remove that information from our servers.

#### Privacy Policy Updates

We reserve the right to update or change our Privacy Policy at any time. Changes to this Privacy Policy are effective when posted on this page. We will notify users of any changes by updating the information on this page and through the Service.

#### Contact Information

If you have any questions about this Privacy Policy, please contact us at <hi@chatboxai.com>.

By using Chatbox, you consent to this Privacy Policy.


# 用户协议

### Terms & Conditions

By downloading or using the app, these terms will automatically apply to you – you should make sure therefore that you read them carefully before using the app. You're not allowed to copy or modify the app, any part of the app, or our trademarks in any way. You're not allowed to attempt to extract the source code of the app, and you also shouldn't try to translate the app into other languages or make derivative versions. The app itself, and all the trademarks, copyright, database rights, and other intellectual property rights related to it, still belong to Benn.

Benn is committed to ensuring that the app is as useful and efficient as possible. For that reason, we reserve the right to make changes to the app or to charge for its services, at any time and for any reason. We will never charge you for the app or its services without making it very clear to you exactly what you're paying for.

The Chatbox app stores and processes personal data that you have provided to us, to provide my Service. It's your responsibility to keep your devices and access to the app secure. We therefore recommend that you do not jailbreak or root your system, which is the process of removing software restrictions and limitations imposed by the official operating system of your device. It could make your device and system vulnerable to malware/viruses/malicious programs, compromise your device and system's security features and it could mean that the Chatbox app won't work properly or at all.

The app does use third-party services that declare their Terms and Conditions.

Link to Terms and Conditions of third-party service providers used by the app

* [Google Analytics for Firebase](https://firebase.google.com/terms/analytics)
* [Sentry](https://sentry.io/terms/)

You should be aware that there are certain things that Benn will not take responsibility for. Certain functions of the app will require the app to have an active internet connection. The connection can be Wi-Fi or provided by your mobile network provider, but Benn cannot take responsibility for the app not working at full functionality if you don't have access to Wi-Fi, and you don't have any of your data allowance left.

If you're using the app outside of an area with Wi-Fi, you should remember that the terms of the agreement with your mobile network provider will still apply. As a result, you may be charged by your mobile provider for the cost of data for the duration of the connection while accessing the app, or other third-party charges. In using the app, you're accepting responsibility for any such charges, including roaming data charges if you use the app outside of your home territory (i.e. region or country) without turning off data roaming. If you are not the bill payer for the device on which you're using the app, please be aware that we assume that you have received permission from the bill payer for using the app.

Along the same lines, Benn cannot always take responsibility for the way you use the app i.e. You need to make sure that your device stays charged – if it runs out of battery and you can't turn it on to avail the Service, Benn cannot accept responsibility.

With respect to Benn's responsibility for your use of the app, when you're using the app, it's important to bear in mind that although we endeavor to ensure that it is updated and correct at all times, we do rely on third parties to provide information to us so that we can make it available to you. Benn accepts no liability for any loss, direct or indirect, you experience as a result of relying wholly on this functionality of the app.

At some point, we may wish to update the app. The app is currently available on Windows, Mac and Linux & Web – the requirements for the both systems(and for any additional systems we decide to extend the availability of the app to) may change, and you'll need to download the updates if you want to keep using the app. Benn does not promise that it will always update the app so that it is relevant to you and/or works with the Windows, Mac and Linux & Web version that you have installed on your device. However, you promise to always accept updates to the application when offered to you, We may also wish to stop providing the app, and may terminate use of it at any time without giving notice of termination to you. Unless we tell you otherwise, upon any termination, (a) the rights and licenses granted to you in these terms will end; (b) you must stop using the app, and (if needed) delete it from your device.

**Changes to This Terms and Conditions**

I may update our Terms and Conditions from time to time. Thus, you are advised to review this page periodically for any changes. I will notify you of any changes by posting the new Terms and Conditions on this page.

These terms and conditions are effective as of 2023-08-29

#### **Commercial License Terms**

**1. Free Commercial Use**

Users are permitted to use the software for commercial purposes without charge, provided that no modifications are made to the original code.

**2. Commercial License Requirements**

A commercial license is required if any of the following conditions are met:

* Secondary modification or development of the software (including but not limited to modifying the application name, logo, code, or functionality).
* Providing multi-tenant services to enterprise clients that support 10 or more users.
* Pre-installation or integration into hardware devices or products for bundled sales.
* Large-scale procurement projects by government or educational institutions, especially when involving security and data privacy requirements.

**Contact Us**

If you have any questions or suggestions about my Terms and Conditions, do not hesitate to contact me at <hi@chatboxai.com>.


