设置检查（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。 - 任何需要管理员权限的操作：向用户提供要在管理员终端中运行的确切命令。