Mortiflix 是一个开源的本地 AI 动效设计工作室：Claude 在你的电脑上一步步"做视频"，而你负责在每一个阶段审核、提意见、批准。它把"一句话生成视频"的抽奖模式，换成了真实动效公司的制作流程——简报、脚本、风格帧、转场板、动画样片、配乐、成片，每一关都停下等你点头。你只需自带 Claude Code 登录或 Anthropic API key，整个工作室就跑在你自己的机器上。

为什么"一句话生成视频"总是靠运气？

市面上大多数 AI 视频工具的工作方式是：一个 prompt → 一段玄学。不满意就抽下一次，直到抽中为止。

Mortiflix 的思路完全不同。它内置了真实动效工作室的流程骨架：

简报 ──▶ 脚本 ──▶ 风格帧 ──▶ 转场板 ──▶ 动画样片 ──▶ 配乐 ──▶ 成片 ▲ ▲ ▲ ▲ ▲ ▲ └── 你 ───┴──── 你 ───┴───── 你 ───┴──── 你 ──┴─── 你 ────┘ 批准、在画面精确位置钉注释、回答提问（会话在每个关卡停下）

三个核心设计让"AI 做视频"变得可控：

• 关卡机制（Gates）：每个 Claude 会话干到"有东西给你审"就提交并停下，等你回复。等你几小时或几天都不花一分钱。
• 规则写在代码里，而不是写在提示词里：只有你能批准自己审核过的步骤；提交若没有回答你留下的每一条注释，会被直接拒收。
• 它会学习你的口味：你指出一个真实错误，会话就会提议一条新检查项（比如"文字永远不能碰到画面边缘"），批准一次，以后所有视频都会执行。你的审美偏好沉淀在TASTE.md里，跨项目生效。

三步搭建：在本地电脑跑起你的AI动效工作室

环境要求：Node 20+、ffmpeg，以及二选一：已登录的 Claude Code（走你的订阅）或 Anthropic API key（按 token 计费）。

1️⃣ 克隆并安装

git clone https://gitcode.com/gh_mirrors/mo/mortiflix-oss && cd mortiflix-oss npm install npm link # 把 mortiflix 放上 PATH

2️⃣ 初始化工作室

mortiflix init # 创建工作室文件夹 ~/Mortiflix，自动挑选后端 mortiflix setup # 引导式配置：Claude、配音、音乐、素材、3D（装什么都会先问你）

3️⃣ 免费试跑一遍（推荐新手）

mortiflix demo # 用占位素材完整走一遍所有关卡，不花一分钱

之后有三种用法，任选其一：

浏览器工作室里你可以点击某一帧钉一条注释、暂停视频给某个瞬间留意见、评论脚本段落，然后批准。详细安装说明见 docs/SETUP.md，各组件装在哪里、怎么删除，都有清楚交代。

内置4条流水线：从3秒Logo动画到2分钟解说视频

流水线就是文件夹：一个pipeline.json（步骤、审核方式、错误检查项）+ 一个PIPELINE.md（工艺说明）+ 一组技能。内置四条：

它们用 Remotion（React 视频）构建，每次渲染都用 ffmpeg 做质检（qc.mjs）：格式、黑帧/冻帧、响度、逐秒抽帧检查表，一项不落。转场也不是随机硬切：每个项目都有一块转场板，为每次切镜写清楚"由画面中哪个物体承载、为什么在这里切、落在哪个词上"，并渲染出真实中间帧供你审核。完整流水线定义可以看 pipelines/explainer/pipeline.json。

配音与配乐：本地、免费、原创

配音四种选择，在 Settings › Narration 里切换：

• ElevenLabs：用你自己的 key，选你自己的声音或官方声音库；
• 本机 GPU：Qwen3-TTS（开源 Apache-2.0）通过 ComfyUI 跑在你自己的显卡上，免费且私密；
• 你自己的声音：网页录音棚里一句一句录，保留最佳 take；
• 无配音：只用屏幕文字+音乐。

生成的人声会经过语音转文字校验，漏词自动重录；逐词时间轴还直接驱动动画节奏。详见 docs/VOICE.md。

配乐由内置音乐引擎按阶段写出：曲风研究→蓝图→Strudel 音符→机器检查（和声锁谱、强度曲线、每个重音落在画面帧上）→捕获 MIDI→为每个声部选乐器试听→响度达标混音。推荐玩法是：把交付的MIDI 包（每个声部独立通道+速度+打击点标记）拿到你自己的 DAW 里重新编曲，再导回工程。原理见 docs/MUSIC.md。

3D与粒子特效：Nova FX 引擎

Mortiflix 的 3D 能力来自 Blender + 一组工作室工具包（MoGraph、摄像机、缓动、数学、电路等），装在独立的 Blender 配置文件里，绝不碰你自己的设置。其中最值得看的是Nova FX——Mortiflix 自研的粒子引擎，支持粒子、火焰、火花、烟花，上方九宫格就是它的内置预设（源码在 vendor/nova-fx）。

想亲自飞一遍镜头？mortiflix blender会打开这个 Blender，Camera Flight 工具包让你像玩游戏一样运镜并录制 takes。

数据安全：项目与密钥都在你自己手里

• 所有东西都装在~/Mortiflix/下，删除tools/目录即可全部清除，绝不系统级安装；
• API key 只写入工作室文件夹的secrets.json（600 权限），输入时隐藏，保存前先用免费调用验证；
• 会话能做什么、不能碰什么，有严格边界——发布命令永远不会暴露给 AI 会话，只有"你已批准的成片"才能发出去；
• 想发布的话，可通过 Upload-Post 免费计划（每月 10 次上传）一键发到 TikTok / Reels / LinkedIn 等平台。

安全边界细节见 docs/SECURITY.md；想搞懂架构（runner、桥接、关卡、后端三件套claude-code/anthropic-api/demo）读 docs/ARCHITECTURE.md，想算一笔 token 与磁盘开销的账看 docs/COMPUTE.md。

适合谁？还能做什么？

适合：独立创作者、一人工作室、需要可控 AI 视频工作流的团队——尤其是受够了"抽卡式"生成、希望每个画面都过自己眼的你。

可扩展：流水线就是文件夹，任何人都能写。音乐视频、产品片、数据故事、动态字体……docs/PIPELINES.md 是官方最欢迎贡献的方向。测试只需npm test，约一秒跑完且绝不调用网络。

目前主要测试于 Linux，Windows 版已在路上（见 docs/WINDOWS.md），macOS 大部分可用但未充分测试。项目采用 AGPL-3.0 协议开源。