イマージョン・ランゲージ・ラーニング・アシスタント

illa-helperは、ユーザーが没入型の体験を通して外国語を学ぶのを助けるために設計されたオープンソースのブラウザプラグインです。ウェブブラウジング中にリアルタイム翻訳、発音ガイド、語彙解析を提供します。このプラグインはChromeとFirefoxブラウザをサポートし、明快で拡張が容易なVue 3フレームワークに基づいています。ユーザーは翻訳モデルやAPIキーの調整など、設定をカスタマイズすることができる。illa-helperは、日常的なブラウジング中に自然に言語スキルを向上させたい学習者に特に適している。プロジェクトはGitHubでホストされており、開発者は自由に貢献し、機能を最適化することができる。

機能一覧

• リアルタイム翻訳：ウェブページ上の外国語テキストを、ユーザーにとって使い慣れた言語に翻訳する。
• 発音アシスト：Youdao TTSとWeb Speech APIを通じて、単語やフレーズの発音を提供します。
• 語彙解析：単語の発音記号、定義、例文を表示し、インタラクティブなインターフェイスをサポートします。
• カスタム設定：ユーザー設定可能なAPIキー、翻訳モデル、温度パラメータをサポート。
• クロスブラウザ対応：ChromeとFirefoxに対応し、異なるブラウザの機能にも対応。
• ホバーボックス・インターフェイス：直感的なホバーボックスで翻訳や発音情報を表示します。
• オフラインストレージ：ユーザー設定を保存し、パーソナライズされたエクスペリエンスがデバイス間で同期されるようにします。

ヘルプの使用

設置プロセス

1. プラグインのソースコードをダウンロードする
   インタビュー https://github.com/xiao-zaiyi/illa-helperCode "ボタンをクリックし、"Download ZIP "を選択してソースコードをダウンロードするか、Gitコマンドを使ってリポジトリをクローンする：

   git clone https://github.com/xiao-zaiyi/illa-helper.git
   

2. 依存関係のインストール
   ファイルを解凍した後、プロジェクト・ディレクトリに移動し、必要な依存関係をインストールするために以下のコマンドを実行する：

   npm install
   

   Node.jsとnpmがインストールされていることを確認する。

3. 環境変数の設定
   プロジェクトのルート・ディレクトリに .env ファイルに、例えばAPIキーや設定を追加する：

   VITE_WXT_DEFAULT_API_KEY="sk-your-real-api-key"
   VITE_WXT_DEFAULT_API_ENDPOINT="https://xxxxx/api/v1/chat/completions"
   VITE_WXT_DEFAULT_MODEL="gpt-4"
   VITE_WXT_DEFAULT_TEMPERATURE="0.2"
   

   これらの設定は、翻訳および発音サービスに接続するために使用されます。注意してください：.env ドキュメントが追加されました .gitignore鍵は確保されている。

