Mortiflix OSS Skill 技能

技能简介

Mortiflix OSS 是一款基于 Claude Code 的本地动态影像（motion design）制作工具，把传统动画工作室的 brief → script → style frames → animatic → final 搬到你的终端和浏览器里。它不是"输入 prompt 一次性生成"的抽卡式 AI 视频工具，而是一个分阶段、可审阅、可回滚的制片流程：每一阶段都会停下来等你点头，下一阶段只在你批准后才开始。整条流水线由 Claude Code（或你自己的 Anthropic API Key）驱动，渲染走 Remotion（React 视频）+ ffmpeg QC 双重把关。Linux 已可用，macOS 基本可用但未充分验证，Windows 版本预计 2026 年 10 月 20 日前发布。

核心能力

• 分阶段闸门（gates）：脚本、风格帧、动画小样、最终成片每个阶段结束 Claude 会停下、提交产物并交接给下一次会话；等待你数小时甚至数天都不消耗 token，长会话失忆问题被天然规避。
• 精确注释（pin notes）：在画面的具体位置、视频的具体帧挂注释，下一次产出必须逐条回应并显示改动位置；不是"AI 改完你只能整体接受"，而是逐项 review。
• 规则进代码而非 prompt：审批只能由你完成；提交时如未报告全部错误检查或未回应上一轮注释，会被系统拒绝；你审阅后的内容会被复制出会话上下文，事后无法被改写，杜绝"AI 偷改原稿"。
• 越用越懂你的品味：当你指出真正的问题时，会话会提议一条新的检查规则（如"文字不能贴到画面边沿"）；你批一次，未来所有视频都会执行；这些规则累积在 TASTE.md，跨项目生效。
• 管线即文件夹：管线由 pipeline.json（步骤、审查方式、错误检查）+ PIPELINE.md（工艺描述）+ skills 三件套构成，任何人都能写一条自己的管线并复用到其它项目。
• 三种配音方案：ElevenLabs 云端 TTS（含 Voice Library 与声音克隆）、Qwen3-TTS 本地显卡推理（Apache-2.0）、自己朗读（录音棚）；每条生成音都会用 STT 反查丢字，词时驱动画面节奏。

安装配置

1. 环境依赖：Node.js 20 及以上、ffmpeg；当前 Linux 验证最稳，macOS 大体可用但未充分验证，Windows 版本尚未发布。
2. 克隆与安装：git clone https://github.com/GTKottman/mortiflix-oss.git && cd mortiflix-oss && npm install && npm link（或直接 node bin/mortiflix）；依赖全部装在项目内，不污染系统级。
3. 初始化与走查：mortiflix init 创建工作区（默认 ~/Mortiflix）并选定后端（claude-code / anthropic-api / demo 三选一）；mortiflix setup 依次询问 Claude、旁白、配乐、素材、3D 等选项，需要时才会装，绝不偷偷装系统级依赖。
4. 凭据管理：mortiflix keys 把 Anthropic / ElevenLabs 等键写入 secrets.json 与 session.env（权限 600），每个键写入前会做一次免费 API 自检；脚本场景可用 echo "$KEY" | mortiflix keys set elevenlabs。
5. 浏览器入口：执行 mortiflix serve 在 http://127.0.0.1:4646 打开工作室；如需跨设备访问，加 --host 0.0.0.0 取访问令牌（公网请套 HTTPS）。

使用步骤

1. 新建项目：终端运行 mortiflix new explainer（或 social-short / logo-sting）回答 brief 问题；或在浏览器工作室里点 New。
2. 让会话跑起来：mortiflix run，会话跑到第一个等待你的闸门就停下，并写入交接日记。
3. 审查与回应：mortiflix review 打开 review room 阅读笔记、回答 Claude 的提问、在画面具体位置/视频具体帧上 pin note，确认或请返工。
4. 循环审批：再次 mortiflix run，会话从日记接续，跑向下一个闸门，直到 delivered。
5. 查看开销：项目卡片显示本次 Claude 工作大致等价于多少 API 花费（用 Claude 订阅时不实付，用 API key 时是实际花销）。
6. 后台自动化：mortiflix serve 后 sessions 可自动启动；想看日志、看等待项、回滚改动，全在浏览器里完成。

适用场景

• 30 秒到 2 分钟解说视频（narrated explainer），配合原创配乐，适合做产品介绍、技术科普、内部培训短片。
• 15–45 秒竖屏短视频（social-short），先出 hook 帧再补画面，关了声音也能看懂，适合抖音 / Reels / TikTok / 小红书。
• 3–8 秒品牌 logo 动画（logo-sting），最轻量、最快出真片，适合发布会、播客片头、产品官网首屏。
• AI 协作 + 人审稿（乙方场景）：广告代理、自媒体团队、内部讲师等需要"AI 出稿 + 人 review"分工的环境，把闸门当作品 review 用。
• 个人语音纪录与克隆：用自己朗读、Qwen3-TTS 本地克隆或 ElevenLabs Voice Library，适合做不带本人出镜的频道。

适用人群

• 独立创作者：想做产品介绍/课程短片却请不起完整动画团队的个人。
• 开发者/技术博主：习惯用终端、愿意读 ffmpeg 日志、能把控节奏的技术内容创作者。
• 小团队的视频负责人：需要快速出 explainer 又要求每版都能回滚、可对比改动的运营/市场人。
• AI Coding Agent 重度用户：已经在用 Claude Code 写代码、想把它一起做视频的人。
• 教学场景的讲师：把课堂流程可视化时希望每一步都能"卡住"自己插入板书的人。

工作原理

Mortiflix 把一次"视频制作"拆成多段 Claude Code 会话，每段负责一个 stage（如 brief / script / style frames / animatic / build / final）。每个 stage 跑完后会把本阶段产物、日记（journal）与必要上下文复制出会话上下文（用户已审阅的内容对 Claude 不可见且不可改），然后停止。当你在 review room 里回复笔记、批准或请返工，新会话从日记接续，避免长会话失忆与上下文污染。管线（pipeline）由 pipeline.json + PIPELINE.md + skills 构成，错误检查（格式、黑白帧、frame sheet、音量）由 qc.mjs 自动跑，提交时如未报告则被拒绝，保证产物符合阶段标准。Remotion 渲染、ffmpeg 验证、Strudel 配乐、Qwen3-TTS 旁白都被视为可替换的工具节点，patches 是文件夹、可 fork，意味着任何人都能扩展自己的管线。

官方链接

• GitHub 仓库：https://github.com/GTKottman/mortiflix-oss
• 实现状态表：https://github.com/GTKottman/mortiflix-oss/blob/main/docs/status/implementation.md
• 渲染底座 Remotion：https://www.remotion.dev
• 配乐 DSL Strudel：https://strudel.cc
• 文档目录：https://github.com/GTKottman/mortiflix-oss/tree/main/docs