キーボードショートカット・トレイ操作・配列切り替え・設定ファイル・ログのリファレンス
awase は「IME の状態」と「エンジンの状態」の組み合わせで動作を切り替えます。
| IME | エンジン | 動作 |
|---|---|---|
| ON | ON | 親指シフト（NICOLA）入力 |
| ON | OFF | 通常 IME 入力（ローマ字変換） |
| OFF | どちらでも | 英字直接入力（エンジンは自動停止） |
IME が OFF のときはエンジンが自動的に停止するため、パスワード欄などでも誤動作しません。
同梱のデフォルト配列（JIS版 layout/nicola.yab / US版 layout/nicola_us.yab）が、どのキーでどの文字を出力するかの一覧です。通常面は単独打鍵、他の3面は無変換・変換キー（親指シフト）または小指シフトキーとの同時打鍵で入力します。
配列は自由にカスタマイズできます。設定画面の「配列編集」タブで直接編集するか、独自の .yab ファイルを作成して切り替えられます（レイアウトの切り替え参照）。
デフォルト設定でのショートカット一覧です。config.toml で変更できます。
| カテゴリ | キー | 動作 |
|---|---|---|
| IME | Ctrl + 変換 | IME を ON にする。既に ON の場合はひらがな・ローマ字・CapsLock OFF へリセットする |
| IME | Ctrl + 無変換 | IME を OFF にする（冪等 — 既に OFF なら何も起きない） |
| IME | 左 Shift 単独タップ | 「IME-ON 半角英数」持続トグル。他のキーを介さず押して離すと切替、もう一度タップで解除（現状 MS-IME のみ対応。GJI は今後対応予定） |
| エンジン | Ctrl + Shift + 変換 | NICOLA エンジンを ON にする（親指シフト入力を有効化） |
| エンジン | Ctrl + Shift + 無変換 | NICOLA エンジンを OFF にする（ローマ字入力に切り替え） |
| エンジン | Ctrl + Shift + F12 | エンジンの ON/OFF をトグル（グローバルホットキー、config.toml で変更可） |
| システム | Ctrl + Shift + F11 | 現在のウィンドウのフォーカス判定を強制上書き（テキスト入力 ↔ バイパスを切替） |
| 親指シフト | 変換 | 右親指シフトキー（エンジン ON 中、他のキーと同時押しで NICOLA 判定） |
| 親指シフト | 無変換 | 左親指シフトキー（エンジン ON 中、他のキーと同時押しで NICOLA 判定） |
| IME | 半角/全角 | IME の ON/OFF をトグル（Windows 標準の動作） |
| 緊急 | 無変換 × 3（400ms 以内） | NICOLA エンジンを強制 OFF（Ctrl スタック等でショートカットが効かないとき） |
| 緊急 | Ctrl+無変換 → Ctrl+変換 → Ctrl+無変換（2秒以内） | パニックリセット — 標準状態（IME ON・ひらがな・エンジン ON）へ強制復帰 |
冪等な IME 制御について： Ctrl+変換 は「IME を ON にする」という操作です。従来のトグル方式と異なり、現在の状態がずれていても必ず意図した結果になります。 エンジン ON/OFF とは独立して動作します。IME が既に ON の場合は、入力途中の状態（カタカナ・半角英数など）をひらがな・ローマ字・CapsLock OFF へ揃えて再確定させます。
「IME-ON 半角英数」トグルについて： 左 Shift 単独タップは、IME を開いたまま NICOLA エンジンだけを一時的に停止し、英数字を直接入力できるようにします（IME 自体は閉じないため、パスワード欄などとは異なる仕組みです）。もう一度左 Shift を単独タップすると通常のかな入力へ戻ります。右 Shift の単独タップやフォーカス変更でも自動的に解除されます。
タスクバー右端のシステムトレイに awase アイコンが常駐します。
layouts_dir 内の .yab ファイルを一覧表示。選択するとレイアウトが即座に切り替わりますトレイアイコン右クリック → 「設定...」で開きます。変更後は「適用」ボタンで保存・即時反映されます。
| 項目 | 説明 |
|---|---|
| キーボードモデル | JIS（日本語配列）または US（英語配列）を選択 |
| 同時打鍵閾値 | 同時打鍵と判定する時間幅（ms）。NICOLA 規格標準は 100ms |
| 確定モード | 文字の確定タイミング。下表参照 |
| 投機出力待機 | two_phase / adaptive_timing 使用時の投機出力までの待機時間（ms） |
| 出力モード | Unicode（推奨）・PerKey・Batched。通常は Unicode のまま |
| フックモード | Relay（推奨・安定）または Filter（低遅延） |
| 自動起動 | Windows ログオン時に自動起動するかどうか |
| レイアウト | 使用する .yab 配列ファイルの選択。「再スキャン」で一覧を更新 |
| モード | 動作 | 向いている人 |
|---|---|---|
| wait | タイムアウトまで保留してから確定。最も正確 | ゆっくり正確に打ちたい方 |
| speculative | 即時出力し、同時打鍵なら差し替え。最速だが一瞬ちらつく | 速度最優先の方 |
| two_phase | 短い待機後に投機出力。wait と speculative の中間 | バランス重視の方 |
| adaptive_timing | 連続打鍵中は wait、途切れたら投機。速度に自動適応 | 打鍵速度にムラがある方 |
| ngram_predictive | n-gram 統計で投機/待機を動的判断。文脈を使って精度向上 | 最も賢い判定を使いたい方（推奨） |
| 項目 | 説明 |
|---|---|
| 左親指キー | 左親指シフトキーに使うキー（デフォルト: VK_NONCONVERT = 無変換） |
| 右親指キー | 右親指シフトキーに使うキー（デフォルト: VK_CONVERT = 変換） |
| エンジン ON キー | NICOLA エンジンを ON にするキー。複数登録可 |
| エンジン OFF キー | NICOLA エンジンを OFF にするキー。複数登録可 |
| IME ON キー | IME を ON にするキー（冪等）。複数登録可 |
| IME OFF キー | IME を OFF にするキー（冪等）。複数登録可 |
| エンジン切替ホットキー | グローバルホットキーでエンジン ON/OFF をトグル |
awase が IME 状態の変化を把握するためのキー設定です。通常はデフォルトのままで問題ありません。
| 項目 | 説明 |
|---|---|
| トグルキー | OS が IME ON/OFF をトグルするキー（例: 半角/全角） |
| ON キー | OS が IME を ON にするキー |
| OFF キー | OS が IME を OFF にするキー |
「デフォルトに戻す」ボタンで標準設定に戻せます。
プロセス名とウィンドウクラス名の組み合わせで、アプリごとに動作を上書きします。
| 設定種別 | 説明 | 用途例 |
|---|---|---|
| テキスト入力として強制 | 自動判定に関わらず常に NICOLA 入力を有効にする | 誤ってバイパスされるアプリ |
| バイパスとして強制 | 常にエンジンを無効にする | スタートメニュー、パスワードマネージャー |
| VK 出力モードとして強制 | ローマ字を VK キーストロークで送信する | Chrome・Edge・Electron ベースのアプリ |
| TSF 出力モードとして強制 | TSF ネイティブモードで送信する | Windows Terminal など TSF 直結アプリ |
プロセス名・クラス名は awase.exe --debug で起動したときのログで確認できます。
| 項目 | 説明 |
|---|---|
| n-gram ファイル | n-gram 統計データのパス（.csv.gz または .toml）。ngram_predictive モードで使用 |
| n-gram 調整幅 | n-gram 予測で同時打鍵閾値を調整する幅（ms） |
| n-gram 最小/最大閾値 | n-gram 予測で調整される閾値の下限・上限（ms） |
| フォーカスデバウンス | Alt+Tab 連続操作時の誤検知を防ぐ待機時間（ms） |
| IME ポーリング間隔 | マウスで言語バーを操作したときなどの変化を検出する周期（ms） |
| レイアウトディレクトリ | .yab ファイルを置くフォルダのパス |
awase の動作は config.toml で細かく調整できます。
以下がデフォルト値です。config.toml に [keys] セクションを追加して上書きできます。
複数キーを割り当てるには配列に追加してください: ["Ctrl+Shift+変換", "Ctrl+F8"]
グローバルホットキー（アプリのフォーカスに関係なく機能）は [general] の engine_toggle_hotkey = "Ctrl+Shift+F12" で設定します。
新しい Microsoft IME（Windows 10 20H1 以降）では unicode モードを推奨します。per_key / batched では入力が正しく処理されない場合があります。
自動起動は HKCU\Software\Microsoft\Windows\CurrentVersion\Run レジストリに登録されます。スタートアップフォルダは使用しません。
スタートメニューや検索バーで誤動作する場合は force_bypass に追加してください。
通常は自動検出で十分ですが、特殊なキーボードや IME を使う場合に手動設定します。
入力がおかしくなったときや、エンジンを強制的に止めたいときの操作です。
修飾キーがスタックした・IME が混乱した・保留中の文字が残っているなど、入力全体がおかしくなったときに使います。
方法 1 — トレイアイコン（マウスが使えるとき・より確実）
タスクバーの awase アイコンを右クリック →「プロセスを再起動」
awase プロセスを完全再起動します。スタックした状態を確実にクリアできます。
方法 2 — キーボードショートカット（パニックリセット）
Ctrl+無変換 → Ctrl+変換 → Ctrl+無変換 を 2秒以内 に素早く入力する
（IME-OFF → IME-ON → IME-OFF のシーケンス。同じキーの連打では発動しません）
方法 2 の効果：
成功するとトレイバルーン通知「状態をリセットしました」が表示されます。
Ctrl キーがスタックしているなど、通常のショートカットも効かない状態で NICOLA エンジンを強制的に止めたいときの最終手段です。 デフォルトで有効（無変換キーに割り当て済み）です。
操作： 無変換 を他のキーと同時押しせず、単独で 400ms 以内に3回 連打する
※ 通常の親指シフト入力中は「親指キー単独タイムアウト」としてカウントされるため、 タイピングの流れで誤発動しにくい設計になっています。
親指シフト配列は .yab ファイルで定義されています。複数の配列を使い分けることができます。
default_layout = "nicola.yab" でデフォルトを変更.yab ファイルを config.toml の layouts_dir に指定したフォルダに配置します（デフォルトは config/）.yab 形式の詳細は GitHub の README を参照してください。
動作がおかしいときはログを確認してください。
awase.exe と同じフォルダの awase.log（起動のたびに追記されます）%USERPROFILE%\scoop\apps\awase\current\awase.log詳細なログが必要な場合はコマンドプロンプトからデバッグモードで起動します。
または環境変数 RUST_LOG=debug を設定してから起動しても同じです。
Windows の「設定 → アプリ」または「コントロールパネル → プログラムのアンインストール」から awase を選択してアンインストールします。
初めて使うときの推奨手順です。
confirm_mode = "ngram_predictive"（推奨）で試す"wait" に変更（正確だがやや遅め）"adaptive_timing" を試す「あ」が一瞬チラッと見えることがあります（捨て打ち機能）
Chrome や Windows Terminal では、IME ON 直後の最初の入力時に「あ」が瞬間的に表示されてすぐ消えることがあります。 これは 捨て打ち機能 が正常に動作しているサインです。
Chrome などの TSF アプリでは IME の入力受付が完了しているかどうかを外部から確認する公式な手段がありません。 そこで awase は「A キーを打って BS で消す」という操作を画面描画前に一瞬行い、 IME が「あ」に変換できたかどうかを観測することで入力受付の完了を確認しています。 この捨て打ちで得た情報をもとに、本来打ちたい文字を正確なタイミングで送ります。 通常は画面に何も表示されませんが、タイミングによって「あ」がほんの一瞬見えることがあります。