安装
首次使用前的环境准备
快速使用
用户: 安装环境
用户: 初始化
依赖清单
| 依赖 | 用途 | 安装命令 |
|---|---|---|
| Node.js | 运行脚本 | brew install node |
| FFmpeg | 视频剪辑 | brew install ffmpeg |
| curl | API 调用 | 系统自带 |
API 配置
火山引擎语音识别
控制台：https://console.volcengine.com/speech/new/experience/asr?projectName=default
- 注册火山引擎账号
- 开通语音识别服务
- 获取 API Key
配置到项目目录 .claude/skills/.env：
# 文件路径：剪辑Agent/.claude/skills/.env
VOLCENGINE_API_KEY=your_api_key_here
安装流程
1. 安装 Node.js + FFmpeg
↓
2. 配置火山引擎 API Key
↓
3. 验证环境
执行步骤
1. 安装依赖
# macOS
brew install node ffmpeg
# 验证
node -v
ffmpeg -version
2. 配置 API Key
# 在项目 .claude/skills/ 目录下创建 .env 文件
echo "VOLCENGINE_API_KEY=your_key" >> .claude/skills/.env
3. 验证环境
# 检查 Node.js
node -v
# 检查 FFmpeg
ffmpeg -version
# 检查 API Key（在项目目录下执行）
cat .claude/skills/.env | grep VOLCENGINE
常见问题
Q1: API Key 在哪获取？
火山引擎控制台 → 语音技术 → 语音识别 → API Key
Q2: ffmpeg 命令找不到
which ffmpeg # 应该输出路径
# 如果没有，重新安装：brew install ffmpeg
Q3: 文件名含冒号报错
FFmpeg 命令需加 file: 前缀：
ffmpeg -i "file:2026:01:26 task.mp4" ...