meeting-translator 取扱説明書

英語会議のリアルタイム翻訳＆質問サジェスト・オーバーレイ

1. できること

• リアルタイム字幕：話者の英語をその場で文字起こしし、日本語訳を逐次表示します。
• 質問・確認事項のサジェスト：会話の文脈から「いま聞くと良い質問」を日本語＋英語表現つきで自動提案します（既定で約8秒ごと）。
• ハイライト（要約）：会話の要点を一定間隔で自動要約し、時系列で蓄積します（既定で約90秒ごと）。
• ピン留め：重要な質問カードを固定エリアに留めて、流れても見失わないようにできます。
• 立場の設定：あなたの役割（例：営業担当者）を伝えると、提案がその立場に最適化されます。
• 用語集：社内用語・固有名詞の訳語を登録して翻訳精度を上げられます。
• ログ保存：英語原文＋日本語訳の全文を Markdown ファイルとして保存できます。
• 常に最前面・半透明表示：会議ウィンドウに重ねて使える、枠なしオーバーレイUI。

2. 動作環境・技術構成

ElectronTypeScript Deepgram Nova-3Claude API Web Audio API

3. APIキーの取得

本アプリの利用には、音声認識用と翻訳用の2つのAPIキーが必要です。先に取得しておきましょう。

Deepgram APIキー（音声認識）

1. console.deepgram.com にアクセスしてサインアップ／ログインします。
2. プロジェクトを選択（または新規作成）します。
3. 「API Keys」から新しいキーを作成します。
4. 表示されたキーをコピーしておきます（後で設定画面に貼り付けます）。

Anthropic APIキー（翻訳・提案・要約）

1. console.anthropic.com にアクセスしてサインアップ／ログインします（支払い設定が必要です）。
2. 「API Keys」から新しいキーを作成します。
3. 表示されたキーをコピーしておきます。

4. インストールと起動

方法A：ビルド済みアプリを使う（Windows 配布版）

配布された release/ 内のインストーラー（NSIS）またはポータブル版 .exe を実行します。インストール後はアイコンから起動できます。

方法B：ソースから動かす（開発者向け）

# 依存関係のインストール
npm install

# ビルド（TypeScript → dist/）
npm run build

# 起動
npm start

主なコマンド：

5. 初回設定

1. アプリを起動し、右上の ⚙（設定）を開きます。
2. Deepgram APIキー と Anthropic APIキー をそれぞれ入力します。
3. 音声ソース を選びます。Windowsの会議音声を翻訳するなら 「システム音声（Windows）」、マイクで試すなら「マイク（開発用）」。
4. 必要に応じて翻訳モデルや不透明度などを調整します。
5. 保存 を押します。キーが正しく保存されると「（設定済み）」と表示されます。

6. 画面の見かた

起動すると、以下のような枠なしオーバーレイが表示されます（実際の配色・レイアウトを再現）。

▲ 実際のUIを再現したイメージ

7. 基本的な使い方

1. 会議を開始し、音声が再生される状態にします（Windowsの場合は「システム音声」を選択）。
2. アプリの ◉ を押して録音を開始します。接続ランプが緑になれば動作中です。
3. 左パネルに字幕（英語＋日本語訳）が流れ始めます。
4. 右下に質問・確認事項が自動で提案されます。良いものは 📌 でピン留め。英語表現は EN ▼ で表示／非表示。不要なら ✕ で削除。
5. 右上にハイライトが蓄積されていきます。
6. 会議が終わったら再度 ◉ で停止します。
7. 💾 を押すと、英語原文＋日本語訳の全文を Markdownログとして保存できます。

8. 設定項目の詳細

用語集の書き方

社内用語や固有名詞の訳をブレなくするために登録します。1行に1項目、英語 = 日本語 の形式です。

ARR = 年間経常収益
Q1 = 第1四半期
churn = 解約率

9. モデル選択とコスト

翻訳・提案・要約はそれぞれ独立してモデルを選べます。リアルタイム性とコスト重視なら Haiku、品質重視なら Sonnet / Opus。

10. 便利な使い方

• ピン留めを活用：本当に聞きたい質問は 📌 で固定。新着提案が流れても見失いません。
• 英語表現をその場で確認：提案の EN ▼ を開けば、そのまま口頭で使える英語フレーズが見られます。
• 不透明度を下げる：会議資料に重ねて使うときは背景を薄くすると見やすくなります。
• 手動更新：もっと提案／要約が欲しいときは各パネルの ↻ で即生成。
• ログを議事録に：保存した Markdown はそのまま議事録のたたき台になります。

11. トラブルシューティング

12. 仕組み（参考）

内部では音声からの処理が複数のレーンに分かれて並行動作します。

会議音声
   ↓ 音声キャプチャ（16kHz PCM）
Deepgram STT  →  英語テキスト（途中経過＋確定）
   ↓
フラグメント結合（短い相槌などを整理）
   ↓
┌──────────────┬──────────────┬──────────────┐
│ 翻訳レーン    │ 提案レーン     │ 要約レーン     │
│ 英→日 翻訳    │ 質問を約8秒毎  │ ハイライトを   │
│              │ に生成         │ 約90秒毎に生成 │
└──────────────┴──────────────┴──────────────┘
   ↓
画面表示（字幕・質問・ハイライト）＋ Markdown ログ

• 文脈考慮：直近の会話履歴を踏まえて翻訳・提案します。
• 重複抑制：直近の提案・要約と重複しないよう調整します。
• プロンプトキャッシュ：API コストを抑える最適化を行っています。
• 自動再接続：音声認識が切れても指数バックオフで復帰を試みます。