Chatbox 接入教程

跨平台桌面 AI 客户端，简洁易用，支持 Windows/macOS/Linux

什么是 Chatbox?

Chatbox 是一款开源的跨平台 AI 桌面客户端，提供简洁优雅的界面，支持多种 AI 模型和服务商。

💻

跨平台

支持 Windows / macOS / Linux

🎨

精美界面

现代化 UI 设计，深色/浅色主题

🔌

多模型支持

GPT、Claude、Gemini 等主流模型

📝

Markdown

完整的 Markdown 渲染支持

🔒

数据本地

所有数据存储在本地，隐私安全

⚡

轻量快速

启动迅速，占用资源少

💡 适用场景：
• 个人日常使用的 AI 助手
• 需要离线或本地保存对话记录
• 喜欢简洁清爽的桌面应用
• 多平台切换使用

下载安装

访问官网下载

下载地址
# 官方 GitHub 仓库
https://github.com/Bin-Huang/chatbox

# 根据你的操作系统选择对应版本：
# Windows: .exe 安装包 或 .msi
# macOS: .dmg 文件（Intel/M1 自选）
# Linux: .AppImage 或 .deb

安装步骤

平台步骤
Windows 下载 .exe → 双击运行 → 一路 Next → 完成
macOS 下载 .dmg → 打开 → 拖到 Applications
Linux 下载 .AppImage → 添加执行权限 → 运行

配置 XiDao Api

首次配置向导

  1. 启动 Chatbox 应用程序
  2. 首次打开会进入配置向导
  3. 选择 API 提供商类型：OpenAI API Compatible
  4. 填写以下配置信息：
配置信息
API Base URL: https://api.xidao.online/v1
API Key:      sk-你的API_KEY
Model:        gpt-4o (或其他支持的模型)

手动修改配置

如果需要修改配置，可以通过以下路径：

  1. 点击左下角 设置图标 ⚙️
  2. 选择 模型提供方 选项卡
  3. 找到 API 地址 和 API Key 字段
  4. 修改为 XiDao Api 的配置：
配置详情
字段名称          值
─────────────────────────────────────
API 提供商       OpenAI API Compatible
API 地址         https://api.xidao.online/v1
API Key          sk-你的API_KEY
默认模型         gpt-4o (可自由选择)
⚠️ 注意：API 地址末尾必须包含 /v1，否则会连接失败。

使用指南

基本操作

  • 发送消息：在底部输入框输入内容，按 Enter 发送
  • 换行：按 Shift + Enter 换行
  • 新建对话：点击左上角 + 新建对话
  • 切换对话：在左侧边栏选择历史对话
  • 删除对话：右键对话 → 删除

切换模型

  1. 点击顶部工具栏的模型名称
  2. 从下拉列表中选择其他模型
  3. 常用推荐：
    • gpt-4o - 综合性能最强
    • gpt-4o-mini - 性价比高，速度快
    • claude-sonnet-4-5-20250929 - 推理能力强
    • gemini-2.5-pro - Google 最新模型

导出对话

Chatbox 支持将对话导出为多种格式：

  • Markdown (.md) - 适合文档归档
  • 纯文本 (.txt) - 通用格式
  • 图片 (PNG) - 方便分享

核心功能

Markdown 渲染

完整支持 Markdown 格式，包括：

  • 标题、粗体、斜体
  • 代码块（带语法高亮）
  • 列表、表格
  • 链接、图片
  • 数学公式（LaTeX）

多话题管理

可以同时维护多个独立的对话话题，方便不同场景使用。

快捷键

快捷键功能
Enter发送消息
Shift + Enter换行
Ctrl/Cmd + N新建对话
Ctrl/Cmd + Shift + P切换开发者模式
Ctrl/Cmd + ,打开设置

使用技巧

💡 提高使用体验的建议：

1. 选择合适的模型
• 日常简单问答：使用 gpt-4o-mini 或 gemini-2.5-flash
• 复杂推理任务：使用 claude-sonnet-4-5 或 gpt-4o
• 代码生成：使用 codex 系列模型

2. 利用 Prompt 技巧
• 明确指定输出格式（如 JSON、Markdown 表格）
• 提供足够的上下文信息
• 使用示例来引导输出风格

3. 数据备份
• 定期导出重要对话
• 对话数据存储在本地 AppData 目录
• 重装系统前注意备份

常见问题

Q: 连接失败怎么办？
A: 检查 API 地址是否正确（需包含 /v1），确认网络连接正常。

Q: 如何更新版本？
A: 访问 GitHub 下载最新版安装覆盖即可，数据不会丢失。

Q: 支持哪些模型？
A: 支持 XiDao Api 平台提供的所有 OpenAI 兼容格式模型。

📚 相关资源