功能特性

AQBot 是一款功能全面的 AI 桌面客户端，覆盖了从多模型对话、内容渲染、知识管理到 API 网关等完整的 AI 工作流。以下是各项功能的详细介绍。

对话与模型

AQBot 提供灵活强大的多模型对话能力，让你在一个客户端中管理所有 AI 服务。

• 多供应商支持 — 兼容 OpenAI、Anthropic Claude、Google Gemini 等主流服务商，以及所有 OpenAI 兼容 API 格式的自定义端点
• 模型管理 — 支持远程拉取模型列表，并可自定义温度、最大 Token、Top-P 等推理参数
• 多密钥轮询 — 每个供应商可配置多个 API Key，系统自动轮换使用，有效分散限流压力
• 流式输出 — 实时逐 Token 渲染回复内容，thinking 块支持折叠与展开
• 消息版本 — 每条回复支持保存多个版本，方便对比不同模型或参数下的生成效果
• 对话分支 — 从任意消息节点派生新分支，探索不同对话方向，支持分支间对比
• 对话管理 — 支持置顶、归档、按时间分组、批量操作等多种管理方式

提示

配置多个 API Key 后，AQBot 会自动在请求之间轮换密钥，即使单个密钥触发速率限制也不会中断使用。

内容渲染

AI 回复中的各种格式内容都能得到精准渲染，提供出色的阅读和交互体验。

• Markdown 渲染 — 完整支持代码高亮、LaTeX 数学公式、表格、任务列表等 Markdown 语法
• Monaco 代码编辑器 — 代码块内嵌 Monaco Editor，支持语法高亮、一键复制和 diff 预览
• 图表渲染 — 内置 Mermaid 流程图与 D2 架构图渲染引擎，直接在对话中可视化图表
• Artifact 面板 — 代码片段、HTML 草稿、Markdown 笔记、报告等内容可在独立面板中实时预览
• 实时语音对话 — 基于 WebRTC 的实时语音交互，兼容 OpenAI Realtime API

搜索与知识

让 AI 不再局限于训练数据，实现联网搜索与本地知识的无缝融合。

• 联网搜索 — 集成 Tavily、智谱 WebSearch、Bocha 等搜索引擎，搜索结果附带引用来源标注
• 本地知识库（RAG） — 上传文档后自动构建向量索引（LanceDB），对话时语义检索相关段落
• 记忆系统 — 支持全局记忆与项目级记忆，可手动添加或由 AI 自动提取关键信息
• 上下文管理 — 灵活挂载文件附件、搜索结果、知识库片段、记忆条目和工具输出作为对话上下文

即将推出

本地知识库（RAG）和记忆系统目前正在开发中，将在后续版本中正式发布。

工具与扩展

通过 MCP 协议和内置工具，让 AI 具备操作外部系统的能力。

• MCP 协议 — 完整实现 Model Context Protocol，支持 stdio 和 HTTP 两种传输方式
• 内置工具 — 提供文件读写、Shell 命令执行、截图等开箱即用的内置工具
• 工具执行面板 — 可视化展示工具调用的请求参数与返回结果，方便调试和审查
• 命令面板 — Cmd/Ctrl+K 唤起全局命令面板，快速跳转和执行各种操作

API 网关

AQBot 内置一个功能完整的本地 API 网关，让你的其他工具也能共享 AI 服务配置。

• 本地 API 服务器 — 提供 OpenAI 兼容、Claude 原生、Gemini 原生等多种接口格式，可作为任意兼容客户端的后端
• API 密钥管理 — 生成、撤销、启停访问密钥，支持描述备注
• 用量统计 — 按密钥、供应商、日期等维度统计请求量与 Token 用量
• 程序策略 — 为每个接入程序独立配置模型白名单与速率限制
• SSL/TLS 支持 — 内置自签名证书自动生成，也支持挂载自定义证书
• 请求日志 — 完整记录所有经过网关的 API 请求与响应，便于排查问题
• 配置模板 — 预置 Claude Code、Codex CLI、OpenCode、Gemini CLI 等常见工具的接入配置模板，开箱即用

使用场景

通过 API 网关，你可以让 Cursor、VS Code Copilot、命令行工具等第三方客户端统一经由 AQBot 转发请求，实现密钥统一管理和用量集中监控。

数据与安全

AQBot 将隐私和数据安全放在首位，所有数据完全存储在本地。

• AES-256 加密 — API Key 等敏感数据使用 AES-256 加密存储于本地数据库，主密钥文件权限设为 0600
• 数据目录隔离 — 应用状态存储于 ~/.aqbot/，用户文件（图片、文档、备份）存储于 ~/Documents/aqbot/，互不干扰
• 自动备份 — 支持定时自动备份到本地目录、WebDAV 或 S3 兼容的对象存储
• 备份恢复 — 一键从历史备份恢复完整数据
• 对话导出 — 支持将对话导出为 PNG 截图、Markdown、纯文本或 JSON 格式

注意

主密钥文件 ~/.aqbot/master.key 是解密所有敏感数据的凭证，请勿手动修改或删除。迁移数据时需确保数据库与主密钥文件配对迁移。

桌面体验

作为原生桌面应用，AQBot 提供流畅的操作体验和丰富的系统集成。

• 主题切换 — 支持深色 / 浅色主题，可跟随系统设置或手动指定
• 界面语言 — 完整支持简体中文与英文，可在设置中随时切换
• 系统托盘 — 关闭窗口时最小化到系统托盘，后台服务不中断
• 窗口置顶 — 可将主窗口常驻最顶层，随时查看 AI 回复
• 全局快捷键 — 自定义全局快捷键，随时从任何应用唤起 AQBot 主窗口
• 开机自启 — 可选择随系统自动启动，确保 API 网关等后台服务常驻
• 代理支持 — 支持 HTTP 和 SOCKS5 代理配置，适配各种网络环境
• 自动更新 — 启动时自动检测新版本并提示更新，保持客户端始终最新