[!NOTE]
ArtCraft 是一个来自各行各业的艺术家社区。 数字艺术、生成艺术、音乐、游戏——只要你创造东西，你就是我们的一员。来 Discord 跟我们打个招呼。
EffectCraft 是什么
EffectCraft 面向动画标题、动态图形与合成工作：也就是动态设计师和视觉特效艺术家所需要的那类工具。你用图层（纯色、形状、文字、素材、其他合成）搭建出一个合成，用关键帧为它们的属性做动画，在上面叠加特效，然后渲染出结果。
界面自然且响应灵敏，配有专门的面板（项目、合成、时间轴、图层、素材、特效控制、工具、预览、特效与预设、音频、信息、段落、字符、对齐、进度、渲染队列）以及标准的动态图形快捷键，并在我们看重的一些地方更进一步：
- 内置 Lottie 导入与导出，动画无需插件即可直接进入网页与应用。
- 可读的项目文件。 项目以带版本的 JSON（
.ecproj）保存，因此在版本控制中能干净地 diff。
- 一切皆可脚本化。 每一个菜单项、时间轴拖拽与属性修改都经由同一个命令注册表，因此相同的操作可以从命令行、JSON 控制通道，以及面向智能体的 MCP 服务器触达。
- 没有 FFmpeg。 视频与音频的解码、编码全部是纯 Rust：FilmCraft 的编解码器，以及 EffectCraft 自家的 VP9、AV1、HEVC 与 Opus 编码器。
动画
面板、菜单与快捷键遵循标准的动态设计惯例：项目、合成、时间轴、特效控制、属性、特效与预设、字符、段落、对齐、信息、预览、音频与渲染队列，按你期望的方式停靠。在它们之间拖拽素材、合成与特效：拖到合成视图中时，它们落在指针下方；拖入时间轴时，落在图层之间与你所指的时间点。
- 各类图层： 纯色、形状、文字、素材、嵌套合成、空对象、调整图层、摄像机与灯光；父子关系、轨道遮罩、全部 38 种混合模式、运动模糊。
- 行为一致的关键帧： 线性、贝塞尔、定格、自动与连续贝塞尔、游走关键帧、Easy Ease（F9）、关键帧速度与插值对话框、在当前时间点复制粘贴，以及带有数值图与速度图、可拖拽控制柄的图表编辑器。
- 时间： 时间重映射、时间伸缩、时间反转、冻结帧、工作区、标记，在包括 29.97 掉帧在内的任意帧率下都做到逐帧精确。
- 形状与遮罩： 带修剪路径、重复器、圆角、偏移、zig zag、扭曲、抖动、合并路径与渐变描边的形状图层；用钢笔工具绘制的遮罩，支持模式、羽化、扩展与在视图中编辑顶点。
- 文字： 点文字与段落文字，支持本机安装任意字体的真实成型；字符与段落面板，以及带范围选择器的文字动画器。
- 表达式： 标准动态表达式模型的 JavaScript（
wiggle、loopOut、thisComp.layer("…")，对数组的矢量运算），带内联编辑器与拾取鞭。
- 熟悉的时间轴： 展开图层以查看变换、遮罩、特效等；拖动行以重新排序图层；用 Enter 或双击重命名；属性快捷键（A、P、S、R、T、M、F、E、L、U 及双击 AA、PP、SS、RR、TT、MM、FF、EE、LL、UU），Shift 添加属性，Alt+Shift+A/P/S/R/T 为当前时间打关键帧，Ctrl+` 展开所选图层。
- 木偶工具： 在由图层构建的网格上放置位置、高级、弯曲、僵硬与重叠图钉，实时录制图钉，旋转/缩放手柄，由（或承载）空对象驱动的图钉用于绑定，以及头发与布料的自然跟随。
特效
跨各个分类共 306 种内置特效，每种都有各自的参数名、顺序与默认值：模糊与锐化、通道、颜色校正（曲线、色阶、色相/饱和度、完整的调色面板……）、扭曲（变形、膨胀、湍流置换、CC Power Pin……）、生成（分形噪点、渐变斜坡、描边、书写、音频频谱……）、抠像、遮罩、噪点与颗粒、透视、模拟（CC Particle World、CC Rainfall、Shatter、Card Dance、Caustics、Wave World……）、风格化（辉光、CC Glass……）、时间（Echo、Posterize Time、Timewarp、时间置换……）、音频（混响、参数均衡、延迟、立体声混合……）、文字、转场、工具与表达式控制。全部九种图层样式（投影、内/外发光、斜角与浮雕、缎面、叠加、描边）均带全局光。预览可同步播放音频，并带有电平表与波形。
3D
经典的 3D 合成：带方向与材质选项的 3D 图层，带景深的一节点与两节点摄像机，灯光（平行、聚光、点光、环境光）带柔和的光线追踪阴影，图层正确相交，轨道、平移与推拉摄像机工具，以及前、顶、左与自定义视图。
导出
专用的渲染队列，带渲染设置与输出模块：H.264 MP4 与带音频的 ProRes MOV（从 Proxy 到带 Alpha 的 4444 XQ）、HEVC（Main / Main 10）与 AV1 MP4、WebM（带帧间与 Alpha 的 VP9，或 AV1；Opus 音频）、PNG、JPEG、TIFF 与 32 位 EXR 序列、动态 GIF，以及 WAV/AIFF。支持 3:2 下拉的场渲染、特效/solo/参考线/深度覆盖、裁剪、感兴趣区域与缩放、带默认值的渲染设置与输出模块模板、渲染后动作、存储溢出与渲染日志。同一队列也可从命令行运行。每个编码器都是纯 Rust（FilmCraft 的 H.264、ProRes 与 AAC；EffectCraft 自家的 VP9、AV1、HEVC 与 Opus）；内部没有任何 FFmpeg。
Lottie 双向支持：文件 ▸ 导出 ▸ Lottie JSON… 将一个合成（预合成、形状、纯色、图像、文字与空对象图层，缓动与空间关键帧、遮罩、轨道遮罩、混合模式、时间重映射，以及可选的表达式）写为 .json 或 .lottie，并列出 Lottie 无法表达的任何内容；文件 ▸ 导入 ▸ Lottie… 将其作为一个新合成打开。
为 AI 智能体而生
你能从菜单里做的每一件事，都是一个带 id 的命令，而智能体可以触达其中的每一个：
- MCP 服务器：
effectcraft-cli mcp 通过 stdio 讲模型上下文协议，可无头运行，或桥接到正在运行的应用（--bridge 9877）。工具覆盖命令、项目与属性树、关键帧以及渲染帧。本仓库已附带一份可用的 .mcp.json。
- 命令行： 带 JSON 输出的一次性调用，例如
effectcraft-cli set Main '#1' transform/position '[100,360]' --time 0 main.ecproj --save
或 effectcraft-cli render --comp Main --out main.mp4，或
effectcraft-cli exec file.exportLottie '{"comp":"Main","path":"main.json"}' main.ecproj。
- 控制通道：
effectcraft --control 9877 接受 JSON 行来运行命令、按自动化 id 检查并点击任意控件，以及截图。
详见 docs/agents.md 与 docs/control-protocol.md。
开始使用
各版本的安装程序位于 Releases 页面：通用的 macOS 应用；面向 x64、x86 与 ARM64 的 Windows MSI 与便携 zip；面向 x86_64 与 aarch64 的 Linux AppImage、Flatpak、deb、rpm 与 tar.gz，外加一份 riscv64 tar.gz；以及一份 FreeBSD x86_64 tarball；还有 Web 构建。下载 列出了每一个文件。Windows ARM64 构建在 Windows on ARM 上原生运行，无需 x64 模拟。CI 会在 Windows 11 ARM64 硬件上安装该 MSI，检查两个程序均为 ARM64，并在那里运行命令行工具，但尚不能在 ARM64 上原生打开应用窗口或运行测试套件，因此若有任何不同表现，请告诉我们。
在 Gentoo 上，社区 ::snakebyte overlay 将 Linux 发行版打包为 media-video/effectcraft-bin（非 EffectCraft 团队维护）：
eselect repository add snakebyte git https://github.com/switch87/snakebyte-overlay.git
emaint sync -r snakebyte
echo 'media-video/effectcraft-bin ~amd64' >> /etc/portage/package.accept_keywords/effectcraft
emerge --ask media-video/effectcraft-bin
要自己构建，你需要 Rust 1.95 或更新版本。
git clone https://github.com/storytold/effectcraft
cd effectcraft
cargo run --release -p effectcraft # 应用（加 `-- --demo` 打开演示项目）
cargo run --release -p effectcraft-cli -- render --out intro.mp4 # 无头渲染演示
cargo xtask web --serve 8765 # 浏览器构建，地址 http://127.0.0.1:8765/（https://github.com/storytold/effectcraft/blob/main/docs/web.md）
刚上手？docs/footage.md 介绍了导入素材与图像序列，以及“解释素材”。
要参与开发：cargo test --workspace，并在每次提交前运行 cargo xtask ci（格式化、lint、测试、分层、资产归属与 WebAssembly 构建）。参见 CONTRIBUTING.md、docs/architecture.md 与 docs/testing.md。
当前进展
EffectCraft 还很年轻：它的首个提交在 2026 年 10 月 1 日。它已具备一套全面的功能，包括 306 种特效，但“覆盖面广”不等于在每一个边界情况下都足够成熟。如今它是个尝试东西、并告诉我们哪里会出错的好地方。它尚未被推荐用于生产客户项目。具体而言：
- 原生项目格式。 项目以
.ecproj 保存，即可读的带版本 JSON。不支持专有项目格式与 After Effects SDK 插件。
- 保真度仍在打磨中。 自动化渲染测试目前只聚焦于小型合成，因此若有视觉差异或异常行为，请告诉我们。
- macOS 是测试最充分的平台。 Linux 与 Windows 用户遇到过基础交互问题，我们正在优先修复。
- 训练模型还很新。 旋转笔刷可使用 MobileSAM（设置 ▸ 旋转笔刷中的一项可选 40 MB 下载），人脸跟踪可使用 Google 的 MediaPipe Face Landmarker（设置 ▸ 人脸跟踪中的一项可选 3.8 MB 下载）。两者都还在积极评估与调优中。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
