Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

649 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

AQBot

AQBot 是一款本地优先的桌面 AI 工作台,统一多服务商对话、ACP Agent、知识库、MCP 工具与 API 网关,并将应用数据和用户文件保留在本机掌控之中。

运行截图

对话图表渲染 服务商与模型
知识库 记忆
Agent-询问 API网关一键接入
对话模型选择 对话导航
Agent-权限审批 API网关概览

功能特性

对话与模型

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

AI Agent

  • 两种 Agent 使用方式 — AQBot 同时提供对话模块内置 Agent 与独立 ACP Agent 工作台;前者使用用户配置的服务商 API,后者连接 ACP 兼容的外部 Agent 进程,可按模型来源和工作流自由选择。
  • 对话 Agent(服务商 API) — 在普通对话中切换至 Agent 模式,直接使用已配置服务商与模型的 API,让模型在独立工作目录中读取/编辑文件、执行命令并分析代码。
  • 对话 Agent 管控 — 支持每次询问、自动接受编辑和完全访问等权限模式,实时展示工具调用与审批,并记录单次任务的 token 和成本。
  • ACP Agent 工作台 — 通过 Agent Client Protocol (ACP) 在独立工作台中运行兼容的编程 Agent,流式查看回复、思考过程和工具调用。
  • ACP Registry 与自定义接入 — 可从 Registry 添加 Codex、Claude Agent、Gemini CLI、Cline、OpenCode、Grok Build 等 Agent,也可配置自定义命令、参数、环境变量和图标,并自由启停与排序。
  • ACP 项目与自由对话 — 按项目组织线程、固定常用会话并自动恢复上次现场;也可不选择项目,直接在隔离工作目录中开始对话。
  • ACP 完整会话交互 — 支持 Agent 暴露的模型、模式和配置切换,以及附件、问卷、计划审核、计划进度与刷新后恢复;工具请求可单次允许或在当前会话中“始终允许”。

角色

  • 本地角色管理 — 将系统提示词、头像、标签、开场白、开场问题、温度和 Top P 保存为可复用会话模板。
  • 一键使用角色 — 默认新建角色对话,也可从下拉菜单应用到当前对话;角色对话保留角色名称、头像和蓝色“角色”标记。
  • 在线市场 — 从 prompts.chat 和 PlexPt 中文来源搜索并安装角色,安装后可离线作为本地角色使用。

Skills 管理

  • 多来源技能目录 — 管理 AQBot、Codex、Claude 和 Agents 技能目录,包括 ~/.aqbot/skills~/.codex/skills~/.claude/skills~/.agents/skills
  • 我的技能 — 支持来源筛选、启用/禁用、详情查看、复制名称、打开目录和卸载。
  • 技能组与安装目标 — 按 group 折叠技能组,批量启停、打开组目录、卸载整组,并可从 owner/repo 或 GitHub URL 安装到指定目标。
  • 在线市场 — 支持 skills.sh 与 GitHub 来源搜索、详情预览、GitHub 跳转和安装状态展示。

内容渲染

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

搜索与知识

  • 联网搜索 — 接入 Tavily、Exa、智谱 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 页面下载适合你平台的安装包。

常见问题

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

AQBot 使用项目自签名的代码签名证书,不是 Apple Developer ID 证书,因此从浏览器下载后 macOS 仍可能弹出以下提示之一:

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

这不需要关闭整个系统的 Gatekeeper。请只放行当前 AQBot 应用:

  1. 在 Finder 中按住 Control 点击 AQBot.app,选择「打开」,然后再次点击「打开」。
  2. 如果仍被拦截,前往「系统设置 → 隐私与安全性」,在安全性区域找到 AQBot 并点击「仍要打开」。
  3. 再次启动 AQBot。

Gatekeeper 放行与辅助功能授权是两项独立设置。使用划词工具栏时,还需根据 AQBot 内的提示,在「系统设置 → 隐私与安全性 → 辅助功能」中启用 AQBot。

社区支持

许可证

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

About

☁️ 轻量级高性能跨平台AI对话 + AI Agent + AI网关桌面客户端 | Lightweight, high-performance cross-platform AI dialogue + AI Agent + AI gateway desktop client

Topics

Resources

Contributing

Stars

778 stars

Watchers

5 watching

Forks

Releases

Packages

Used by

Contributors

Languages