---

name: videocut:安装 description: 环境准备。安装依赖、下载模型。触发词：安装、环境准备、初始化

安装

首次使用前的环境准备（本地模式）

快速使用

Copy用户: 安装环境
用户: 初始化

依赖清单

模型清单

首次运行自动下载到 ~/.cache/modelscope/：

安装步骤

1. 安装系统依赖

Copy# macOS
brew install python node ffmpeg

# Ubuntu
sudo apt install python3 python3-pip nodejs ffmpeg

2. 安装 Python 依赖

Copypip install funasr modelscope

3. 下载模型（约2GB）

Copycd /path/to/videocut-skills/安装/scripts

# 自动下载所有模型
python test_funasr_local.py --download

4. 验证环境

Copycd /path/to/videocut-skills/安装/scripts

# 快速验证（检查依赖）
python test_funasr_local.py

# 综合验证（加载完整模型）
python test_funasr_local.py --verify

成功输出：

Copy🎉 本地模式完全就绪！可以使用以下命令转录：

   python 剪口播/scripts/transcribe_local.py video.mp4

---

完整安装流程

Copy1. 安装系统依赖（Python、Node.js、FFmpeg）
       ↓
2. 安装 Python 依赖（funasr、modelscope）
       ↓
3. 下载模型（约2GB）
       ↓
4. 验证环境
       ↓
5. 完成 ✅

---

常见问题

Q1: 模型下载慢

解决：使用国内镜像或手动下载

Q2: ffmpeg 命令找不到

解决：确认已安装并添加到 PATH

Copywhich ffmpeg  # 应该输出路径

Q3: Node.js 版本太低

解决：需要 Node.js 18+

Copynode --version  # 需要 v18.x 或更高

Q4: pip 和 python 版本不一致

解决：确保 pip 和 python 指向同一个版本

Copy# 检查版本
python --version
pip --version

# 如果不一致，在 ~/.zshrc 添加 alias
alias python=python3.11
alias pip=pip3.11