# クイックスタート

## インストール

[ダウンロードページ](/ja/download) または [GitHub Releases](https://github.com/AQBot-Desktop/AQBot/releases) から最新のインストーラーをダウンロードしてください。

### macOS

| チップ | ファイル |
|--------|---------|
| Apple Silicon (M1 / M2 / M3 / M4) | `AQBot_x.x.x_aarch64.dmg` |
| Intel | `AQBot_x.x.x_x64.dmg` |

1. `.dmg` を開き、**AQBot** を**アプリケーション**フォルダにドラッグします。
2. AQBot を起動します。macOS がアプリをブロックした場合は、**システム設定 → プライバシーとセキュリティ**に移動して**このまま開く**をクリックしてください。

> **macOS: 「アプリが壊れている」または「開発元を確認できない」**
>
> AQBot は Apple Developer ID 証明書ではなく、プロジェクト独自のコード署名証明書で署名されています。そのため、ブラウザからダウンロードした後に「"AQBot" は壊れているため開けません」や「開発元を検証できないため "AQBot" を開けません」と表示されることがあります。
>
> Gatekeeper をシステム全体で無効にする必要はありません。AQBot だけを許可してください：
>
> 1. Finder で `AQBot.app` を Control キーを押しながらクリックし、**開く**を選択してから、もう一度**開く**をクリックします。
> 2. それでもブロックされる場合は、**システム設定 → プライバシーとセキュリティ**の**セキュリティ**セクションで AQBot を見つけ、**このまま開く**をクリックします。
> 3. AQBot を再度起動します。
>
> Gatekeeper の許可とアクセシビリティの権限は別々の設定です。テキスト選択ツールバーを使うには、アプリ内の案内に従って**システム設定 → プライバシーとセキュリティ → アクセシビリティ**で AQBot も有効にしてください。

### Windows

| アーキテクチャ | ファイル |
|--------------|---------|
| x64（ほとんどの PC） | `AQBot_x.x.x_x64-setup.exe` |
| ARM64 | `AQBot_x.x.x_arm64-setup.exe` |

インストーラーを実行してウィザードに従います。スタートメニューまたはデスクトップショートカットから AQBot を起動します。

### Linux

| 形式 | アーキテクチャ | ファイル |
|------|--------------|---------|
| Debian / Ubuntu | x64 | `AQBot_x.x.x_amd64.deb` |
| Debian / Ubuntu | ARM64 | `AQBot_x.x.x_arm64.deb` |
| Fedora / openSUSE | x64 | `AQBot_x.x.x_x86_64.rpm` |
| Fedora / openSUSE | ARM64 | `AQBot_x.x.x_aarch64.rpm` |
| 任意のディストリビューション | x64 | `AQBot_x.x.x_amd64.AppImage` |
| 任意のディストリビューション | ARM64 | `AQBot_x.x.x_aarch64.AppImage` |

```bash
# Debian / Ubuntu
sudo dpkg -i AQBot_x.x.x_amd64.deb

# Fedora / openSUSE
sudo rpm -i AQBot_x.x.x_x86_64.rpm

# AppImage（任意のディストリビューション）
chmod +x AQBot_x.x.x_amd64.AppImage
./AQBot_x.x.x_amd64.AppImage
```

---

## 初期設定

### 1. 設定を開く

AQBot を起動し、サイドバー下部の**歯車アイコン**をクリックするか、<kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd> を押します。

### 2. プロバイダーを追加する

**設定 → プロバイダー**に移動し、**+** ボタンをクリックします。

1. 表示名を入力します（例：*OpenAI*）。
2. プロバイダータイプを選択します（OpenAI、Anthropic、Google Gemini など）。
3. API キーを貼り付けます。
4. **Base URL** を確認します — ビルトインタイプには公式エンドポイントが事前入力されています。サードパーティのリレーやプロキシを使用する場合のみ変更してください。

> **ヒント**
>
> プロバイダーはいくつでも追加できます。各プロバイダーは独自の API キーとモデルのセットを個別に管理します。

### 3. モデルを取得する

**モデルを取得**をクリックして、プロバイダーの API から利用可能なモデルのリストを取得します。必要に応じてモデル ID を手動で追加することもできます。

### 4. デフォルトモデルを設定する

**設定 → デフォルトモデル**に移動し、新しい会話でデフォルトとして使用するプロバイダーとモデルを選択します。

---

## 最初の会話

1. サイドバーの**新規チャット**をクリックします（または <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd> を押します）。
2. チャット上部のモデルセレクターからモデルを選択します。
3. メッセージを入力して <kbd>Enter</kbd> を押します。
4. AQBot はリアルタイムでレスポンスをストリーミングします。思考ブロックをサポートするモデル（Claude、DeepSeek R1 など）は、回答の上の折りたたみ可能なセクションに推論プロセスを表示します。

---

## 主要概念

### 会話ブランチ

任意のメッセージを編集または再生成してブランチを作成します。元のバージョンと新しいバージョンは同じ会話ツリーに共存します — 各メッセージの矢印コントロールでナビゲートできます。

### メッセージバージョン

再生成のたびに新しいバージョンが作成されます。メッセージバブルの **◀ ▶** 矢印でバージョンを切り替えられます。

### コンテキスト添付

ファイル、検索結果、MCP ツール出力を会話コンテキストに直接添付してプロンプトを充実させます。

---

## ショートカット

以下はデフォルトのキーボードショートカットです。すべてのショートカットは**設定 → ショートカット**でカスタマイズできます。

| ショートカット | アクション |
|--------------|-----------|
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> | 現在のウィンドウを表示/非表示 |
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>A</kbd> | すべてのウィンドウを表示/非表示 |
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>W</kbd> | ウィンドウを閉じる |
| <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd> | 新規会話 |
| <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd> | 設定を開く |
| <kbd>Cmd/Ctrl</kbd>+<kbd>K</kbd> | コマンドパレット |
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>M</kbd> | モデルセレクターを切り替え |
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>↑</kbd> | 最後のメッセージを入力 |
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>K</kbd> | コンテキストをクリア |
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Backspace</kbd> | 会話メッセージをクリア |
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | API ゲートウェイを切り替え |

> **補足**
>
> グローバルショートカット（ウィンドウの表示/非表示）は、AQBot がバックグラウンドにある場合でもシステム全体で動作します。AQBot は他のアプリケーションのショートカットとの競合を検出し、設定で警告を表示します。

---

## デスクトップ設定

**設定**を開いてデスクトップ体験を設定します。

| 設定 | オプション |
|------|---------|
| **テーマ** | ダーク、ライト、またはシステム（自動） |
| **言語** | 简体中文、繁體中文、English、日本語、한국어、Français、Deutsch、Español、Русский、हिन्दी、العربية |
| **システムトレイ** | トレイに最小化、トレイに閉じる |
| **自動起動** | コンピューター起動時に AQBot を起動 |
| **常に最前面** | ウィンドウを他のアプリの上に保持 |
| **プロキシ** | ホストとポートを指定した HTTP または SOCKS5 プロキシ |

---

## データとバックアップ

### データディレクトリ

AQBot は 2 つの場所にデータを保存します：

| パス | 内容 |
|------|------|
| `~/.aqbot/` | アプリケーション状態 — データベース、暗号化キー、ベクトル DB、SSL 証明書 |
| `~/Documents/aqbot/` | ユーザーが見えるファイル — 画像、ドキュメント、バックアップ |

> **ヒント**
>
> Windows では、パスは `%USERPROFILE%\.aqbot\` と `%USERPROFILE%\Documents\aqbot\` になります。

### 自動バックアップ

**設定 → バックアップ**に移動して自動バックアップを設定します：

- **有効** — 自動バックアップのオン/オフを切り替え。
- **間隔** — バックアップの頻度（時間単位）。
- **最大数** — 最古のバックアップが削除される前に保持するバックアップ数。
- **ストレージターゲット** — ローカルディレクトリ（デフォルト：`~/Documents/aqbot/backups/`）または WebDAV サーバー。

### 手動バックアップと復元

バックアップ設定パネルからいつでも手動バックアップを作成できます。復元するには、履歴リストからバックアップを選択して**復元**をクリックします。

### 会話エクスポート

サイドバーの会話を右クリックしてエクスポートします：

- **PNG** — チャットのレンダリングスクリーンショット
- **Markdown** — ヘッダー、コードブロック、LaTeX 付きフォーマット
- **プレーンテキスト** — メッセージ区切りのシンプルなテキスト
- **JSON** — 完全なメタデータを含む構造化データ

---

## 次のステップ

- [プロバイダーの設定](./providers) — AI プロバイダーの追加と管理
- [MCP サーバー](./mcp) — AI 機能を拡張する外部ツールの接続
- [API ゲートウェイ](./gateway) — プロバイダーをローカル API サーバーとして公開