Communitygithub.com

andyluu98/VideoMotion

检查并安装 VideoMotion 所需的所有依赖(Node.js、ffmpeg、HyperFrames、Python 环境、VieNeu 语音、Whisper)。适用于新安装插件时,用户输入“/vm-cai-dat”、“cài đặt video”、“kiểm tra máy làm video”,或某个视频制作步骤提示缺少工具时。

VideoMotion 是什么?

VideoMotion 是用于 AI 视频生成工作流中,自动检查与安装必备工具和环境的技能。它依赖于与 MotionFly 共享的 Python 虚拟环境和模型(位于 ~/.motionfly),因此如果机器已在运行 MotionFly,则无需重复下载。该技能通过运行 doctor.py 脚本全面检测系统环境,包括 Node.js(≥22)、ffmpeg、ffprobe 以及 ffmpeg loudnorm 滤镜,并检查 HyperFrames 支持。对于缺失的 Python 环境和模型(VieNeu 语音模型、faster-whisper 等),它会在获得用户确认后,自动创建虚拟环境、安装依赖(如 vieneu、faster-whisper、soundfile、numpy、scipy)并下载模型,同时自动修复 Hugging Face 缓存的符号链接问题。详细指导用户安装超帧技能(通过 npx hyperframes),提升构图编写。最终验证通过后,提示用户可输入 `/videomotion` 开始视频制作。该技能适用于 Claude Code 等插件环境,以 Bash 脚本执行,并自动导出公用变量。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/andyluu98/VideoMotion/tree/HEAD/skills/vm-cai-dat

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

安装 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 秒),背景音乐可使用用户提供的文件或通过代码合成。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

andyluu98/VideoMotion

Làm video tiếng Việt từ một yêu cầu, AI làm đạo diễn, không khung dựng sẵn: ý tưởng lớn, kịch bản, giọng VieNeu, phân cảnh theo lời, nhạc nền, dựng từng cảnh bằng agent Sonnet chạy song song (HyperFrames + GSAP), phụ đề, xuất MP4. Dùng khi người dùng gõ "/videomotion", "làm video", "video giải thích", "clip ngắn về X", "biến bài này thành video".

andyluu98/VideoMotion

Dựng hình cho dự án VideoMotion đã có giọng và phân cảnh: tải phông của style, viết màu, giao từng cảnh cho agent vm-canh chạy song song, ghép, kiểm tra kỹ thuật, render, ghép âm thanh và phụ đề. Dùng ở bước 7 của /videomotion, hoặc khi người dùng nói "dựng lại cảnh", "render", "xuất video", "sửa hình cảnh X".

andyluu98/VideoMotion

Sinh giọng đọc tiếng Việt bằng VieNeu-TTS từ script.json của một dự án video, tự chấm phát âm bằng Whisper, giữ bản đọc tốt nhất, lấy mốc thời gian từng từ (voice.wav, words.json). Dùng ở bước 4 của /videomotion, hoặc khi người dùng nói "sinh giọng", "đọc lại câu", "đổi giọng", "sửa phát âm".

andyluu98/VideoMotion

Chọn hoặc tạo nhạc nền cho dự án video, đo nhịp, rồi trộn với giọng (nhạc tự hạ khi có lời, chuẩn -14 LUFS). Dùng ở bước 6 của /videomotion, hoặc khi người dùng gửi file nhạc, nói "đổi nhạc", "nhạc sôi động hơn", "nhạc nhỏ lại".

相关技能