@optima-chat/video-edit-tools

Descript-mode speech video editing CLI. 你直接重写"成片应该说什么"的脚本,系统用文本对齐回原始音频时间戳,剪出成片。

安装

npm install -g @optima-chat/video-edit-tools

系统依赖

• Python 3.x(脚本本体)
• ffmpeg / ffprobe(音视频处理)— apt-get install ffmpeg 或 brew install ffmpeg
• curl(调 Groq Whisper API)
• GROQ_API_KEY 环境变量(转写功能必需)

用法

# 分析:转写 + 静音检测 + 生成 cut_proposal
video-edit analyze <input.mp4>

# 写 final_script.txt 到 <input>.work/(由 LLM agent 或人写)

# 智能剪:按 final_script 对齐时间戳剪辑
video-edit smart-cut <input.mp4>

# 检查:成片重转写诊断
video-edit review <input.mp4>

# 烧字幕:生成 subs.ass + ffmpeg 烧入
video-edit subtitle <input.mp4>

# 旧模式(弃用,质量差)
video-edit cut <input.mp4>
video-edit both <input.mp4>

历史

• 原仓库:Optima-Chat/optima-ai-shell 的 docker/video-edit/
• 2026-05-08 迁移到本仓库(closes optima-ai-shell#125)
• 没重写 TS,后续可能 TS 化(单独 PR)

License

MIT