安装 VideoMotion
VideoMotion 与 MotionFly 共享 ~/.motionfly 下的 Python 环境和模型:如果机器已运行 MotionFly,则无需重新下载任何内容。
所有插件技能共用的变量(在 Bash 中运行):
VV="${CLAUDE_PLUGIN_ROOT}"
PY="$HOME/.motionfly/venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$HOME/.motionfly/venv/bin/python"
export PYTHONUTF8=1 HF_HUB_DISABLE_PROGRESS_BARS=1
步骤 1. 检查
使用任意系统 Python(3.10 或更高版本)运行:
python "$VV/tools/setup/doctor.py"
读取结果表格。如果必要组(Node.js 22+、ffmpeg、ffprobe、ffmpeg loudnorm、HyperFrames)中出现缺失项,则告知用户手动安装,并附上注释列中的链接。请勿自行安装系统软件。
步骤 2. 安装 Python 包和模型
如果缺少“Python 环境”或“VieNeu 语音”,请向用户发送一条确认询问(将下载约 2 到 3 GB:Python 包、VieNeu 模型、Whisper large-v3-turbo 模型),然后在后台运行:
python "$VV/tools/setup/doctor.py" --install > "$HOME/.motionfly/install.log" 2>&1
该命令会在 ~/.motionfly/venv 创建虚拟环境(如果可用则使用 uv),安装 vieneu、faster-whisper、soundfile、numpy、scipy,下载模型,并自动修复 Hugging Face 缓存的符号链接问题(ONNX Runtime 报错“External data path escapes model directory”)。
步骤 3. 为 Claude 安装 HyperFrames 技能
如果“Claude 的 HyperFrames 技能”行显示可选(未安装),建议用户运行 npx [email protected] skills。拥有该技能集可使构图编写更规范;即使没有,也可通过 agents/vm-canh.md 中的技术约定继续运行。
完成
再次运行步骤 1。如果看到就绪,则告知用户输入 /videomotion 并附上视频需求。
注意:如果机器没有 NVIDIA 显卡,VieNeu 语音将在 CPU 上运行(对于中端机器,每秒钟语音大约耗时 0.4 秒),背景音乐可使用用户提供的文件或通过代码合成。