Py学习  »  Git

GitHub 一夜爆火 2.2K Star:这个土耳其开发者,用代码拍了一部真正的电影!

开源星探 • 3 小时前 • 7 次点击  

上个月,一个名叫 cinecode 的开源项目出现在 GitHub 上。


来自土耳其的开发者 sarpstar 做了一件反直觉的事:他不用 AI 模型"画"视频,而是用 AI 编程智能体写代码来渲染视频。

这不是什么新概念——但 cinecode 的野心要大得多:它想把"写代码拍电影"这件事,从极客玩具变成一套完整的生产流水线。

项目上线不到一周,Star 就冲到了 2.2K Start。

一个非英语、非大厂、非明星开发者的项目,能有这个势头,说明它真的踩中了什么痛点。

让我们来看看 cinecode 到底是什么,它是怎么把"代码"变成"电影"的。


📦 5 Parts + Conclusion

👉 滑动

PART 01

cinecode 是什么

PART 02

核心亮点

PART 03

技术实现

PART 04

快速上手

PART ///

结语

01

PART


cinecode 是什么

一句话概括:cinecode 是一套运行在 Claude Code 或 Cursor 里的 AI 编程智能体技能包,你给它一个创意,它用代码渲染每一帧画面、设计声音、合成旁白,最后交给你一个 MP4 文件。

它的口号也很直接:"Films written in code"——用代码写成的电影。


开发者 sarpstar 是个土耳其的独立开发者,之前的公开项目不多。但从 cinecode 的 README 和 references 目录来看,他对电影语言、镜头运动、声音设计有相当深的理解——不是那种只会调 API 的"套壳工程师"。

项目本身是 MIT 协议,全部运行在你自己的电脑上,不需要任何付费云服务。

唯一可能需要花钱的地方是 TTS 旁白——但它内置了好几种免费方案(包括三种土耳其语开源语音模型,以及 Gemini 的免费额度),不配 API Key 也能跑通。


02

PART


核心亮点

亮点一:程序化渲染 = 100% 可控

这是 cinecode 和所有像素生成模型的根本区别。

用 Seedance 做视频,你给一句提示词,模型给你一段画面。想要调整?改提示词、重新生成、祈祷运气好点。

用 cinecode 做视频,AI 写出来的是真正的代码——three.js 场景、Canvas 2D 绘制函数、Web Audio 合成器。

每一帧画面都是确定性的:同样的代码、同样的种子,永远渲染出同样的结果。

这意味着什么?


你可以精确到毫秒地调整剪辑点,让画面变化严丝合缝地卡在音乐的重拍上


你可以像调整参数一样调整摄影机角度——推轨推进 3 秒、缓慢缓入缓出、朝向人物


你可以让 AI 把你喜欢的视频的剪辑节奏测量出来,然后在这个节奏框架下做一部完全不一样的新视频


你可以存下一部影片的格式模板,下一集就按同样的构图、字体、配色、运镜来做

这些在像素生成模型里想都别想的事情,在 cinecode 里就是改一行参数的事儿。

亮点二:内置完整的电影制作流程

很多人可能会说:不就是 Canvas 动画加 three.js 吗?我自己也能写。

但 cinecode 厉害的地方在于,它把一部影片的完整制作流程都自动化了,而不仅仅是渲染:

1

创意发散:你的想法会和一件从现实世界随机抽取的事物(博物馆藏品、太空照片、古老发明、历史遗迹)碰撞,避免你想到的都是"大家都想到的版本"

2

剧本写作体系:内置一套编剧方法论——先发散再收敛、转折要清晰、先定结尾、用画面说话而非直白讲述、字数预算、禁用陈词滥调、朗读一遍删减 30%、以首次观看者视角检查

3

运镜词汇表:推轨推进、环绕、滑动变焦、FPV、手持、变速、移焦、匹配剪辑、甩镜、J-cut……每种运镜都标注了给观众带来的感受、默认时长、速度和缓动曲线

4

声音设计:环境底噪、拟音、高光时刻、人声处理、音乐编排,每部影片的声音都经过设计,绝不直接用引擎的原始输出

5

质量检查:首帧即有运动?通过。响度合适?通过。屏幕文字手机上可读?通过。两个场景之间主体动作不重复?通过。开头钩子能否抓住人?独立审查者会盯着看

这不是一个"生成视频的小工具",这是一套AI 导演工作流。

亮点三:两种模式,按需选择

cinecode 提供两种工作模式:

