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

# ChatHub

> ChatHub 浏览器扩展集成指南

> 一款浏览器扩展 AI 客户端，支持同屏对比多家模型回答，通过 GravitexAI 统一接入 100+ 模型

## 一、产品简介

ChatHub 是一款 Chrome / Edge 浏览器扩展，支持同时使用多个 AI 模型，只需一次输入，即可同时接收来自多达六个 AI 模型的回复，并把各家回答并排展示，帮你快速判断哪个模型最适合当前问题。通过 GravitexAI 你可以在 ChatHub 中统一接入 OpenAI、Claude、Gemini、DeepSeek、Qwen 等 100+ 主流模型。

## 二、核心能力：同屏对比模型

ChatHub 与其他客户端最大的区别是**多模型并行问答**：

* 在同一个标签页里向 2\~6 个模型同时发送问题
* 把各家的回答以**并排 / 表格**两种视图对比
* 支持任意组合：GPT-5.5 + Claude Opus 4.7 + Gemini 3 Pro + DeepSeek V4 一起跑
* 对比视图支持 Markdown 渲染、代码高亮、图片预览

<Tip>
  **适用场景**

  * 写代码 / 改 Bug 时同时看 GPT-5.5 和 Claude Opus 4.7 的修复方案
  * 长文写作时对比 Claude Sonnet 与 Qwen3.7 的中文表达
  * 翻译 / 摘要时把同一段话丢给 GPT-5.5、Gemini 3 Flash 和 DeepSeek V4
  * 选型阶段：拿同一道题测试多个模型，决定后续主力用谁
</Tip>

## 三、安装

