跨平台 AI 对话与 AI 网关客户端（fork）：轻量高性能的桌面 AI 聊天入口。

English summary: Forked cross-platform AI chat and gateway desktop client for lightweight high-performance conversations.

• GitHub repository: https://github.com/siuserxiaowei/AQBot
• Live / GitHub Pages: https://app.aqbot.top
• Default branch: main
• Primary language: Rust
• Repository type: fork / reference repository

1. 先读本 README，确认项目目标、在线入口和本地运行方式。
2. 打开上方 Live / GitHub Pages 链接，先从最终效果理解项目。
3. 查看 package.json 的 scripts，确认开发、构建和预览命令。
4. 如果要修改内容，先小范围改动，再运行本 README 中的验证命令。

git clone https://github.com/siuserxiaowei/AQBot.git
cd AQBot

npm install
npm run dev
npm run build
npm test

• Keep this README in sync when the project purpose, live link, or run commands change.
• Prefer small, focused commits when changing code, data, or generated pages.
• Run the relevant build or validation command before publishing changes.
• If this is a generated/static archive, update the source data first, then regenerate the public files.

• Do not commit API keys, tokens, passwords, cookies, private URLs, or internal account data.
• Keep private source material out of public GitHub Pages output unless it has been explicitly cleared for publication.
• When in doubt, run a quick secret scan such as rg -n "token|secret|password|access_key|authorization" before pushing.

简体中文 | 繁體中文 | English | 日本語 | 한국어 | Français | Deutsch | Español | Русский | हिन्दी | العربية

对话图表渲染	服务商与模型

知识库	记忆

Agent-询问	API网关一键接入

对话模型选择	对话导航

Agent-权限审批	API网关概览

• 多供应商支持 — 兼容 OpenAI、Anthropic Claude、Google Gemini 等所有 OpenAI 兼容 API
• 模型管理 — 支持远程拉取模型列表、自定义参数（温度、最大 Token、Top-P 等）
• 多密钥轮询 — 每个供应商可配置多个 API Key，自动轮换以分散限流压力
• 流式输出 — 实时逐 Token 渲染，thinking 块可折叠展开
• 消息版本 — 每条回复支持多版本切换，方便对比不同模型或参数的效果
• 对话分支 — 从任意消息节点派生新分支，支持分支间对比
• 对话管理 — 支持置顶、归档、按时间分组、批量操作
• 对话压缩 — 自动压缩冗长对话，保留关键信息以节省上下文空间
• 多模型同答案 — 同一问题同时向多个模型提问，支持答案间对比分析

• Agent 模式 — 切换至 Agent 模式，AI 可自主执行多步骤任务：读写文件、运行命令、分析代码等
• 三级权限 — 默认模式（写入需审批）、接受编辑（自动批准修改）、完全访问（无提示），安全可控
• 工作目录沙箱 — Agent 操作严格限制在指定工作目录内，防止越权访问
• 工具审批面板 — 实时展示工具调用请求，支持逐条审核、一键始终允许或拒绝
• 成本追踪 — 每次会话实时统计 Token 用量与费用

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

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

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

• 本地 API 网关 — 内置 OpenAI 兼容、Claude、Gemini等原生接口的本地 API 服务器，可作为任意兼容客户端的后端
• API 密钥管理 — 生成、撤销、启停访问密钥，支持描述备注
• 用量统计 — 按密钥、供应商、日期维度的请求量与 Token 用量分析
• SSL/TLS 支持 — 内置自签名证书生成，也支持挂载自定义证书
• 请求日志 — 完整记录所有经过网关的 API 请求与响应
• 配置模板 — 预置 Claude、Codex、OpenCode、Gemini 等常见 CLI 工具的接入配置模板

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

• 主题切换 — 深色/浅色主题，可跟随系统或手动指定
• 界面语言 — 完整支持简体中文、繁体中文、英文、日文、韩文、法文、德文、西班牙文、俄文、印地文与阿拉伯文，可在设置中随时切换
• 系统托盘 — 关闭窗口时最小化到系统托盘，不中断后台服务
• 窗口置顶 — 可将主窗口常驻最顶层
• 全局快捷键 — 自定义全局快捷键，随时唤起主窗口
• 开机自启 — 可选择随系统自动启动
• 代理支持 — 支持 HTTP 和 SOCKS5 代理配置
• 自动更新 — 启动时自动检测新版本并提示更新

前往 Releases 页面下载适合你平台的安装包。

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

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

解决步骤：

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

sudo spctl --master-disable

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

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

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

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

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

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

• LinuxDO

本项目采用 AGPL-3.0 许可证。