1. 项目定位与用途
AQBot 是一款基于 Tauri 的跨平台桌面客户端，定位为 AI 对话与网关一体化工作台。它允许用户在同一应用中访问多个 AI 供应商的模型，进行流式对话、分支对比，同时提供本地 API 网关服务，使其他客户端可通过统一后端调用各类 AI 接口。此外，内置 AI Agent 功能支持自动化工具执行，结合 RAG 知识库与记忆系统，构建完整的 AI 辅助工作流。
项目档案应用项目
AQBot 跨平台 AI 桌面客户端：多模型对话、本地网关与 Agent 工具，支持 macOS/Windows/Linux，免费下载使用
AQBot 是一款轻量级跨平台 AI 对话与网关桌面客户端，支持 OpenAI、Claude、Gemini 等多供应商，提供流式输出、对话分支、AI Agent 工具执行、本地 API 网关、RAG 知识库等功能。本文详细介绍其安装步骤、使用方式及技术特性，帮助用户快速上手。
AI 总结
AQBot 是一款基于 Tauri 的跨平台 AI 桌面客户端，统一管理多供应商 AI 对话、提供本地 API 网关与 AI Agent 工具执行，注重隐私安全与高效工作流。
中文项目介绍
AQBot 是一款轻量级高性能的跨平台 AI 对话与 AI 网关桌面客户端，基于 Tauri 框架构建，支持 macOS、Windows 和 Linux 系统。它集成了多供应商 AI 模型对话、本地 API 网关、AI Agent 工具执行、RAG 知识库、记忆系统等功能，旨在为开发者和 AI 用户提供一体化的工作台。
项目主要解决多 AI 模型统一访问困难、本地 API 网关搭建复杂、AI 自动化工具执行不安全、对话版本管理低效以及隐私数据泄露风险等问题。通过统一界面管理 OpenAI、Anthropic Claude、Google Gemini 等供应商，实现密钥轮询、流式输出、对话分支对比；提供沙箱化的 Agent 模式，支持文件操作与命令执行；内置本地网关服务，兼容 OpenAI 接口规范；采用 AES-256 加密与本地存储保障数据安全。
适用场景包括：开发者对比不同 AI 模型回答质量；使用 AI Agent 自动处理文件与代码；为其他应用搭建统一 AI 后端；基于本地文档进行智能问答；以及需要端到端加密的敏感对话。技术栈采用 React + Vite + Zustand + Ant Design，支持 11 种界面语言，具备深色/浅色主题、系统托盘、全局快捷键等桌面体验优化。
详细信息与使用说明
2. 解决的问题
仓库中明确指出的问题包括：1) 多 AI 模型访问分散，需切换不同平台；2) 本地搭建 API 网关复杂，缺乏统一管理；3) AI 自动化执行缺乏安全沙箱与审批机制；4) 对话历史难以版本对比与分支管理；5) 敏感 API Key 与对话数据存储存在泄露风险。AQBot 通过统一界面、内置网关、三级权限 Agent、对话分支与 AES-256 加密等措施解决这些问题。
3. 适用场景
根据功能特性，适用场景有：开发者对比 OpenAI、Claude、Gemini 等模型的回答质量；使用 AI Agent 自动读写文件、运行命令、分析代码；为 CLI 工具或脚本提供本地 AI 后端；上传文档构建知识库进行语义问答；在需要高隐私的场景下进行加密对话。此外，联网搜索、记忆管理和多语言支持也使其适合日常研究、学习与内容创作。
4. 安装方式
安装方式在 README 的‘快速开始’部分明确给出：访问 GitHub Releases 页面（https://github.com/AQBot-Desktop/AQBot/releases）下载对应平台的安装包。对于 macOS 用户，由于应用未经 Apple 签名，需额外执行：1) sudo spctl --master-disable 允许任何来源；2) sudo xattr -dr com.apple.quarantine /Applications/AQBot.app 移除安全隔离；3) 在 macOS Ventura 及以上版本首次打开时，于系统设置中点击‘仍要打开’。Windows 与 Linux 用户直接运行安装包即可。仓库中未提供命令行安装或包管理器安装方式。
5. 使用方式
使用方式从 README 功能特性总结：启动后首先在设置中配置 AI 供应商的 API Key 与参数（如温度、Top-P）；在对话界面选择模型进行提问，支持流式输出与 thinking 块折叠；通过消息版本切换对比不同模型回答；从任意消息节点派生分支进行对话对比；切换至 Agent 模式并设置三级权限（默认写入需审批、接受编辑自动批准、完全访问），AI 即可执行文件操作与命令；启用联网搜索（Tavily、智谱等）或上传文档构建本地知识库；在上下文管理中挂载文件、搜索结果等；通过设置配置代理、主题、快捷键、开机自启等桌面选项。
6. 补充说明或实现特点
实现特点基于代码证据：前端采用 React + Vite + TypeScript，使用 Ant Design 组件库与 Tailwind CSS；状态管理通过多个 Zustand stores 分离关注点（UI、对话、网关、知识等）；自定义 Markdown 解析器（lib/chatMarkdown.ts）支持 AI 特殊标签如 think、web-search 渲染；集成 Monaco 编辑器提供代码高亮；使用 stream-markdown 实现流式 Markdown 渲染；后端基于 Tauri（Rust）实现本地 API 网关、文件系统操作与加密存储；支持 MCP 协议扩展工具；国际化使用 i18next 管理 11 种语言；构建时优化 Shiki 语言包体积。数据安全方面，API Key 等敏感数据使用 AES-256 加密存储，应用状态与用户文件目录隔离，支持自动备份到本地或 WebDAV。
思维导图
AQBot
对话与模型
多供应商支持
模型管理
多密钥轮询
流式输出
消息版本
对话分支
对话压缩
多模型同答案
AI Agent
Agent 模式
三级权限
工作目录沙箱
工具审批面板
成本追踪
内容渲染
Markdown 渲染
Monaco 编辑器
图表渲染
Artifact 面板
实时语音对话
搜索与知识
联网搜索
本地知识库
记忆系统
上下文管理
工具与扩展
MCP 协议
内置工具
工具执行面板
API 网关
本地 API 网关
API 密钥管理
用量统计
SSL/TLS 支持
请求日志
配置模板
数据与安全
AES-256 加密
数据目录隔离
自动备份
备份恢复
对话导出
桌面体验
主题切换
界面语言
系统托盘
窗口置顶
全局快捷键
开机自启
代理支持
自动更新
常见问题
AQBot 是什么？
AQBot 是一款跨平台 AI 对话与网关桌面客户端，统一管理多供应商模型，提供本地 API 服务和 AI Agent 工具执行，支持流式对话、分支对比、知识库等功能。
如何安装 AQBot？
访问 GitHub Releases 下载对应平台安装包。macOS 用户需执行 sudo spctl --master-disable 允许任何来源，并移除 quarantine 属性：sudo xattr -dr com.apple.quarantine /Applications/AQBot.app，首次打开可能需在系统设置中点击“仍要打开”。
支持哪些 AI 模型？
兼容 OpenAI、Anthropic Claude、Google Gemini 等所有 OpenAI 兼容 API，支持多密钥轮询、自定义参数（温度、最大 Token、Top-P 等）与流式输出。
AI Agent 功能如何使用？
在对话界面切换至 Agent 模式，设置三级权限（默认写入需审批、接受编辑自动批准、完全访问），AI 即可在沙箱内执行文件操作、运行命令等任务，并通过工具审批面板实时审核调用请求。
数据安全如何保障？
API Key 等敏感数据使用 AES-256 加密存储，应用状态存于 ~/.aqbot/，用户文件存于 ~/Documents/aqbot/，支持自动备份到本地或 WebDAV，对话可导出为 PNG、Markdown、JSON 等格式。