4. プラグインの構築
   ターゲットブラウザに基づいてビルドコマンドを実行する：
   • クロム／エッジ

     npm run build:chrome
     

   • ファイアフォックス

     npm run build:firefox
     

   ビルドが完了すると、出力ファイルは以下の場所に置かれる。 .output/chrome-mv3(クローム）または .output/firefox-mv2(Firefox）。

5. プラグインの読み込み
   • クロームブラウザを開き chrome://extensions/デベロッパーモード」を有効にしたい場合は、「拡張機能の読み込み」をクリックし、「拡張機能の読み込み」を選択します。 .output/chrome-mv3 フォルダー
   • ファイアフォックスアクセス about:debugging#/runtime/this-firefox一時アドオンの読み込み」をクリックし、以下を選択します。 .output/firefox-mv2 フォルダーに保存されます。プラグインは自動的にロードされます。

使用方法

インストール後、illa-helperはブラウザ上で起動します。以下、主な機能の詳細手順です：

リアルタイム翻訳

1. 任意のWebページを開き、翻訳するテキストを選択します。
2. このプラグインは、自動的に外国語のコンテンツを検出し、ホバーボックスに翻訳結果を表示します。
3. ユーザーは、ホバーボックスの「コピー」ボタンをクリックして、翻訳をクリップボードに保存することができます。
4. 翻訳言語を変更したい場合は、プラグインのオプションページ（プラグインアイコンを右クリックし、"オプション "を選択）に移動し、ターゲット言語を設定します。

発音補助

1. 単語またはフレーズを選択すると、ホバーボックスに発音ボタン (ᔊ) が表示されます。
2. 発音ボタンをクリックすると、プラグインはYoudao TTSまたはWeb Speech APIを介して音声を再生します。
3. ユーザーはアーティキュレーションのスピードやボイスのタイプを調整することができます（オプションページで設定します）。

字句解析

1. ホバーボックスには、選択したテキストの発音記号、定義、例文が表示されます。
2. 詳細」ボタンをクリックすると、辞書の詳細情報（単語の特性、類義語など）が表示されます。
3. 語彙を保存する必要がある場合は、「Add to vocabulary」をクリックすると、プラグインが語彙をローカルに保存します。

カスタマイズされた設定

1. プラグインのオプションページを開き、APIキーまたは翻訳モデル（デフォルト）を変更する。 gpt-4).
2. アダプト VITE_WXT_DEFAULT_TEMPERATURE パラメータ（0.0-1.0）は、翻訳の創造性を制御します（低い値はより正確で、高い値はより柔軟です）。
3. 設定が完了したら、「保存」をクリックすると、プラグインが自動的に設定を同期します。

ほら

• 翻訳・発音機能が正常に動作するよう、安定したインターネット接続を確保してください。
• Firefoxユーザーは、プラグインがFirefoxでのストレージ機能のために特定のIDを必要とすることに注意してください。 wxt.config.ts ミディアム構成：

  browser_specific_settings: {
  gecko: {
  id: 'illa-helper@xiao-zaiyi',
  strict_min_version: '88.0'
  }
  }
  

• API接続に問題がある場合は .env キーとエンドポイント・コンフィギュレーションをファイルに記述する。

アプリケーションシナリオ

1. 外国語学習
   学生や独学者が外国語のウェブサイトを閲覧している間、illa-helperを使って翻訳や発音をリアルタイムで取得し、コンテンツを素早く理解し、新しい語彙を学ぶことができます。
2. 学術研究
   研究者が外国語の文献を読むとき、このプラグインは専門用語を翻訳し、生の単語を保存して読書効率を向上させる。
3. 毎日のブラウジング
   非ネイティブスピーカーは、ソーシャルメディアやニュースを閲覧する際に、外国語のコンテンツを素早く理解し、情報へのアクセスを強化するためにプラグインを使用する。
4. 開発者のデバッグ
   開発者は、ソースコードや設定を変更することによって、プラグインのパフォーマンスを最適化するために、異なる翻訳モデルやAPIをテストすることができます。

品質保証

1. illa-helperはどのブラウザに対応していますか？
   現在、ChromeとFirefoxがサポートされており、それぞれChrome Manifest V3とFirefox Manifest V2を使用しています。
2. 利用するのにお金は必要ですか？
   illa-helperはオープンソースプロジェクトであり、無料でご利用いただけます。ただし、翻訳や発音サービスのAPIキーは自分で取得する必要があり、費用がかかる場合があります。
3. プラグインをアップデートするには？
   GitHubから最新のコードを取得し、ビルドとロードのプロセスを再実行して更新する。
4. 翻訳が正確でなかったら？
   APIキーとモデルの設定を確認するか、あるいは VITE_WXT_DEFAULT_TEMPERATURE パラメーター
5. オフラインで使用できますか？
   いくつかの機能（ローカルストレージなど）はオフラインでサポートされていますが、翻訳と発音にはインターネットアクセスが必要です。