README-KO.md

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

스크린샷

대화 차트 렌더링	서비스 제공업체 및 모델

지식 베이스	메모리

Agent - 질문	API 게이트웨이 원클릭 접속

대화 모델 선택	대화 탐색

Agent - 권한 승인	API 게이트웨이 개요

기능 목록

채팅 및 모델

• 멀티 제공업체 채팅 — OpenAI, Claude, Gemini, DeepSeek, Qwen 및 OpenAI 호환 엔드포인트를 Base URL, API Path, headers, proxy rules와 함께 연결합니다.
• 제공업체 온보딩 — aqbot:// provider links 및 CC Switch import로 사용자 확인 후 provider profiles를 AQBot으로 가져옵니다.
• 모델 관리 — remote model sync, groups, latency test, capabilities, context length, sampling defaults, reasoning profiles, per-model extra_body를 설정합니다.
• 대화 워크플로 — streaming replies, thinking blocks, message versions, branches, title-generation status, compression, multi-model comparison을 지원합니다.

AI Agent

• Agent mode — 모델이 controlled workflow에서 files edit, commands run, code analysis를 수행합니다.
• 권한 제어 — standard review, auto-accept edits, full-access mode를 선택하고 working-directory sandbox checks를 유지합니다.
• 승인 및 비용 UI — tool calls를 실시간 검토하고 allow decisions를 기억하며 session token/cost를 추적합니다.

역할

• 로컬 역할 관리 — system prompt, avatar, tags, opening message, starter questions, temperature, Top P를 재사용 가능한 conversation template로 저장합니다.
• 원클릭 사용 — 기본 동작은 새 역할 대화 생성이며 dropdown에서 현재 대화에 적용할 수도 있습니다. 역할 대화는 이름, avatar, 파란색 역할 badge를 유지합니다.
• 온라인 마켓 — prompts.chat과 PlexPt 中文 source에서 역할을 검색하고 설치한 뒤 로컬 역할로 사용할 수 있습니다.

Skills Management

• Multi-source skill directories — AQBot, Codex, Claude, Agents skill roots를 관리하며 ~/.aqbot/skills, ~/.codex/skills, ~/.claude/skills, ~/.agents/skills를 지원합니다.
• My Skills — source filter, enable/disable, detail view, copy name, open directory, uninstall을 지원합니다.
• Skill groups and install targets — group별 collapse, bulk enable/disable, group folder open, whole-group uninstall을 지원하고 owner/repo 또는 GitHub URL에서 선택한 target으로 설치합니다.
• Marketplace — skills.sh 및 GitHub source search, detail preview, GitHub jump, installed status를 제공합니다.

콘텐츠 렌더링

• Markdown 및 수식 — Markdown, code highlighting, tables, task lists, LaTeX를 streaming conversation에서 렌더링합니다.
• 코드, 다이어그램, Artifact — Monaco, Mermaid, D2, Artifact panel로 code, Markdown notes, reports, previews를 다룹니다.
• HTML fragment rendering — generated HTML fragments를 안전하게 preview하고 최근 streaming stability fixes를 반영합니다.

검색 및 지식

• 웹 검색 — Tavily, Exa, Zhipu WebSearch, Bocha 등과 cited sources, generated queries를 지원합니다.
• 로컬 지식베이스 — sqlite-vec로 private documents를 index하고 retrieval/rerank options 및 feedback을 확인합니다.
• 컨텍스트 관리 — files, search results, knowledge snippets, memories, tool output을 conversation context에 첨부합니다.

도구 및 확장

• MCP protocol — stdio, SSE, StreamableHTTP transport의 Model Context Protocol servers를 실행합니다.
• Built-in tools — @aqbot/fetch 및 file search 같은 built-in MCP tools를 별도 server 없이 사용합니다.
• Tool loop limit — MCP tool-call loop count를 설정하고 interrupted/stuck tool sessions에서 더 안정적으로 복구합니다.

API 게이트웨이

• Local gateway — OpenAI Chat Completions, OpenAI Responses, Claude-native, Gemini-native endpoints를 desktop app에서 노출합니다.
• Access and observability — gateway keys, SSL/TLS certificates, request logs, usage analytics를 로컬에서 관리합니다.
• Client templates — Claude Code, Codex CLI, OpenCode, Gemini CLI, custom clients templates를 제공합니다.

데이터 가져오기 및 백업

• Third-party imports — ChatGPT official exports, Cherry Studio backups, Kelivo backups를 preview counts, warnings, duplicate handling과 함께 가져옵니다.
• Provider and file migration — Cherry Studio/Kelivo import에서 linked providers, API keys, file attachments를 선택적으로 migration합니다.
• Backups — local folders, WebDAV, S3-compatible storage로 backup/restore를 수행합니다.

데스크톱 및 보안

• Local encryption — app state는 ~/.aqbot/, user files는 ~/Documents/aqbot/에 저장되며 API keys는 AES-256 local master key로 보호됩니다.
• Desktop integration — tray, always-on-top, global shortcuts, auto-start, proxy settings, automatic update checks를 지원합니다.
• 11 interface languages — Simplified/Traditional Chinese, English, Japanese, Korean, French, German, Spanish, Russian, Hindi, Arabic을 전환할 수 있습니다.

플랫폼 지원

플랫폼	아키텍처
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: "앱이 손상되었습니다" 또는 "개발자를 확인할 수 없습니다"

애플리케이션이 Apple에 의해 서명되지 않았기 때문에 macOS에서 다음 중 하나의 메시지가 표시될 수 있습니다:

• "AQBot"이 손상되어 열 수 없습니다
• Apple에서 악성 소프트웨어를 확인할 수 없어 "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 라이선스에 따라 배포됩니다.