安裝 VideoMotion
VideoMotion 與 MotionFly 共用 Python 環境和模型,位置在 ~/.motionfly:如果已經執行過 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)中有顯示 THIẾU(缺少)的項目,請通知使用者自行安裝,並附上備註欄中的連結。請勿自行安裝系統軟體。
步驟 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 技能」一行顯示為 tùy chọn(選用,尚未安裝),建議使用者執行 npx [email protected] skills。擁有這組技能後,場景撰寫會更標準化;即使沒有安裝,仍可透過 agents/vm-canh.md 中的技術合約正常運作。
完成
再次執行步驟 1。如果看到 SAN SANG(就緒),請通知使用者輸入 /videomotion 並附上影片要求。
備註:若電腦沒有 NVIDIA 顯示卡,VieNeu 語音將在 CPU 上執行(在中階電腦上,每秒語音約需 0.4 秒處理時間),背景音樂可使用使用者提供的檔案或以程式合成。