sarpstar/cinecode

项目介绍

cinecode 是给 AI 编程代理用的技能，不是独立的渲染器。装进 Claude Code 或 Cursor 后，它引导代理完成构思、写作和成片：所有画面都由图里的代码生成——快速模式是自包含的单页 Canvas 2D，影片模式是 three.js/WebGL 场景——再用无头 Chrome 逐帧截图、用 ffmpeg 合成视频与音频，最终在影片文件夹里得到 <标题>.mp4。

适用场景包括短片、YouTube 长视频/解说、广告与产品片、竖屏社交短片，以及按歌曲节拍网格剪辑的音乐视频。代理会提问、建议模式和目的（电影感还是广告/产品），在正式开建前先给出计划与两张样帧，再按你的意见修改。

kit 还附带代理会查阅的技艺指南：镜头运动词表、排版规则、写作与开场钩子检查、声音设计，以及 58 个风格配方。make.py、qc.py 等检查工具会核对开头几帧的运动、响度和逐场可读性。

安装与第一支片

前提：一个能在本机运行工具的代理（Claude Code 桌面版、VS Code 扩展或终端；Cursor 也可），以及 Node.js 22+、Python 3.9+、ffmpeg 和支持 GPU 的 Chrome/Chromium/Edge。缺什么代理会先征求同意再装。

在 Claude Code 里最省事的方式是让代理从仓库安装该技能。手动安装：

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

用 Cursor 则克隆到 ~/.cursor/skills/cinecode，只装一份。

然后打开一个空文件夹作为影片工作区，在对话里写类似：

用 cinecode 做一部电影：<讲什么，一两句话>。

可选补充时长、画幅/投放平台、旁白与音乐、风格参考；留空代理会问。回答模式和目的、几轮简短问题，在每个检查点确认或调整，最终成片以 <标题>.mp4 放在影片文件夹顶层。快速模式适合单次会话内完成约 3 分钟以内的作品；影片模式通过分阶段确认处理更长的片子。

使用约束

• Claude Code 体验最完整：阻止未批准步骤的守卫钩子只在 Claude Code 生效；Cursor 能用同样的 make.py/qc.py 检查，但没有守卫钩子。
• 钩子需要较新的 Claude Code（exec 形式钩子与 onFailure，2.1.295 及以上）；旧版本守卫可能不生效，影片仍能运行。
• 渲染依赖无头 Chrome；拿不到 GPU 会退回 CPU，测试够用，整片很慢。
• 快速模式需几百 MB 磁盘；影片模式渲染期间每部片需数 GB。
• 旁白需要一次性填入 Gemini API key，或使用可选的土耳其语 TTS 模型。参考素材、音乐、首次字体/风格下载等搜索类功能需要联网；渲染、混音和检查可离线。
• README 称测试套件在 Windows 上运行，但尚未在 Windows 上端到端跑完一部片。
• 画面由代码渲染，近景人脸最好走风格化或剪影；外部图像/视频生成器只有你自己接入时才会作为最后手段使用。
• 许可：kit 本身 MIT；字体、音乐、素材各有许可并记入 LICENSES.csv，每支成片旁会生成署名文件。kit 层面允许商用，但自有 logo、品牌字体、实拍和歌曲由你负责——这不构成法律建议。

HotRepo 点评

2026-11-04，该项目以 148 stars、29 forks 进入 HotRepo 新项目榜，在记录到的大约一小时增长窗口内净增 36 stars 和 7 forks。这只是单次快照，只能说明当天的关注度，不能据此判断趋势。真正值得注意的设计取向是把电影制作当作编码任务：代理编写随时间变化的画面函数并检查帧，技能提供的是制作约束而非模型。成片是否可用取决于代理对参考指南的遵循程度，项目在 Claude Code 侧用守卫钩子和质量检查来兜底。

项目源码与说明