AQBot跨平台多模型AI桌面客户端源码

源码系统概览

文章正文

这是一套跨平台多模型 AI 聊天桌面客户端源码，项目名为 AQBot，基于 Tauri2 与 React19 构建。
它把多种大模型对话、本地知识库、MCP 工具与 API 网关整合到一个原生桌面客户端里，适合想自建本地 AI 助手的开发者学习或二次开发。

源码简介

这套源码属于 AI 桌面助手类项目，核心是把多种大模型对话、本地知识库、MCP 工具与 API 网关整合到一个跨平台桌面客户端里。
源码基于 Tauri2 与 React19，使用 Rust 编写原生能力，兼容 OpenAI、Claude、Gemini 等 OpenAI 兼容接口。
客户端支持流式输出、对话分支、Markdown 渲染、代码高亮与图表，密钥使用 AES-256 本地加密，适合想自建本地 AI 助手的开发者参考或二次开发。

适用场景

• 个人本地部署的多模型 AI 聊天助手
• 团队内部统一的 API 网关与密钥管理
• 二次开发带知识库与工具扩展的桌面 AI 工具

功能亮点

• 多模型对话：兼容 OpenAI、Claude、Gemini 等，支持多密钥轮询与流式逐 Token 渲染
• 本地知识库与记忆：LanceDB 向量索引（RAG）、全局与项目级记忆（规划中）
• MCP 工具扩展：完整 Model Context Protocol，内置文件读写、Shell 执行、截图等工具
• 本地 API 网关：OpenAI 兼容接口，密钥管理、用量统计与速率限制策略
• 数据安全：API Key 使用 AES-256 加密存储，支持自动备份到本地/WebDAV/S3 与一键恢复
• 桌面体验：深色/浅色主题、系统托盘、全局快捷键、开机自启与 HTTP/SOCKS5 代理

技术架构与部署指南

维度	本套源码	同类通用方案
技术栈	前端：React 19 + TypeScript + Vite + Ant Design 后端/原生：Rust + Ta	依具体方案选型，需自行搭建与维护
部署方式	安装 Node.js 与 Rust 工具链，使用 pnpm 安装依赖（pnpm install）。	多托管于第三方平台或订阅云服务
功能侧重	多模型对话：兼容 OpenAI、Claude、Gemini 等，支持多密钥轮询与流式逐 Token 渲染 本地知识库与记	功能通用，定制深度有限
数据归属	数据自持，部署在自有服务器，不出站	数据通常留存于服务商侧
成本模式	获取后自主部署，无持续授权费用	通常按订阅或调用量计费

技术栈与运行环境

• 前端：React 19 + TypeScript + Vite + Ant Design
• 后端/原生：Rust + Tauri 2（桌面壳）
• 数据库：SQLite（本地 aqbot.db）
• 运行环境：Windows 10/11、macOS、Linux（x64/arm64）
• 其他依赖：Monaco Editor、Mermaid、D2、katex、i18next

安装与部署提示

1. 安装 Node.js 与 Rust 工具链，使用 pnpm 安装依赖（pnpm install）。
2. 开发模式运行 pnpm tauri dev，生产构建 pnpm tauri build 生成各平台安装包。
3. 首次启动自动在 ~/.aqbot/ 与 ~/Documents/aqbot/ 创建配置与文件目录。
4. 在设置中填入各供应商 API Key 与自定义模型参数后即可开始对话。
5. 如需 API 网关，在网关页生成访问密钥并配置 SSL/TLS 证书。

截图与演示说明

• 聊天主界面：ChatPage 支持 Markdown、代码高亮、LaTeX 与 Mermaid/D2 图表渲染
• 文件与知识库页：FilesPage 与知识库管理（向量索引）
• API 网关页：GatewayPage 密钥、用量与策略配置
• 设置页：SettingsPage 模型、主题、语言、备份与代理
• 命令面板：Cmd/Ctrl+K 全局快捷操作

安全风险提示

特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
AQBot 为 AGPL-3.0 开源项目，密钥使用 AES-256 本地加密，源码中未发现有后门或恶意代码；但桌面应用拥有 Shell 执行等原生能力，使用前请确认依赖来源可信并自行审计。

下载说明

源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权（AGPL-3.0）、版权和安全风险。
GitHub开源地址：https://github.com/AQBot-Desktop/AQBot