vox-director

输入主题，自动产出 Vox 风格拼贴解说视频

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署视频生成 🍴 复刻 376 🐛 待处理 7 👀 关注 16

GitHub ↗

GitHub 星标 ★ 2730

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，MIT 许可证，可免费使用和部署。

项目预览

vox-director 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类视频生成

开发团队Alisa0808

GitHubhttps://github.com/Alisa0808/vox-director

定价模式🏷️完全免费

价格说明开源项目，MIT 许可证，可免费使用和部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,ai-video,claude-code,claude-skill,collage-video,dsh-plugin,explainer-video,ffmpeg,generative-ai,llm,motion-graphics,python,text-to-video,tts,video,video-generation,vox

GitHub 星标★ 2730

上线时间2026-07-10 00:00:00

代码更新2026-10-05

仓库体积52.4 MB

本站数据更新2026-11-09

维护状态维护中

收录时间2026-08-09

浏览次数2

项目介绍

vox-director 是一个自动化生成 Vox 风格纸板拼贴解说视频的开源项目。它接受一个主题，通过 Atlas Cloud 和 ffmpeg 完成从脚本撰写、视觉素材生成到最终视频合成的全流程，无需人工干预。项目本质上是 Claude Code 的一个 Agent Skill，利用大语言模型规划视频结构、生成文案，并调用图像生成工具制作拼贴元素，最后用 ffmpeg 进行剪辑和动效处理。它解决了传统解说视频制作周期长、成本高、需要专业团队的问题，让个人或小团队也能快速产出具有独特纸板美学风格的视频内容。核心能力包括自动化流程编排、多模态内容生成和视频合成，适合用于自媒体内容创作、营销广告和教学演示等场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2730

技术标签

ai ai-video claude-code claude-skill dsh-plugin

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

一个可读取工作流并执行脚本的编码 Agent（如 Claude Code、Codex 等）
Atlas Cloud API Key（用于脚本、图像、语音、音乐等生成）
本地已安装 ffmpeg（用于最终视频合成与动效处理）

安装与启动步骤

1克隆技能仓库

把仓库直接克隆到 Claude Code 的技能目录下，Claude Code 会自动发现并识别该 skill。
```
git clone https://github.com/Alisa0808/vox-director.git ~/.claude/skills/vox-director
```
2配置 Atlas Cloud 密钥

到 Atlas Cloud 控制台创建 API Key，然后设置为环境变量，供技能调用生成接口时使用。
```
export ATLASCLOUD_API_KEY="sk-xxxxxxxx"
```
3确认本地 ffmpeg

README 明确要求依赖本地 ffmpeg 完成剪辑与动效合成，先确认命令可用再开始生成。
```
ffmpeg -version
```
4让 Agent 生成视频

用自然语言向已安装技能的 Agent 描述主题、语言、画幅和时长，Agent 会先给出节奏表供确认。
```
Make me a Vox-style collage video introducing Mexican street food — English, 16:9, 15 seconds.
```
5选取风格与出片

Agent 会先跑一轮风格方案供你挑选，确认后依次生成关键帧、动效、配音和音乐并合成视频。
6查看输出文件

成片会写入项目目录下的 out/<project>/final.mp4，直接播放检查即可。

关键配置

配置项	必填	说明	示例
`ATLASCLOUD_API_KEY`	是	调用 Atlas Cloud 生成能力的密钥，技能全流程依赖它	`sk-xxxxxxxx`

如何确认成功

Agent 流程跑完后，在 out/<project>/final.mp4 能找到可正常播放的成片，即表示部署与生成成功。

常见问题

Q：没有 Claude Code 可以用吗？

A：可以。这是 agent skill，任何能读取工作流并执行脚本的编码 Agent 都能用，其他 Agent 按 AGENTS.md → SKILL.md 的指引接入。

Q：不想克隆仓库怎么安装？

A：下载打包好的 vox-director.skill 文件，通过 Claude 的 skills 管理界面导入安装即可。

Q：API Key 到哪里申请？

A：在 atlascloud.ai/console/api-keys 控制台创建，然后 export 为 ATLASCLOUD_API_KEY 环境变量。

Q：会直接开始出片吗？

A：不会。Agent 先给出 beat map 让你确认，再跑风格方案供你挑选，之后才生成素材并合成视频。

Q：生成结果放在哪里？

A：默认输出在项目的 out/<project>/ 目录下，成片文件名为 final.mp4。

注意事项

安装路径 ~/.claude/skills/vox-director 是 README 给出的 Claude Code 技能目录，其他 Agent 需按对应文档放置。
API Key 请替换 sk-xxxxxxxx 为真实密钥，避免泄露到公开仓库。
项目依赖本地 ffmpeg，未安装会导致最终合成步骤失败。
流程包含人工确认环节（节奏表、风格方案），并非完全无人值守的一次性生成。