<Tabs>
  <Tab title="浏览器扩展">
    **方式一：商店在线安装（推荐）**

    1. Chrome 网上应用商店搜索：ChatHub‑All‑in‑One Chatbot（开发者：chathub.gg）
    2. 点击添加至 Chrome → 添加扩展程序
    3. 浏览器右上角拼图图标（扩展），找到 ChatHub，点击固定到工具栏

    **方式二：手动离线安装（无商店网络）**

    1. GitHub 下载 Release 源码 zip 包
    2. 地址栏输入 `chrome://extensions/`，打开开发者模式
    3. 加载已解压的扩展程序，选择解压后的 dist 文件夹完成安装
  </Tab>

  <Tab title="桌面端">
    访问 [https://chathub.gg/zh-CN/download](https://chathub.gg/zh-CN/download) 下载安装 ChatHub。
  </Tab>
</Tabs>

<Tip>
  * 仅浏览器扩展具备【自定义聊天机器人】
  * 网页版 app.chathub.gg、桌面客户端：暂无自定义 API 入口
  * GitHub 自定义聊天机器人**仅支持 OpenAI 兼容协议 API**
</Tip>

## 四、快速接入（OpenAI 兼容格式）

这是最通用的接入方式，支持 GravitexAI 全部 100+ 模型。

### 第 1 步：获取 GravitexAI API Key

1. 访问 [GravitexAI 控制台](https://maas.gravitex.ai/#/api-keys)
2. 点击「新建 API 密钥」，命名并保存
3. 复制以 `sk-` 开头的密钥备用

### 第 2 步：打开 ChatHub 设置

1. 在浏览器扩展程序中点击 ChatHub 图标，进入 ChatHub 扩展弹窗
2. 点击左下角 **Settings**（齿轮图标），进入完整设置页面
3. 向下滚动找到【自定义机器人】，点击【添加】

<img src="https://mintcdn.com/gravitexai/U0V-NTeQV7PqxAVn/images/chathub1.png?fit=max&auto=format&n=U0V-NTeQV7PqxAVn&q=85&s=ff38bf79f17da5b36834e1c257517bbe" alt="打开 ChatHub 设置并添加自定义机器人" width="1024" height="547" data-path="images/chathub1.png" />

### 第 3 步：添加 GravitexAI 提供商

<img src="https://mintcdn.com/gravitexai/U0V-NTeQV7PqxAVn/images/chathub2.png?fit=max&auto=format&n=U0V-NTeQV7PqxAVn&q=85&s=36ceb182b37b40c96debb3227285c532" alt="配置 GravitexAI 自定义机器人" width="1024" height="486" data-path="images/chathub2.png" />

| 字段           | 填写值                                                                                     | 说明                                                      |
| ------------ | --------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| **名称**       | `自定义`                                                                                   | 自定义输入                                                   |
| **API Host** | 下拉框选择 OpenAI，下方地址栏填 `https://api.gravitex.ai/v1`                                        | **必须包含 /v1 后缀**                                         |
| **API Key**  | 如 `sk-...`                                                                              | 粘贴上一步获取的 GravitexAI 令牌                                  |
| **模型**       | 填入想用的模型 ID，如 `claude-sonnet-5`、`gpt-5.5`、`deepseek-v4-pro`、`kimi-k3`、`gemini-3.6-flash` | 填写要使用的 [规范模型 ID](https://maas.gravitex.ai/#/api-models) |

可选高级选项：

1. **支持图片输入**：
   * 勾选后，ChatHub 输入框才会出现上传图片按钮，允许你粘贴 / 上传图片发给这个模型
   * 不勾选：上传图片按钮直接隐藏，就算模型本身支持识图，界面上也不能传图片
2. **支持 function calling**：当模型支持工具调用时勾选
3. **高级设置**：默认折叠，按需展开

<Warning>
  **配置要点**

  * API Host 地址栏必须包含 `/v1` 后缀
  * 支持图片输入：勾选只是放开客户端上传入口；如果后端模型实际不支持图片，勾选了发送图片依然会报错
  * 配置完成后无需重启浏览器，立即生效
</Warning>

### 第 4 步：选择模型

设置完成后，回到 ChatHub 主界面，从下拉菜单中即可看到你添加的模型列表，任意切换使用。

## 五、三种使用模式

| 模式        | 触发方式                    | 适用场景                |
| --------- | ----------------------- | ------------------- |
| **单模型对话** | 像普通 ChatGPT 一样与一个模型对话   | 日常问答、单模型擅长的任务       |
| **多模型对比** | 在输入框右侧勾选 2\~6 个模型一起发送   | 选型测试、寻找最佳答案         |
| **网页助手**  | 选中任意网页文字，弹出 ChatHub 工具栏 | 阅读论文时翻译 / 总结、写邮件时润色 |

<Tip>
  **对比模式小技巧**

  * 对比模式下，每个模型的回复都是**独立**的，左侧主对话栏显示默认模型
  * 想要导出所有模型的回答？点击对话右上角的 **Export** 按钮，支持 Markdown / JSON / PNG
  * 对比时建议选 **风格差异大**的模型组合，例如「GPT-5.5 + Claude Opus 4.7 + DeepSeek V4」，更容易看出区别
</Tip>

## 六、进阶配置：多家对比的最强玩法

ChatHub 的杀手锏是「同时跑多家厂商」。通过 GravitexAI 一次接入就能在对比中混搭任意厂商的模型。

### 对比组合推荐

| 任务类型              | 推荐模型组合                                           | 理由             |
| ----------------- | ------------------------------------------------ | -------------- |
| **代码生成 / Bug 修复** | GPT-5.5 + Claude Opus 4.7 + DeepSeek V4          | 主流编程能力 + 国产性价比 |
| **长文写作 / 创意**     | Claude Sonnet 4.5 + Qwen3.7-Max + GPT-5.5        | 中文表达 + 西式叙事    |
| **翻译 / 多语言**      | GPT-5.5 + Gemini 3 Flash + DeepSeek V4           | 三家互为校验         |
| **推理 / 数学**       | GPT-5.5 (xhigh) + Claude Opus 4.7 + Gemini 3 Pro | 三大推理顶配         |

## 七、支持的模型

通过 GravitexAI，ChatHub 支持 100+ 主流 AI 模型，包括 OpenAI、Google Gemini、Claude、DeepSeek、国产模型等。

<Card title="查看当下热门模型推荐" icon="star" href="https://maas.gravitex.ai/#/api-models">
  查看最新的模型推荐、性能对比和场景化使用建议。覆盖文本创作、编程开发、快速响应、图像生成、视频生成等全场景。
</Card>

<Info>
  **为什么不在此列出具体模型？**

  AI 模型更新迭代速度非常快，为了确保你获取最准确的模型推荐信息，我们统一在 [模型推荐页面](https://maas.gravitex.ai/#/api-models) 维护最新的模型列表、性能数据和使用建议。
</Info>

## 八、故障排除

<AccordionGroup>
  <Accordion title="连接失败">
    1. 确认 API 密钥以 `sk-` 开头且没有粘多余空格
    2. 检查 API Base URL：`https://api.gravitex.ai/v1`
    3. 在 [GravitexAI 控制台](https://maas.gravitex.ai/#/api-keys) 检查令牌是否启用、余额是否充足
    4. 余额不足也会返回 401，确认账户余额
  </Accordion>

  <Accordion title="模型不显示">
    * 等待模型列表自动刷新
    * 手动点击「刷新模型」按钮
    * 检查 API 密钥权限
  </Accordion>

  <Accordion title="对比模式只显示一家">
    * 检查是否在输入框右侧勾选了多个模型
    * 确认所有模型都来自同一个 provider（或不同 provider 但都已配置）
  </Accordion>

  <Accordion title="响应速度慢">
    * 尝试切换到更快的模型
    * 检查网络延迟
    * 减少上下文长度
  </Accordion>
</AccordionGroup>

## 九、最佳实践

### 性能优化

1. **合理选择模型**
   * 根据任务复杂度选择合适的模型
   * 查看 [模型推荐](https://maas.gravitex.ai/#/api-models) 页面获取最新的模型选择建议

2. **对比策略**
   * 同质模型（如两个 GPT）对比意义不大
   * 选择**能力侧重不同**的模型：编程、写作、推理、翻译各选一家
   * 不要一次性对比超过 4 个模型，token 消耗会成倍增长

3. **资源管理**
   * 监控 API 使用量
   * 设置使用限额提醒
   * 定期更新扩展版本

### 安全建议

* 不要分享 API 密钥
* 定期更换密钥
* 使用强密码保护浏览器
* 谨慎处理敏感信息

### 团队协作

虽然 ChatHub 主要面向个人用户，但可以通过以下方式支持团队：

* 共享提示词模板
* 导出对话记录分享
* 统一 API 配置标准

## 十、对比优势

### vs 其他客户端

| 特性          | ChatHub  | 单模型客户端 | 其他扩展 |
| ----------- | -------- | ------ | ---- |
| **同屏对比多模型** | ✅ 核心能力   | ❌      | 少数支持 |
| **浏览器侧边栏**  | ✅        | ❌      | 部分   |
| **网页助手**    | ✅        | ❌      | 部分   |
| **自定义 API** | ✅        | ✅      | ✅    |
| **跨平台同步**   | ✅（浏览器同步） | ❌      | 视实现  |
| **对话历史本地**  | ✅        | 视实现    | 视实现  |

### 选择 ChatHub 的理由

1. **选型利器**：同时跑多家模型是它无法替代的价值
2. **多模型混合调用**：OpenAI / Claude / Gemini / 国产模型任意组合
3. **网页沉浸**：作为浏览器扩展，任何网页都能调用
4. **隐私优先**：对话本地存储，扩展不收集你的数据
5. **持续更新**：活跃的开发维护

<Info>
  **更多帮助**：技术支持联系 [bd@gravitex.ai](mailto:bd@gravitex.ai)，或致电 13603055233。
</Info>