docs/ja-JP/reference/settings.md

---
title: 設定リファレンス
---

# 設定リファレンス

現在の Koharu の Settings 画面は、主に次の 6 セクションで構成されています。

- `Appearance`
- `Engines`
- `API Keys`
- `Keybinds`
- `Runtime`
- `About`

このページでは、現在のアプリ実装に基づく設定項目をまとめます。

## Appearance

`Appearance` タブには現在次が含まれます。

- テーマ: `Light` / `Dark` / `System`
- 同梱済み翻訳リソースから選ぶ UI 言語
- 翻訳テキスト描画に使う `Rendering Font`

テーマ、言語、描画フォントの変更はフロントエンド側で即時反映されます。

## Engines

`Engines` タブでは、各パイプライン段階で使うバックエンドを選択します。

- `Detector`
- `Bubble Detector`
- `Font Detector`
- `Segmenter`
- `OCR`
- `Translator`
- `Inpainter`
- `Renderer`

これらの値は共有アプリ設定に保存され、変更時に即時保存されます。

## API Keys

`API Keys` タブで現在扱う組み込み provider は次の通りです。

- `OpenAI`
- `Gemini`
- `Claude`
- `DeepSeek`
- `DeepL`
- `Google Cloud Translation`
- `Caiyun`
- `OpenAI Compatible`

各プロバイダはステータスドット付きのアコーディオンとして表示されます。

- 緑 — 利用可能 (キーが保存され、モデル discovery に成功)
- 黄 — 必須項目が未設定 (API キー、または `OpenAI Compatible` の場合は base URL)
- 赤 — 設定されたエンドポイントに対する discovery が失敗
- 灰 — まだ何も設定されていない

現在の挙動:

- provider の API キーは `config.toml` には書き込まれません
- macOS と Windows では、provider の API キーはシステム keyring に保存されます
- Linux では、provider の API キーはアプリデータディレクトリ配下の Koharu ローカルファイルシステム認証情報ストアに保存され、所有ユーザーのみが読める権限が設定されます
- provider の `Base URL` は共有アプリ設定に保存されます
- `OpenAI Compatible` ではカスタム `Base URL` が必須です。モデルはその URL に対して `GET /v1/models` を呼び出して動的に取得されます
- 機械翻訳プロバイダ (`DeepL`、`Google Cloud Translation`、`Caiyun`) は API キーのみで使えます。`Caiyun` は対応ターゲット言語が限られます
- キーをクリアすると認証情報ストレージから削除されます

API レスポンスでは保存済みキーは生値ではなく、マスク済みの値として返されます。

Linux のファイルシステム認証情報ストアは、OS レベルの暗号化ではなくローカルファイルシステム権限に依存します。

## キーバインド

`Keybinds` タブでは、ツール切り替えとブラシサイズのショートカット、および undo / redo のキー割り当てを変更できます。

現在の挙動:

- 既定値は Select / Block / Brush / Eraser / Repair Brush の各ツールに対して `V` / `M` / `B` / `E` / `R`
- ブラシサイズの増減は既定で `[` と `]`
- undo と redo は既定で `Ctrl + Z` と `Ctrl + Shift + Z` (macOS では `Cmd + Z` と `Cmd + Shift + Z`)
- キャンバスのズーム (`Ctrl` + ホイール)、パン (`Ctrl` + ドラッグ)、全選択 (`Ctrl + A`)、レガシーの `Ctrl + Y` redo フォールバックは再割り当てできません
- キーが競合する場合はエディタ上で強調表示され、同じ画面から既定値へ戻すこともできます

キーバインド設定は `config.toml` ではなく、フロントエンドの preferences 層に保存されます。

既定値の全リストは [キーボードショートカット](keyboard-shortcuts.md) を参照してください。

## Runtime

`Runtime` タブでは、共有ローカルランタイムに影響する再起動必須の設定をまとめています。

- `Data Path`
- `HTTP Connect Timeout`
- `HTTP Read Timeout`
- `HTTP Max Retries`

現在の挙動:

- `Data Path` はランタイムパッケージ、ダウンロード済みモデル、ページマニフェスト、画像 blob の保存先です
- `HTTP Connect Timeout` は HTTP 接続確立の待機時間です
- `HTTP Read Timeout` は HTTP レスポンス読み取りの待機時間です
- `HTTP Max Retries` は一時的な HTTP 障害への自動再試行回数です
- これらの HTTP 値はダウンロードや provider リクエストに使う共有ランタイム HTTP クライアントに適用されます
- これらの値は起動時に読み込まれるため、適用時は設定保存後にデスクトップアプリを再起動します

## About

`About` タブには現在次が表示されます。

- 現在のアプリバージョン
- より新しい GitHub リリースの有無
- 作者リンク
- リポジトリリンク

パッケージ済みアプリでは、`mayocream/koharu` の最新 GitHub リリースとローカル版を比較して更新状態を判定します。

## 永続化の仕組み

現在の設定保存は複数の層に分かれています。

- `config.toml` には `data`、`http`、`pipeline`、provider の `baseUrl` など共有設定が保存されます
- provider API キーは、上記のプラットフォーム認証情報ストレージを通じて `config.toml` とは別に保存されます
- テーマ、言語、描画フォントはフロントエンドの preferences 層に保存されます

つまり、フロントエンドの preferences を消しても、保存済みの provider API キーや共有ランタイム設定までは消えません。

## 関連ページ

- [OpenAI 互換 API を使う](../how-to/use-openai-compatible-api.md)
- [モデルとプロバイダ](../explanation/models-and-providers.md)
- [HTTP API リファレンス](http-api.md)