セットアップ確認 (Windows)
すべてをインストールまたは修復します（無人実行、再実行しても安全、成功時は.setup-okを書き込みます）:
powershell -NoProfile -ExecutionPolicy Bypass -File tools/setup.ps1
自動では対処できない場合、SETUP FAILED: <理由> と修正方法を出力します。
既知の正常なセットアップ:
| ツール | 入手先 |
|---|---|
| Node.js 22+ | winget OpenJS.NodeJS.LTS → C:\Program Files\nodejs |
| FFmpeg / FFprobe | winget Gyan.FFmpeg |
| 文字起こし / AI音声 | tools/transcribe-deepgram.ps1 経由のDeepgram API、キーはユーザー環境変数 DEEPGRAM_API_KEY |
| Chrome | システムインストール、または npx --yes hyperframes browser ensure によるプライベートコピー |
| HyperFrames スキル | %USERPROFILE%\.agents\skills (+ .claude\skills) |
whisper.cpp のインストールやローカル文字起こしモデルの実行はしないでください（一般的なPCでは動作が遅く、ノイズが多いため）。
確認
npx -y hyperframes doctor
Docker、Kokoro (TTS)、MusicGen、whisper‑cpp はここでは不要です — これらは無視してください。
よくある修正
- Deepgramキー: ユーザー自身が
powershell -NoProfile -ExecutionPolicy Bypass -File tools/set-deepgram-key.ps1を実行します（チャットにキーを貼り付けないでください）。スクリプトは、以前のターミナルでもユーザースコープの値を読み取ります。 - セットアップ直後に
node/ffmpegが見つからない: ターミナルでPATHを更新します（$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')）またはエディタを再起動します。 - 「スクリプトの実行が無効になっています」: 常に
powershell -NoProfile -ExecutionPolicy Bypass -File ...でスクリプトを呼び出してください。 - Deepgram 401: キーが間違っているか期限切れ — ユーザーに再度設定してもらいます。402/429: クレジット不足 / レート制限。
- スキル / CLIの更新:
npx -y hyperframes skills update、npx -y hyperframes upgradeを実行します。 - 管理者権限が必要なものは、管理者ターミナルで実行する正確なコマンドをユーザーに提示します。