# AQBot

**Repository Path**: aqbot/AQBot

## Basic Information

- **Project Name**: AQBot
- **Description**: ☁️ 轻量级高性能跨平台AI对话 + AI网关桌面客户端 | Lightweight, high-performance cross-platform AI dialogue + AI gateway desktop client
- **Primary Language**: Rust
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-30
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AI, chatGPT, deepseek

## README

**简体中文** | [繁體中文](./README-ZH-TW.md) | [English](./README-EN.md) | [日本語](./README-JA.md) | [한국어](./README-KO.md) | [Français](./README-FR.md) | [Deutsch](./README-DE.md) | [Español](./README-ES.md) | [Русский](./README-RU.md) | [हिन्दी](./README-HI.md) | [العربية](./README-AR.md)

[![AQBot](https://socialify.git.ci/AQBot-Desktop/AQBot/image?description=1&font=JetBrains+Mono&forks=1&issues=1&logo=https%3A%2F%2Fgithub.com%2FAQBot-Desktop%2FAQBot%2Fblob%2Fmain%2Fsrc%2Fassets%2Fimage%2Flogo.png%3Fraw%3Dtrue&name=1&owner=1&pattern=Floating+Cogs&pulls=1&stargazers=1&theme=Auto)](https://github.com/AQBot-Desktop/AQBot)


## 运行截图

| 对话图表渲染 | 服务商与模型 |
|:---:|:---:|
| ![](.github/images/s1-0412.png) | ![](.github/images/s2-0412.png) |

| 知识库 | 记忆 |
|:---:|:---:|
| ![](.github/images/s3-0412.png) | ![](.github/images/s4-0412.png) |

| Agent-询问 | API网关一键接入 |
|:---:|:---:|
| ![](.github/images/s5-0412.png) | ![](.github/images/s6-0412.png) |

| 对话模型选择 | 对话导航 |
|:---:|:---:|
| ![](.github/images/s7-0412.png) | ![](.github/images/s8-0412.png) |

| Agent-权限审批 | API网关概览 |
|:---:|:---:|
| ![](.github/images/s9-0412.png) | ![](.github/images/s10-0412.png) |

## 功能特性

AQBot 是本地优先的 AI 桌面工作台。本页已按 v0.0.85 更新，覆盖近期服务商导入、第三方数据导入、MCP、HTML 渲染、备份和网关能力。

### 对话与模型

- **多服务商对话** — 连接 OpenAI、Claude、Gemini、DeepSeek、Qwen 以及任意 OpenAI 兼容端点，支持自定义 Base URL、API Path、请求头和代理规则。
- **服务商快速导入** — 通过 aqbot:// 服务商链接和 CC Switch 配置导入，在用户确认后把服务商资料带入 AQBot。
- **模型管理** — 同步远程模型列表、管理分组、测试延迟，并配置能力标签、上下文长度、采样默认值、推理档位和模型级 extra_body。
- **对话工作流** — 流式回复、思考块、消息多版本、对话分支、标题生成状态、长对话压缩和多模型并行回答。

### AI Agent

- **Agent 模式** — 让模型在受控桌面工作流中读取/编辑文件、执行命令并分析代码。
- **权限控制** — 可选择标准审核、自动接受编辑或完全访问模式，同时保留工作目录沙箱检查。
- **审批与成本面板** — 实时查看工具调用、记住允许决策，并跟踪每个 Agent 会话的 token 与成本。

### 内容渲染

- **Markdown 与数学公式** — 在流式对话中渲染 Markdown、代码高亮、表格、任务列表和 LaTeX 公式。
- **代码、图表与 Artifact** — 内置 Monaco 代码块、Mermaid、D2 图表和 Artifact 面板，用于代码、Markdown 笔记、报告和预览。
- **HTML 片段渲染** — 安全预览模型生成的 HTML 片段，并包含近期版本加入的流式渲染稳定性修复。

### 搜索与知识

- **联网搜索** — 接入 Tavily、智谱 WebSearch、Bocha 等搜索服务，支持引用来源和搜索查询生成。
- **本地知识库** — 用 sqlite-vec 索引私有文档，配置检索/重排选项并查看检索反馈。
- **上下文管理** — 把文件、搜索结果、知识片段、记忆和工具输出附加到对话上下文。

### 工具与扩展

- **MCP 协议** — 运行 stdio、SSE 或 StreamableHTTP 传输的 Model Context Protocol 服务器。
- **内置工具** — 直接使用 @aqbot/fetch、文件搜索等内置 MCP 工具，无需额外安装独立服务器。
- **工具循环上限** — 可配置 MCP 工具调用最大循环次数，并更好地恢复中断或卡住的工具会话。

### API 网关

- **本地网关** — 从桌面应用暴露 OpenAI Chat Completions、OpenAI Responses、Claude 原生和 Gemini 原生接口。
- **访问与观测** — 本地管理网关密钥、SSL/TLS 证书、请求日志和用量统计。
- **客户端模板** — 提供 Claude Code、Codex CLI、OpenCode、Gemini CLI 和自定义客户端的配置模板。

### 数据导入与备份

- **第三方导入** — 导入 ChatGPT 官方导出、Cherry Studio 备份和 Kelivo 备份，带预览统计、警告和重复处理。
- **服务商与文件迁移** — Cherry Studio/Kelivo 导入可选择迁移关联服务商、API Key 和文件附件。
- **备份** — 通过本地目录、WebDAV 或 S3 兼容存储进行备份与恢复。

### 桌面体验与安全

- **本地加密** — 应用状态位于 ~/.aqbot/，用户文件位于 ~/Documents/aqbot/，API Key 使用 AES-256 和本地主密钥保护。
- **桌面集成** — 支持托盘、窗口置顶、全局快捷键、开机自启、代理设置和自动更新检查。
- **11 种界面语言** — 可在简体中文、繁体中文、英语、日语、韩语、法语、德语、西班牙语、俄语、印地语和阿拉伯语之间切换。

## 平台支持

| 平台 | 架构 |
|------|------|
| macOS | Apple Silicon (arm64), Intel (x86_64) |
| Windows 10/11 | x86_64, arm64 |
| Linux | x86_64 (AppImage/deb/rpm), arm64 (AppImage/deb/rpm) |

## 快速开始

前往 [Releases](https://github.com/AQBot-Desktop/AQBot/releases) 页面下载适合你平台的安装包。

## 常见问题

### macOS 提示"已损坏"或"无法验证开发者"

由于应用未经 Apple 签名，macOS 可能会弹出以下提示之一：

- "AQBot" 已损坏，无法打开
- 无法打开 "AQBot"，因为无法验证开发者

**解决步骤：**

**1. 允许"任何来源"的应用运行**

```bash
sudo spctl --master-disable
```

执行后前往「系统设置 → 隐私与安全性 → 安全性」，确认已勾选「任何来源」。

**2. 移除应用的安全隔离属性**

```bash
sudo xattr -dr com.apple.quarantine /Applications/AQBot.app
```

> 如果不确定路径，可将应用图标拖拽到 `sudo xattr -dr com.apple.quarantine ` 后面。

**3. macOS Ventura 及以上版本的额外步骤**

完成上述步骤后，首次打开时仍可能被拦截。前往 **「系统设置 → 隐私与安全性」** ，在安全性区域点击 **「仍要打开」** 即可，后续无需重复操作。

## 社区支持
- [LinuxDO](https://linux.do)

## 许可证

本项目采用 [AGPL-3.0](LICENSE) 许可证。