cinecode：用 AI 编程代理写剧本、造画面、配音效，把一句话变成 MP4 电影

cinecode 是一个在本地运行的电影生成工具包：你给出一个想法，AI 编程代理会写出剧本、用代码逐帧搭建画面、设计声音，最终交付一个 MP4 文件。它的定位覆盖短片、长 YouTube 视频、广告、解说和音乐视频，而不是单纯的视频模板拼接。项目使用 Python，许可证为 MIT，目前在 GitHub 上获得约 2,544 个 Star 和 441 次 Fork（截至资料更新时间）。

它是什么，解决什么问题

cinecode 的核心思路是“电影由代码构成”。画面不是从素材库直接套用，而是在无头 Chrome 中按时间函数逐帧生成；声音通过 Web Audio 离线渲染或 ffmpeg 流程处理。用户需要带来的是想法、审美和品牌素材，剩下的剧本、分镜、渲染、混音和质检交给 AI 编程代理完成。

它主要解决的是从“想法”到“成片”之间的繁琐流程：写脚本、拆镜头、做视觉、找音乐、控制音量、导出视频，这一整套环节被拆成可由代理执行和用户确认的步骤。

两种工作模式

代理会先询问目标，并据此推荐模式。

快速模式适合一分钟以内的内容，以及约三分钟以内的品牌或客户项目。整个影片放在一个独立的 film.html 中，场景按时间函数生成，使用 Canvas 2D 或 three.js / WebGL。流程是：少量提问、可选调研、以文本形式给出计划、两场戏以画面形式确认、低分辨率草稿、最多两轮修改、最终渲染。它适合社交媒体短片、讲解视频和广告。

电影模式面向多场景、需要调研或档案素材的长片，例如纪录片、配音作品和电影节短片。它先确认路线图和完整剧本，再经过风格帧、动态分镜和渲染等阶段；可以逐阶段由用户批准，也可以在剧本完成后直接生成草稿。画面使用八种预设风格的 three.js 场景，并逐镜头渲染。

两种模式不是互斥的：可以从快速模式开始，再把项目转入电影模式，已有的节拍会变成路线图。

两个创作目标

除了模式，cinecode 还会区分“电影感影片”和“广告与产品影片”。前者追求看起来像实拍、而不是渲染出来的故事、情绪或艺术表达；后者强调单一主体、品牌归属和明确的后续行动，并提供 9:16、1:1、16:9 三种带安全区的版本。

在电影感目标下，工具会涉及浅景深、镜头特征、颗粒、操作员迟滞、胶片色调和门缝晃动等视觉处理；在广告目标下，则涉及屏幕上的名称标签、软件界面英雄镜头、品牌色和字体，以及行动号召结尾卡。两种目标共享运动、镜头语言、排版、声音同步和质检等基础能力。

主要功能

• 剧本写作系统：包含先扩写再筛选、先写结尾、展示而非讲述、字数预算、常见陈词滥调清单、朗读和压缩三成的流程，以及首次观众视角的检查。
• 镜头和转场词典：为推拉、环绕、变焦推轨、FPV、肩扛、速度渐变、移焦、匹配剪辑、甩镜、J-cut 等命名，并给出观众感受、默认时长、速度和缓动。每个镜头可以写成一行，例如指定缓慢推近某个人物。
• 快速模式起始文件：提供确定性时间线、2.5D 深度层镜头、转场、图像与声音共用的标记表、带种子的随机性、文字辅助工具、小型 Web Audio 音效和渲染前检查的剪辑表。
• 八种视觉预设：电影写实、动漫/赛璐璐、粉彩故事书、黏土动画、剪纸/拼贴、复古 synthwave/VHS、明亮广告、手工墨水；也可以从参考图中提取自定义风格。
• 声音设计：配音不会以原始引擎音直接输出；系统会为每个影片选择声音的空间来源和停留空间，并统一每句的说话电平，还包含分层环境声、音效、高潮点和 −14 LUFS 母带处理。
• 参考影片的“类似但不同”：把喜欢的视频放入 refs/ 并说明想改什么，系统会测量剪辑点、镜头时长、节奏、色板和光照、BPM 以及剪辑与节拍的关系，再在此基础上重做影片，但不取用原片的画面或音乐。
• 音乐视频：带入歌曲后，系统会测量整首曲子的速度，按小节起点切分，让剪辑和重音落在小节与节拍上，并为每句歌词匹配一个画面；音乐会在配音下自动降低音量。
• 排版：提供来自独立开放字库和 Fontsource 的授权清晰、经过土耳其语验证的字体与搭配；每部影片会以片中外观展示三组搭配卡片，并支持手机尺寸下的可读性、对比度和重音检查。
• 工具链：包括帧捕获（可直接输出 MP4 和影片声音 WAV）、动态分镜、混音、母带处理、质检（钩子测量、去除镜头运动后的主体动作、逐场音量与响度），以及记录许可证的开放授权素材搜索。

使用方式与运行环境

cinecode 在本机运行，需要有一个能够在电脑上执行工具的 AI 编程代理。资料明确提到 Claude Code（桌面应用、VS Code 扩展或终端）和 Cursor，用户也报告过在 Codex、Antigravity 等其他代理中运行。普通 claude.ai 聊天无法在本地执行工具，因此不能替代 Claude Code 来完成 ffmpeg、Chrome 和脚本调用。

环境依赖包括 Node.js 22+、Python 3.9+、ffmpeg 和 Google Chrome（或 Chromium / Edge）。缺少的依赖可以由代理在用户批准后安装。Windows 也可使用：工具包在 Claude Code 自带的 PowerShell 中运行，不需要 bash；Git 只用于安装和更新工具包，不参与影片生产。

项目不要求付费服务。配音是可选项，可以使用自己的 Gemini 密钥（有免费额度）、ElevenLabs，或免费的土耳其语声音。

适合谁

它适合希望用 AI 代理完成从创意到成片流程的创作者、品牌和广告制作人员、需要做解说或社交媒体短视频的团队，以及尝试编程生成影像的艺术家。对于需要调研和多场景结构的长片，电影模式提供了分阶段确认的方式。

需要注意

项目资料没有给出统一的安装命令或硬件性能数据，实际安装与运行应以仓库说明和代理的引导为准。影片越长，需要的时间和模型使用量越多；快速模式主要面向约三分钟以内的任务，电影模式则通过更多确认步骤来处理长片。参考影片功能只提取形式和节奏，不复制原片画面或音乐。

项目主页：https://github.com/sarpstar/cinecode

项目地址：cinecode