整形と辞書

すべての音声入力は、Mac の中で同じ短いパイプラインを通ります。ここではネットワークを一切使いません。

パイプライン

1. 1

   選択したエンジンによる音声認識。

2. 2

   カスタム辞書による置換。常に適用されます。

3. 3

   整形 — ルールベース、またはオプトインした場合はローカル LLM — 最前面のアプリで整形が有効なときにのみ実行されます。

4. 4

   ペーストまたはタイピングによる挿入。

ルールベースの整形

これがルールのすべてです。整形は、言いかけの中断や "like" という語を取り除きません。

• 単独で現れる "um"、"uh"、"erm"、および 2 語の "you know" を、トークン全体が一致する場合にのみ取り除きます。
• 直後に続く単語の繰り返しをまとめます。たとえば "the the" は "the" になります。
• 余分な空白をまとめます。
• 先頭の文字を大文字にします。
• 文字または数字で終わっている場合は、ピリオドを付け加えます。

アプリごとの上書き

設定 › Enhancement › "Clean up transcripts by default" はオンです。上書きは、アプリのバンドル ID をキーに保存されます。"Add current app…" は、直前に使った Keebye 以外のアプリを、既定と逆の設定で追加します。各項目には、チェックボックスと "Remove" ボタンがあります。

カスタム辞書

設定 › Dictionary："Replace spoken words with fixed spellings."（話した言葉を決めた綴りに置き換えます）。Keebye が聞き取る言葉を "heard as…" に、書いてほしい綴りを "write as…" に入力して、Add を押します（Enter でも動きます）。Remove で項目を削除します。項目がないときは "No replacements yet." と表示されます。

• 単語全体にのみ一致し、より長い単語の内部には一致しません。
• 一致は大文字と小文字を区別しません。置き換えたあとの文字列は、入力したとおりの大文字小文字になります。
• キーは複数の語でもかまいません。最も長く一致したものが選ばれます。
• そのアプリで整形が有効かどうかに関係なく、すべての音声入力に適用されます。

ローカル LLM による仕上げ（オプトイン）

Keebye は、ルールベースの整形の代わりに、書き起こしをローカルの言語モデルに渡すこともできます。モデルは Qwen3-1.7B（Q4_K_M GGUF、約 1.28 GB）で、Metal を使う llama.cpp 上で動作します。thinking を無効にした貪欲サンプリング、64 トークンの上限、2 秒の締め切りで実行します。失敗した場合は、ルールベースの整形に戻ります。

忠実性のガードが、LLM の出力を使う前に確認します：入力に現れた単語の少なくとも半分を保っていること、入力の単語数の 2 倍に 4 を足した数を超えないこと、同じ文や 4 語のフレーズが 3 回以上繰り返されていないこと、空でないこと。条件を満たさない場合、LLM の出力は破棄されます。