コンテンツにスキップ

設定リファレンス

現在の 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 層に保存されます。

既定値の全リストは キーボードショートカット を参照してください。

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 キーや共有ランタイム設定までは消えません。

関連ページ