项目2026-11-08 · 智涌AI

cinecode 是什么:Claude Code 用代码拍片的 Skill

cinecode 项目头图:快速模式从一句想法、文字计划、两张静帧、半尺寸草稿到成片 MP4 的流程;标注 58 套风格配方、−14 LUFS 母带、30–60 秒短片约 100–250 步

一句话说想拍什么,Claude Code 写剧本、用代码画出每一帧、配好声音,最后交给你一个 MP4,全程不调用任何视频生成模型。土耳其开发者 Sarp Yıldız 11 月 3 日开源的 cinecode 就是这样一个 Skill:短片、广告、音乐视频、竖屏科普,到十分钟以上的纪录片都覆盖。它和站内写过的 lemo-opuscar 同属「代码拍片」路线,风格库就直接用了后者的 51 套配方,多出来的是一整套导演流程和关卡。本文按 英文 README 和 SKILL.md 整理它能做什么、怎么装、两种模式怎么选。

它是什么

项目信息
仓库github.com/sarpstar/cinecode
作者Sarp Yıldız(与 Claude 在 Claude Code 和 Cursor 里合作完成)
许可证MIT;风格库 styles/ 中 51 套来自 lemo-opuscar(MIT),另有 7 套自带,共 58 套
热度GitHub 约 1,200 星、222 fork(2026-11-08 查询);2026-11-03 建库
运行环境Claude Code(桌面端 Code 标签、VS Code 扩展、终端)或 Cursor;Node.js 22+、Python 3.9+、ffmpeg、Chrome / Chromium / Edge
最近提交67f9807,2026-11-03 23:21(北京时间)
文档语言土耳其语、英语、简体中文、日语

不调视频模型,靠代码出画面

cinecode 让 Agent 写一个程序把视频画出来,模型本身不生成任何画面。快速模式里整支片子就是一个自包含的 film.html:每个场景是时间的函数,画面用 Canvas 2D 或 three.js / WebGL,声音用 Web Audio 离线渲染,场景氛围底、音效、混响、编曲表都写在同一个文件里。capture.mjs 在无头 Chrome 里逐帧截图,mix.py 混音,master_audio.py 把响度压到 −14 LUFS。

代码画不出来的真实事物,长片会去开放档案里找:维基共享资源、互联网档案馆、NASA、博物馆,再加上 Pixabay 的图库(需要你自己的免费 key)。每一份素材的许可都记进 LICENSES.csv,成片旁边留一个 -credits.txt,贴到视频简介里就行。你自己给的参考片只用来定基调,README 写明不会进画面。

画面的成本在代码里,几乎不花模型钱;真正的开销是 Agent 一步步写、渲染、检查时消耗的对话轮数。

快速模式和电影模式怎么选

快速模式电影模式
适合1 分钟以内的品牌片、社交短视频、科普、3 分钟以内的作品;短片初稿多场景长片、带研究或档案素材的纪录片、旁白作品、参赛短片
确认次数约 3 次逐阶段约 6–8 次,一路直通约 3 次
画面一个 film.html,Canvas 2D 或 three.jsthree.js 场景,8 种观感预设,逐镜头渲染
声音同一文件里的 Web Audio 设计分层声音:环境底、拟音、重点时刻、旁白、配乐
Agent 分工主会话包办,后台做研究,另有独立观看者审每一版草稿声音、旁白、研究、审片、长片各章节交给并行的帮手

快速模式的流程大致是:问几个问题(媒介、时长和画幅、风格、声音、参考),给出文字计划(逐秒节拍表、带镜头描述的导演卡),先出两个场景的静帧让你看,再出半尺寸草稿,最多两轮修改,最后全尺寸渲染。快速模式的片子以后也能转进电影模式,节拍表直接变成路线图。

电影模式面向十分钟以上的纪录片和视频随笔:脚本里涉及真实人物或事件的每一条说法都要带出处;第一分钟埋一个悬念;旁白不会直接用 TTS 引擎原声,而是做过声音处理;按章节配乐。8 种观感预设包括写实电影感、日式赛璐璐、粉彩绘本、黏土、剪纸拼贴、复古合成波、商业亮面、手绘墨线。

安装和第一支片子

# 在 Claude Code 里直接说:
#   Install the cinecode skill from https://github.com/sarpstar/cinecode
# 或手动克隆:
git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode

# Cursor 用户放这里:
git clone https://github.com/sarpstar/cinecode.git ~/.cursor/skills/cinecode

# 新建空目录开始拍
mkdir my-film && cd my-film && claude
# 然后输入:I want to make a short film

README 提醒只装一份,别让 Agent 看到两个副本。缺的依赖 Agent 会先检查机器、征得你同意后再装;capture.mjs --probe 会看 Chrome 能不能用上 GPU,没有 GPU 就退回 CPU 渲染,测试够用,整片会慢。快速模式把帧直接写进 MP4,几百 MB 磁盘就够;电影模式渲染时每支片要几 GB。

旁白是可选的:用你自己的 Gemini key(有免费额度)、ElevenLabs,或系统语音。key 只需要输入一次,存在 ~/.cinecode/keys.env,以后每支片共用。保存过的片子格式、口味记录也在 ~/.cinecode/,Skill 自己的目录不会被写入。

几个要先知道的限制

如果你只想要一个现成风格库、自己掌控流程,lemo-opuscar 更轻;想要一个替你走完「问需求 → 计划 → 静帧 → 草稿 → 成片」并在每一关停下来等你点头的导演,cinecode 更合适。做 HTML 视频的另一条路线可以看 HyperFrames。

最后

先用快速模式拍一支 15 秒的竖屏短片:在空目录里说出一句想法,按推荐选项(标 ★ 的那个)一路确认,看看两张静帧和第一版草稿是否接近你想要的样子,再决定要不要上电影模式。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。