功能特性

AQBot 是一款功能全面的 AI 桌面客戶端，涵蓋了從多模型對話、內容渲染、知識管理到 API 閘道等完整的 AI 工作流程。以下是各項功能的詳細介紹。

對話與模型

AQBot 提供靈活強大的多模型對話能力，讓您在一個客戶端中管理所有 AI 服務。

• 多供應商支援 — 相容 OpenAI、Anthropic Claude、Google Gemini 等主流服務商，以及所有 OpenAI 相容 API 格式的自訂端點
• 模型管理 — 支援遠端拉取模型列表，並可自訂溫度、最大 Token、Top-P 等推理參數
• 多金鑰輪詢 — 每個供應商可設定多個 API 金鑰，系統自動輪換使用，有效分散限流壓力
• 串流輸出 — 即時逐 Token 渲染回覆內容，thinking 區塊支援折疊與展開
• 訊息版本 — 每條回覆支援儲存多個版本，方便比較不同模型或參數下的生成效果
• 對話分支 — 從任意訊息節點派生新分支，探索不同對話方向，支援分支間比較
• 對話管理 — 支援釘選、封存、依時間分組、批次操作等多種管理方式
• 對話壓縮 — 自動壓縮冗長對話，保留關鍵資訊以節省上下文空間
• 多模型同答 — 同一問題同時向多個模型提問，支援答案間比較分析

提示

設定多個 API 金鑰後，AQBot 會自動在請求之間輪換金鑰，即使單個金鑰觸發速率限制也不會中斷使用。

AI Agent

AQBot 內建 Agent 模式，讓 AI 能夠自主執行多步驟任務，並提供精細的權限控制。

• Agent 模式 — 將任意對話切換至 Agent 模式，AI 可自主讀寫檔案、執行命令、分析程式碼、完成複雜的多步驟工作流——全部在受控環境中執行
• 三級權限 — 根據工作需求選擇合適的安全級別：
  • 預設模式 — 讀取操作自動批准；寫入和命令執行需要使用者明確審批
  • 接受編輯 — 檔案讀寫自動批准；命令執行仍需審批
  • 完全存取 — 所有操作無需提示即可執行（路徑安全檢查仍然生效）
• 工作目錄沙箱 — Agent 的所有檔案操作嚴格限制在指定工作目錄內。路徑穿越、符號連結逃逸、存取沙箱外檔案等行為均在系統層面被阻止
• 工具審批面板 — 每個工具呼叫都會即時顯示其參數。可逐條審核、點擊「始終允許」以記住決策，或拒絕不信任的操作
• 成本追蹤 — 即時監控每次 Agent 對話的 Token 用量與預估費用

Beta 功能

Agent 模式目前處於 Beta 階段，支援透過 open-agent-sdk 接入 OpenAI、Anthropic 和 Gemini 模型。

內容渲染

AI 回覆中的各種格式內容都能得到精準渲染，提供出色的閱讀和互動體驗。

• Markdown 渲染 — 完整支援程式碼高亮、LaTeX 數學公式、表格、任務清單等 Markdown 語法
• Monaco 程式碼編輯器 — 程式碼區塊內嵌 Monaco Editor，支援語法高亮、一鍵複製和 diff 預覽
• 圖表渲染 — 內建 Mermaid 流程圖與 D2 架構圖渲染引擎，直接在對話中視覺化圖表
• Artifact 面板 — 程式碼片段、HTML 草稿、Markdown 筆記、報告等內容可在獨立面板中即時預覽
• 即時語音對話 —（即將推出）基於 WebRTC 的即時語音互動，相容 OpenAI Realtime API

搜尋與知識

讓 AI 不再侷限於訓練資料，實現聯網搜尋與本機知識的無縫融合。

• 聯網搜尋 — 整合 Tavily、智譜 WebSearch、Bocha 等搜尋引擎，搜尋結果附帶引用來源標注
• 本機知識庫（RAG） — 支援多知識庫，上傳文件後自動解析分段並建立索引，對話時語意檢索相關段落
• 記憶系統 — 支援對話多命名空間記憶，可手動新增或由 AI 自動提取（AI 自動提取部分即將支援）
• 上下文管理 — 靈活掛載檔案附件、搜尋結果、知識庫片段、記憶條目和工具輸出作為對話上下文

即將推出

AI 自動提取記憶功能目前正在開發中，將在後續版本中正式發布。

工具與擴展

透過 MCP 協定和內建工具，讓 AI 具備操作外部系統的能力。

• MCP 協定 — 完整實現 Model Context Protocol，支援 stdio 和 HTTP 兩種傳輸方式
• 內建工具 — 提供 @aqbot/fetch 等開箱即用的內建 MCP 工具
• 工具執行面板 — 視覺化展示工具呼叫的請求參數與回傳結果，方便除錯和審查

API 閘道

AQBot 內建一個功能完整的本機 API 閘道，讓您的其他工具也能共享 AI 服務設定。

• 本機 API 伺服器 — 提供 OpenAI 相容、Claude 原生、Gemini 原生等多種介面格式，可作為任意相容客戶端的後端
• API 金鑰管理 — 產生、撤銷、啟停存取金鑰，支援描述備注
• 用量統計 — 依金鑰、供應商、日期等維度統計請求量與 Token 用量
• SSL/TLS 支援 — 內建自簽憑證自動產生，也支援掛載自訂憑證
• 請求日誌 — 完整記錄所有經過閘道的 API 請求與回應，便於排查問題
• 設定範本 — 預置 Claude Code、Codex CLI、OpenCode、Gemini CLI 等常見工具的接入設定範本，開箱即用

使用場景

透過 API 閘道，您可以讓 Cursor、VS Code Copilot、命令列工具等第三方客戶端統一經由 AQBot 轉發請求，實現金鑰統一管理和用量集中監控。

資料與安全

AQBot 將隱私和資料安全放在首位，所有資料完全儲存在本機。

• AES-256 加密 — API 金鑰等敏感資料使用 AES-256 加密儲存於本機資料庫，主金鑰檔案權限設為 0600
• 資料目錄隔離 — 應用狀態儲存於 ~/.aqbot/，使用者檔案（圖片、文件、備份）儲存於 ~/Documents/aqbot/，互不干擾
• 自動備份 — 支援定時自動備份到本機目錄、WebDAV 儲存
• 備份還原 — 一鍵從歷史備份還原完整資料
• 對話匯出 — 支援將對話匯出為 PNG 截圖、Markdown、純文字或 JSON 格式

注意

主金鑰檔案 ~/.aqbot/master.key 是解密所有敏感資料的憑證，請勿手動修改或刪除。遷移資料時需確保資料庫與主金鑰檔案配對遷移。

桌面體驗

作為原生桌面應用程式，AQBot 提供流暢的操作體驗和豐富的系統整合。

• 主題切換 — 支援深色／淺色主題，可跟隨系統設定或手動指定
• 介面語言 — 完整支援繁體中文、簡體中文與英文，可在設定中隨時切換
• 系統托盤 — 關閉視窗時最小化到系統托盤，背景服務不中斷
• 視窗置頂 — 可將主視窗常駐最頂層，隨時查看 AI 回覆
• 全域快捷鍵 — 自訂全域快捷鍵，隨時從任何應用程式喚起 AQBot 主視窗
• 開機自啟 — 可選擇隨系統自動啟動，確保 API 閘道等背景服務常駐
• 代理支援 — 支援 HTTP 和 SOCKS5 代理設定，適配各種網路環境
• 自動更新 — 啟動時自動偵測新版本並提示更新，保持客戶端始終最新