設定リファレンス

VeilWin には 8 つの設定ページがあります。一般、外観、プロファイル、ルール、ディスプレイ、ホットキー、自動化、ライセンス。すべてローカル保存、即時反映。

一般

• ログイン時に起動: サインイン後に VeilWin を自動起動（トレイ常駐）
• 最小化で起動: 設定ウィンドウを出さずトレイのみ
• ウィンドウがフォーカスされていないとき:
  • 最後のウィンドウを維持: 直近のフォーカスウィンドウを使う（既定）
  • 一時停止: 何かがフォーカスされるまで減光を止める
  • すべて減光: 全部暗くする
• デスクトップを一時表示: 修飾キー長押しで画面を戻す（macOS は既定 Fn / Globe、Windows は Ctrl+Alt。Ctrl+Shift、カスタムホットキー、オフも可）
• システム外観に追従: テーマ変更時、ライト／ダーク向けにタグしたプロファイルを自動起動
• システム画面で一時停止: Mission Control / Stage Manager（macOS）やタスクビュー / Alt-Tab（Windows）中は自動で減光停止 — 既定オン
• アクセシビリティ状態: macOS の権限を表示またはリクエスト

外観

• UI テーマ: 内蔵プリセット — Apple (apple)、Serene (serene)、Dark (dark) — 即時切替
• UI 言語: 9 言語（言語サポート）
• 既定の減光強度: 新規プロファイルの初期強度（0–100%）
• 既定の減光色調: 新規プロファイルの初期色調（既定は純黒、任意 RGB）

プロファイル

プロファイルは減光パラメータのセット: 強度、色調、アニメーション、フォーカスモード、フォーカス上限。

• 内蔵テンプレート 2 つ: 「標準」と「アイケア」（強度 55% + 暖色、夜の長時間向き）
• ライト／ダーク外観のタグを付け、「システム外観に追従」で自動起動
• ホットキー で「プロファイルを有効化」を割り当て、一発切替

ルール

ルールはプロセス名でアプリを照合（大文字小文字無視）:

• 減光しない: そのアプリの全ウィンドウは明るい領域（プレーヤー、画面収録など）
• 最前面なら一時停止: そのアプリが前にあるあいだ減光を完全停止

各ルールは独立して切替 — 「例外リスト」向き。

ディスプレイ

各ディスプレイを独立制御:

• 有効／無効: そのディスプレイが減光に参加するか
• モード: 既定はグローバルに追従（各ディスプレイが自分のウィンドウにフォーカス）。「フォーカスのない画面だけ減光」に上書き可
• 強度の上書き: ディスプレイ別の強度
• プロファイル紐付け: 特定プロファイルを固定

ホットキー

衝突する割り当てはすぐフラグされ、先に解消が必要です。

自動化

自動化ルール = トリガー + アクション。リスト順で照合（最初の一致が勝つ）。アプリに 5 つのプリセット:

トリガー: 毎日の時刻（HH:MM）、固定間隔（分）、システム外観の変化。アクション: 減光のオン／オフ、プロファイル有効化、強度設定、休憩を促す、強制休憩。各ルールはオン／オフ、編集、削除可。

強制休憩中、フォーカス追跡は停止し、時間が終わるまで画面は完全減光。トレイメニューからスキップ。プリセットは既定オフ。

ライセンス

• ライセンス状態（無料 / Pro）、紐づいた台数、マシン識別子を表示
• ライセンスキーで Pro を有効化（買い切り、生涯）
• 現在のデバイスを解除（新しいマシンで有効化する前に古いマシンで解除）

無料枠は 1 日 2 時間、深夜 0 時にリセット。Pro は時間制限なし。料金 と ライセンス を参照。

MCP インターフェース（上級）

VeilWin には内蔵 MCP サーバーがあります（既定ポート 18788、設定でトークン付き有効化）。MCP 対応の AI アシスタントがアプリを読み、操作できます（設定の照会、減光の切替など）。localhost のみ待受、トークンで認証。ログと外部出力にトークンは出しません。