VoxyFlow スタートアップガイド
VoxyFlowのインストール方法から基本的な使い方、各種AI翻訳エンジンの接続設定まで、網羅的に説明します。
拡張機能の導入
ChromeウェブストアからVoxyFlowをワンクリックで導入できます。会員登録や初期登録は一切不要です。
AIエンジンの選択と登録
VoxyFlowは完全に無料で提供されており、プライバシー保護と永続的な運用のために、各自のAPI接続情報を使用する「Bring-Your-Own-Key」モデルを採用しています。
DeepL API (推奨)
Recommended極めて高速で自然なコンテキスト翻訳が可能です。DeepLの「API Free」プランなら、毎月50万文字まで完全に無料で翻訳枠を利用できます。日々の読解学習に最も適しています。
Get DeepL API KeyOpenRouter (クラウドAI大モデル)Advanced
Gemini 2.5 FlashやClaude 3.5、DeepSeekといったクラウド上の最先端AIに接続し、複雑な長文の解読などに利用できます。
Get OpenRouter API KeyOllama (ローカルオフラインAI)Offline
自身のPC上でオープンソースのAI（translategemma:2bなど）をローカル実行します。データが機外に出ず、オフラインでも完全に動作します。
デフォルト状態のOllamaはブラウザ拡張機能からの通信を遮断（CORS制限）します。利用時には必ず以下の設定を行ってください：
macOS：ターミナルで `launchctl setenv OLLAMA_ORIGINS "*"` を実行後、Ollamaアプリケーションを完全に再起動します。
Windows：システム環境変数（またはユーザー環境変数）に名 `OLLAMA_ORIGINS`、値 `*` を追加し、Ollamaを再起動します。
Value: *
Linux：`sudo systemctl edit ollama.service` を実行し、`[Service]` セクションの下に `Environment="OLLAMA_ORIGINS=*"` を追記して、サービスを再起動します。
ツールバーへの固定
利便性を高めるため、Chromeのパズルアイコン 🧩 をクリックし、VoxyFlowの横にあるピンマーク 📌 をクリックしてツールバーに常駐させます。
ピン留めされたVoxyFlowアイコンをクリックしてクイック設定を開きます。取得したAPIキーを入力し、AIモデルを選択して「保存」します。
3つの翻訳アプローチ
Webページのレイアウトや閲覧の流れに合わせて、複数の表示方法を選べます：
ホバーモード：設定したキーを押したまま、マウスを調べたい単語に合わせるだけで、即座にその場に翻訳が出現します。
ドラッグ選択モード：調べたい語句や文をドラッグで選択し、起動キーを押すと、発音読み上げや辞书保存ボタンのあるウィンドウが現れます。
PDFと右クリックメニュー：選択範囲上で右クリックし、「Translate with VoxyFlow」を選択します。テキスト形式のPDF書類などを読み込む際に便利です。
ショートカット操作（キーボード）
キーボードから手を離さずに操作可能なため、思考のスピードを損なうことなく読解に没頭できます。
システム起動キー
翻訳ウィンドウ内での各機能キー
ダッシュボード：Flowと辞書
これまでに調べた履歴はすべて学習リソースになります。サイドパネルを活用して効率的に言葉を整理しましょう：
手動翻訳パネル：調べたいテキストを直接入力できます。「Flowに自動送信」を有効にすると履歴に自動で残ります。
Flow履歴タイムライン：調べた語彙が、元のウェブページのコンテキスト（例文）ごと時系列順に並びます。
スマートな分類：単語と長めのフレーズが自動で判別され、異なるタブへ整理されるため、復習がスムーズです。
Anki
Export to Anki: 生詞と例文が入ったCSVファイルをダウンロードし、手持ちのAnkiデッキに直接インポート可能です。
Quizlet
Import to Quizlet: 専用フォーマットのテキストを一発でクリップボードにコピーし、モジュールの新規作成画面で貼り付けるだけで完了します。
バックグラウンド処理
ストレスフリーな動作と、無駄なAPI消費を避けるための設計が施されています：
3段階の賢いキャッシュ：メモリ上およびIndexedDB内に14日間保存. 同一単語の再翻訳は完全に無料で瞬時に行われます。
エラーからの保護：接続エラー発生時は一時的に通信を遮断し、API側でのスパム判定によるアカウント封禁を防ぎます。
自動言語識別補助：非常に短い文字の場合、ページの `html lang` タグを参照して言語の誤認を防止します。
大模型翻訳時のホバー無効化：トークン消費の抑制とレスポンス時間を考慮し、大規模モデル利用時はホバー翻訳が無効化され、タイムアウト制限時間がやや延長されます。