快速模式——整部影片在一个 film.html 文件里完成。场景是时间的纯函数,渲染用 Canvas 2D 或 three.js/WebGL。适合 1 分钟以内的短片、社交短视频、产品广告。从创意到成品,只需要 1-2 轮确认。

电影模式——先确认路线图和完整剧本,然后逐阶段推进:风格帧 → 动态分镜 → 渲染。支持调研和档案素材、分层声音设计、多章节长视频。适合 10 分钟以上的纪录片、科普视频、电影节短片。

你甚至可以先在快速模式里做一个草稿,再升级到电影模式里打磨——节拍表会自动变成路线图。

亮点四:八种风格预设 + 自定义

不知道画面长什么样?cinecode 给你八种现成的风格配方:

1

电影感写实

2

动漫/赛璐璐

3

粉彩绘本

4

黏土动画

5

剪纸/拼贴

6

复古/合成波/VHS

7

高光泽商业风

8

手绘水墨

还可以扔几张参考图进 refs/ 目录,让 AI 测量颜色和光线,走出一套完全属于你的自定义风格。


03

PART


技术实现

从项目的技术栈和工作方式来看,cinecode 的实现相当扎实:

渲染层


快速模式
 一个自包含的 film.html 文件,场景用时间函数定义(确定性的),渲染引擎是 Canvas 2D 或 three.js/WebGL,声音用 Web Audio API 离线渲染。在浏览器里打开,画面和声音一起播放。


电影模式
 three.js 场景,逐镜头渲染,支持八种风格预设。

声音层

快速模式从第一版起就在同一个 HTML 文件里设计声音:每个场景一层环境底噪,音效按画面的提示表触发,共享一个混响,音乐来自编曲表。电影模式则会做分层底噪、拟音、高光时刻、人声和音乐的完整设计。

旁白绝不直接用 TTS 引擎的原始声音。每部影片都会选定声音呈现方式(贴近、磁带、电台、合唱、水下、机械……)、所处的空间(房间、大厅、石砌中殿、户外),每句台词都落在同一对白电平上。

AI 智能体架构

cinecode 不是一个独立的 Web 应用——它是一套技能包,运行在你本机的 Claude Code 或 Cursor 里。


快速模式由一个主对话负责构建、渲染和修改(速度快);调研在后台进行,辅助智能体只用于预测测试、重复检查、旁白录制和独立审看


电影模式的主对话构建它掌握上下文的部分;辅助智能体并行承担声音、旁白、调研、审看以及长片的各个章节


04

PART


快速上手

安装

在 Claude Code 里直接说:

请从 https://github.com/sarpstar/cinecode 安装 cinecode 技能

它会用 git 拉取到 ~/.claude/skills/cinecode(Windows 是 %USERPROFILE%\.claude\skills\cinecode)。然后新开一个对话就行。

手动安装也很简单:

git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode

以后更新就说一句"更新 cinecode"。

启动你的第一部影片

打开 Claude Code(桌面应用的 Code 标签页、VS Code 扩展或终端都行),在空项目目录里开一个对话,说:

我想做一个 10 秒的短片:一只在雪地里奔跑的狐狸,手绘水墨风格

然后跟着它的问题走就行。智能体会问几个问题(媒介、画面风格、声音、音乐参考),每个问题都有标着 ★ 的推荐答案。

确认方案后,它会先用静帧展示两个场景给你看,再渲染低分辨率草稿,你看完提意见,最后出成片。

///

LAST


结语

cinecode 最有意思的地方,不是它做了一个"用代码拍电影"的工具——这个思路并不新鲜。而是它把这件事产品化了。

它不像很多 demo 项目那样只给你一段炫技的动画,而是真的考虑了一个导演从创意到成片的每一步:怎么发散创意、怎么写剧本、怎么选风格、怎么选运镜、怎么设计声音、怎么检查质量。

每一步都有方法论、都有工具、都有检查清单。

在人人都在卷"一键生成"的 2026 年,反方向走一步——用代码获得精确控制,用流程获得质量保证——反而可能走得更远。

它已经能产出 5 分钟以上的纪录片、完整的广告片、有配音和音乐的科普视频。

如果你是一个独立创作者、一个想做视频的开发者、或者一个在寻找新表达方式的设计师——值得试一下。

项目地址:https://github.com/sarpstar/cinecode







如果本文对您有帮助,也请帮忙点个 赞👍 + 在看 哈!❤️

在看你就赞赞我!

Python社区是高质量的Python/Django开发社区
本文地址:http://www.python88.com/topic/203376