企业官网建设流程全解析

Video-Use 快速上手完整指南：AI视频编辑装进代理，对话式剪出成片

【免费下载链接】video-useEdit videos with coding agents项目地址: https://gitcode.com/GitHub_Trending/vid/video-use

video-use 是个开源视频编辑工具：把原始素材丢进一个文件夹，跟 AI 代理说一句"剪成一条发布视频"，剩下的视频剪辑、调色、字幕全自动，最后交给你能直接发的 final.mp4。

看懂它的读片方式

它背后的 AI 从不逐帧看画面，而是靠两层信息做剪辑：一层是常驻的音频转录，ElevenLabs Scribe 提供词级时间戳和说话人信息，所有 take 打包成一个约 12KB 的 takes_packed.md，成为代理的主要"读物"；另一层是按需生成的视觉合成图，只在拿不准的切点调出来看一眼。一条 40 秒素材，代理读的是几 KB 文本加几张 PNG，而不是一万帧画面。

一键装好全部依赖

先克隆到稳定路径，别放 /tmp 或下载目录：

git clone https://gitcode.com/gh_mirrors/vid/video-use ~/Developer/video-use

Python 依赖用 uv 或 pip 二选一：

cd ~/Developer/video-use && uv sync # 或 pip install -e .

再把 ffmpeg 装上（macOS 跑brew install ffmpeg，Linux 用 apt 或 pacman）。依赖一览：

把技能接进你的代理

注意软链的是整个仓库目录——helpers/ 必须和 SKILL.md 做邻居，路径随代理而变：

代理没有技能目录时，就在它的系统提示或配置里加一行指向 SKILL.md 的路径。

配好 ElevenLabs 密钥

转录全靠 Scribe，没密钥就没法开工：

1. 注册 ElevenLabs 账号，在 API Keys 页面复制一个密钥。
2. 仓库根目录跑cp .env.example .env，填入ELEVENLABS_API_KEY=你的密钥，别提交到 git。
3. 发一个最便宜的请求验证：返回 200 通过，401 说明粘错或过期，完整命令见 install.md。

跑通从素材到成片的全流程 🎬

五步走，你只在第三步拍板：

1. 扫描素材：ffprobe 逐个探测源文件的时长和分辨率。
2. 词级转录：transcribe_batch.py 并行转录，再打包成 takes_packed.md。
3. 策略确认：代理用大白话描述看到的内容，给出 4-8 句的策略（结构、选哪条 take、调色、字幕），等你点头才动手。
4. 自动剪辑：生成 edl.json，动画在并行子代理里构建，逐段调色后拼接，字幕最后烧入。
5. 自检：对渲染出的成片在每个切点附近跑 timeline_view，检查画面跳变、音频爆音、字幕被挡，发现问题自动修复重渲，最多三轮，通过才给你看。

剪辑的硬规则和脚本用法分别在 SKILL.md 和 helpers/。所有产物落在素材目录旁的edit/里，仓库本身保持干净：

<素材目录>/ └── edit/ ├── project.md # 会话记忆，每次追加 ├── takes_packed.md # 打包后的转录文本 ├── edl.json # 剪辑决策 ├── transcripts/ # 原始转录缓存 ├── animations/ # 动画源与渲染 ├── clips_graded/ # 调色后的片段 └── final.mp4 # 成片

定制你的成片风格

调色用 grade.py：内置 warm_cinematic（暖调电影感）、neutral_punch（中性增强）两个预设，也接受任意 ffmpeg 滤镜串自己调。字幕默认双词大写块，字体、大小、颜色、边距都能改，风格不对就让代理重新设计。需要叠加动画时按槽位选引擎，全部按需安装、装进对应 slot 目录：

• HyperFrames：HTML/CSS 动效合成，适合产品界面动画，需 Node.js 22+
• Remotion：React 组件式，npx create-video@latest搭脚手架
• Manim：公式推导、状态机、图形变形，仓库内置参考技能
• PIL：PNG 序列加 ffmpeg，做简单卡片最快

排错前先自查 🔧

装完先跑两条命令确认环境没问题：

python ~/Developer/video-use/helpers/timeline_view.py --help ffprobe -version | head -1

高频问题四条：

• 转录失败：先看 .env 里密钥是否为空或粘错，空的等于没配。
• ffmpeg 找不到：用系统包管理器重装，静态构建版也行，4.x 以上都够用。
• 代理不认技能：确认软链指向整个目录，且确实在 skills 目录里。
• 依赖报错：重跑一次uv sync或pip install -e .。

动手剪出第一条成片

• 按上面装好依赖，跑通两条自查命令。
• 把原始素材丢进新文件夹，cd 进去启动你的代理。
• 说一句"edit these into a launch video"，等 edit/final.mp4 出现。

想更新时进仓库目录跑一句git pull --ff-only，依赖变了再补一次uv sync。

【免费下载链接】video-useEdit videos with coding agents项目地址: https://gitcode.com/GitHub_Trending/vid/video-use