設定檢查 (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。 - 任何需要管理員權限的操作：直接給使用者可在管理員終端機中執行的確切指令。