功能特性

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

对话与模型

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

• 多供应商支持 — 兼容 OpenAI、Anthropic Claude、Google Gemini 等主流服务商，以及所有 OpenAI 兼容 API 格式的自定义端点
• 服务商链接导入 — 服务商官网或后台可以通过 aqbot:// 链接拉起 AQBot，在用户确认后自动填充名称、Base URL、API Key 和服务商类型。查看配置服务商。
• 模型管理 — 支持远程拉取模型列表，并可自定义温度、最大 Token、Top-P 等推理参数
• 多密钥轮询 — 每个供应商可配置多个 API Key，系统自动轮换使用，有效分散限流压力
• 流式输出 — 实时逐 Token 渲染回复内容，thinking 块支持折叠与展开
• 消息版本 — 每条回复支持保存多个版本，方便对比不同模型或参数下的生成效果
• 对话分支 — 从任意消息节点派生新分支，探索不同对话方向，支持分支间对比
• 对话管理 — 支持置顶、归档、按时间分组、批量操作等多种管理方式
• 对话压缩 — 自动压缩冗长对话，保留关键信息以节省上下文空间
• 多模型同答 — 同一问题同时向多个模型提问，支持答案间对比分析

提示

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

AI Agent

AQBot 内置 Agent 模式，让 AI 能够自主执行多步骤任务，并提供精细的权限控制。

• Agent 模式 — 将任意对话切换至 Agent 模式，AI 可自主读写文件、执行命令、分析代码、完成复杂的多步骤工作流——全部在受控环境中运行
• 三级权限 — 根据工作需求选择合适的安全级别：
  • 默认模式 — 读取操作自动批准；写入和命令执行需要用户明确审批
  • 接受编辑 — 文件读写自动批准；命令执行仍需审批
  • 完全访问 — 所有操作无需提示即可执行（路径安全检查仍然生效）
• 工作目录沙箱 — Agent 的所有文件操作严格限制在指定工作目录内。路径穿越、符号链接逃逸、访问沙箱外文件等行为均在系统层面被阻止
• 工具审批面板 — 每个工具调用都会实时显示其参数。可逐条审核、点击"始终允许"以记住决策，或拒绝不信任的操作
• 成本追踪 — 实时监控每次 Agent 会话的 Token 用量与预估费用

Beta 功能

Agent 模式目前处于 Beta 阶段，支持通过 open-agent-sdk 接入 OpenAI、Anthropic 和 Gemini 模型。

内容渲染

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

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

搜索与知识

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

• 联网搜索 — 集成 Tavily、智谱 WebSearch、Bocha 等搜索引擎，搜索结果附带引用来源标注
• 本地知识库（RAG） — 支持多知识库，上传文档后自动解析分段并且构建索引，对话时语义检索相关段落
• 记忆系统 — 支持对话多命名空间记忆，可手动添加或由 AI 自动提取（AI自动提取部分即将支持）
• 上下文管理 — 灵活挂载文件附件、搜索结果、知识库片段、记忆条目和工具输出作为对话上下文

即将推出

AI 自动提取记忆功能目前正在开发中，将在后续版本中正式发布。

工具与扩展

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

• MCP 协议 — 完整实现 Model Context Protocol，支持 stdio 和 HTTP 两种传输方式
• 内置工具 — 提供 @aqbot/fetch 等开箱即用的内置 MCP 工具
• 工具执行面板 — 可视化展示工具调用的请求参数与返回结果，方便调试和审查

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 存储
• 备份恢复 — 一键从历史备份恢复完整数据
• 对话导出 — 支持将对话导出为 PNG 截图、Markdown、纯文本或 JSON 格式

注意

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

桌面体验

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

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