FavioVazquez/showtime

它是什么

showtime 是一个工具，让你可以用自然语言向 AI 编码助手描述一段视频，助手会在你自己的机器上生成完整的视频——无需云端 AI、无需 API 密钥、无需上传。可以把它想象成一个你的代理可以导演的“视频工作室”。

它的功能

该项目提供了一个命令行工具和一组“技能”，可以插入到支持 Agent Skills 标准的编码代理中，如 Claude Code、Codex、Cursor、Devin、OpenCode 等。安装后，你只需简单提问，例如：

“为这个仓库制作一个 20 秒的发布视频，带配音和欢快的音乐。”

你的代理将：

• 说明它所做的任何假设（时长、格式、风格）
• 向你展示预览（静态帧或快速草稿）
• 在你的硬件上渲染最终视频——包括动态图形、配音、音乐、音效设计、字幕和素材剪辑
• 导出为常见格式和平台

每个请求都会获得自己的文件夹，包含 final.mp4、海报图片、可分享的文本文件、导出文件和工作文件。不会覆盖任何内容。

主要特性

• 本地优先：所有处理都在你的计算机上运行。无云端 AI 服务、无 API 密钥、无上传。
• X-ray：拍摄真实物体（例如打字机），showtime 会叠加其内部机制（从库中绘制），并与音频完美同步，甚至可以从声音生成乐谱。
• 动态图表：创建动画、交互式图表，随时间解释系统——用户可以悬停、拖动和交互。
• 回顾与重制：自动将编码代理会话或失败的 Playwright 测试转换为简短的解说视频。
• check 命令：读取手机屏幕上绘制的文本，捕捉过小或重叠文本等问题。

工作原理

showtime 以三种方式提供：

1. 代理技能 – 一组指令和实用程序，任何兼容 Agent Skills 的代理都可以加载。
2. 命令行工具 – showtime 二进制文件，负责编排渲染、QA 检查等。
3. MCP 服务器 – 可选，适用于支持它的代理，以暴露类型化工具。

安装会下载一个小型运行时（首次安装约 0.5–0.75 GB，~/.showtime 中约 1.4–1.8 GB）。它适用于 Intel Mac、Apple Silicon、Linux（x64 和 ARM64）以及 Windows（x64 和 ARM）。

兼容性

• 已测试：Claude Code、OpenAI Codex、Cursor、Devin、OpenCode。
• 应可用（尚未完全验证）：GitHub Copilot、Gemini CLI、Antigravity、Cline、Kilo Code、Kiro、Zed、Goose、Amp、Factory Droid、Qwen Code。

安装通过插件、技能添加命令或手动设置脚本完成，具体取决于代理。README 中包含每个代理的确切命令。

要求

• Python 包管理器 uv
• Node.js 24 或 22 LTS（20+ 也可用）
• 你使用的代理必须支持 Agent Skills 并能运行 shell 命令。

当前状态

• 版本 0.4.6（早期，MIT 许可）。
• 项目包含详尽的 README，包括快速入门指南、故障排除、FAQ 和演示卷（55 秒，在 64 核 CPU 上 2 分钟渲染完成）。

值得注意的额外功能

• 十个子代理的“团队”可以加速某些主机（取决于代理的能力）。
• 每个完成的视频在交付前都会通过内置的 QA 检查。
• 行为记分牌显示，使用 showtime 的代理比不使用它的代理更可靠地遵循指令（测试中正确操作 35/42 vs 25/42）。

这是一个为任何想使用现有编码代理从简单文本提示生成精美、带解说的视频的人设计的工具，完全隐私且无按次使用成本。